Free News API: Búsqueda de texto completo sobre 21 millones de artículos, 25.000 editores y 100 países — sin ninguna clave

Las APIs de noticias suelen venderse por solicitud, estar protegidas por una clave y limitarse a cien llamadas diarias en la capa gratuita. Free News API no es ninguna de esas cosas: 21,5 millones de artículos en una ventana móvil de 90 días, más de 25.000 editores, sin clave, sin registro, sin cupo y con uso comercial permitido. Aquí tienes toda la superficie — búsqueda, estadísticas, tendencias, mercados, feeds y MCP — y un relato honesto de dónde fallan los datos.

La forma del problema

Si preguntas a un agente de IA qué se está escribiendo en el mundo en este momento, tiene tres malas opciones. Puede extraer datos directamente de los editores, lo cual es frágil, lento y jurídicamente ambiguo. Puede llamar a una API de noticias comercial, lo que implica una cuenta, una clave, una factura mensual y — en cada capa gratuita del mercado — cien solicitudes al día y artículos con retraso de veinticuatro horas. O puede adivinar a partir de datos de entrenamiento que dejaron de actualizarse hace meses.

Free News API elimina el precio y el papeleo de la segunda opción sin quitarle su capacidad. Una única solicitud GET, sin credenciales, sobre un corpus que, en el momento de escribir estas líneas, contiene 21.557.044 artículos de más de veinticinco mil editores, mantenidos en una ventana móvil de noventa días y actualizados continuamente — el artículo más reciente del índice suele tener menos de dos minutos de antigüedad.

Cuatro puntos de conexión principales, y más

El núcleo del servicio consta de cuatro puntos de conexión GET, todos bajo https://freenewsapi.ai, que devuelven datos JSON en formato UTF-8 con Access-Control-Allow-Origin: * para que el código del navegador pueda llamarlos directamente, y que informan del tiempo de ejecución del servidor en took_ms.

Alrededor de ese núcleo se sitúan cuatro familias más, cada una de las cuales sería un producto por sí misma en otro lugar: tendencias (agrupación de historias en vivo por país), mercados (series de precios alineadas contra el volumen de cobertura), sentimiento de criptomonedas (un bloque de Bitcoin de siete puntos finales) y sindicación (la misma búsqueda renderizada como RSS, Atom o JSON Feed). Todas ellas se cubren a continuación.

curl "https://freenewsapi.ai/v1/search?q=climate+summit&size=2"

{
  "took_ms": 41,
  "total": 1284,
  "total_is_lower_bound": false,
  "size": 2,
  "offset": 0,
  "results": [
    {
      "id": "9c1f8a4b2d3e5f6071829304a5b6c7d8",
      "url": "https://example-news.com/world/climate-summit-opens",
      "title": "Climate summit opens with a call for binding targets",
      "description": "Delegates from 190 countries gathered on Monday ...",
      "published_at": "2026-08-17T09:12:00Z",
      "crawled_at": "2026-08-17T10:48:31Z",
      "host": "example-news.com",
      "sitename": "Example News",
      "country": "GB",
      "country_source": "cctld",
      "lang": "en",
      "tld": "com"
    }
  ]
}

Tres campos en esa respuesta merecen atención inmediata, porque codifican la honestidad de todo el conjunto de datos. total_is_lower_bound te indica cuándo el recuento de coincidencias alcanzó su techo de 10.000 y dejó de contar. country_source te dice cómo se determinó el país, porque en cualquier conjunto de datos de noticias, una gran parte de los valores de país son inferencias, no hechos. Y crawled_at es la marca de tiempo confiable: los editores suelen posponer la fecha de published_at, pero el tiempo de rastreo es asignado por la tubería y solo avanza.

Búsqueda: Cada parámetro que importa

Todos los parámetros son opcionales. Una llamada sin parámetros devuelve los artículos más nuevos del índice.

La consulta

• q Emparejado contra el título (peso 3), la descripción (peso 2) y el cuerpo del artículo. Semántica AND — cada término debe estar presente, por lo que añadir una palabra estrecha en lugar de ampliar. Máximo 500 caracteres.

Los filtros

Los filtros se combinan con AND entre parámetros y OR dentro de uno. Así que country=DE,AT&lang=de se lee como "artículos en idioma alemán de Alemania o Austria". Cada uno acepta una lista separada por comas de hasta cincuenta valores.

Control de salida

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=date&size=10"

curl "https://freenewsapi.ai/v1/search?q=merger&country=DE&date=48h&sort=date&size=20"

Conteo antes de buscar

El endpoint menos utilizado del servicio es /v1/stats. A menudo, la pregunta útil no es «cuáles son los artículos», sino «hay algo aquí o no, y dónde está». Contar los resultados responde a eso por una fracción del coste: aproximadamente doscientos tokens frente a varios miles para una página de resultados, lo que lo convierte en la primera llamada correcta para que un agente decida si merece la pena ejecutar una búsqueda.

curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"

Devuelve recuentos por país, idioma, TLD, editor y día, calculados sobre todo el conjunto de coincidencias en lugar de solo la página actual. Esta es también la forma en que mides la cobertura antes de confiar en ella. La instantánea sin filtrar al momento de escribir esto:

Principales países

Idiomas principales

Inglés 5.513.650 · Español 2.699.457 · Ruso 1.785.796 · Turco 1.501.004 · Italiano 992.200 · Alemán 733.677 · Francés 689.136 · Árabe 664.016 · Portugués 637.607 · Hindi 560.840 · Griego 466.504 · Japonés 427.085 · Vietnamita 385.719 · Rumano 358.766 · Chino 352.720 · Ucraniano 345.809 · Coreano 335.079 · Persa 268.126 · Polaco 238.904 · Búlgaro 183.204.

Esta distribución merece que te detengas un momento, porque es lo opuesto a lo que la mayoría de los API de noticias te ofrecen. El corpus habitual, centrado en el inglés y en Estados Unidos, no es lo que hay aquí: India supera a Estados Unidos, el turco supera al alemán, y el griego, el vietnamita, el persa y el búlgaro tienen todos una representación de seis cifras. Si tu pregunta se refiere a una prensa no inglesa, este es un conjunto de datos materialmente diferente.

Volumen

La curva diaria en by_day cubre la ventana completa de noventa días. Los días recientes se sitúan en el rango de aproximadamente 400.000 a 700.000 artículos por día; más atrás en la ventana, antes de que se añadiera la capa RSS junto con la ingestión del archivo, el volumen diario rondaba los 130.000-230.000. Ambas cifras son visibles en la misma respuesta, que es el punto: el servicio te muestra su propio crecimiento en lugar de citar un promedio de marketing.

Tendencias: lo que la prensa está cubriendo realmente ahora mismo

Search responde a «qué se escribió sobre X». Trends responde a una pregunta diferente y a menudo mejor: «qué está pasando», sin necesidad de una X.

Un robot agrupa artículos en historias por país y las mantiene actualizadas. Cada cinco minutos se adjuntan nuevos artículos a historias conocidas mediante sus palabras identificativas, sin ninguna llamada a un modelo; cada pocas horas un país pasa por un recorrido completo donde un modelo de lenguaje lee los titulares y nombra las historias desde cero. En el momento de escribir estas líneas, la capa de tendencias cubre 115 países, cada uno recalculado en los últimos minutos.

curl "https://freenewsapi.ai/v1/trends?country=US&window=24h&size=5"

{
  "window": "24h",
  "filters": { "country": ["US"], "min_publishers": 1 },
  "trends": [
    {
      "title": "Hurricane Marie threatens Labor Day weather",
      "slug": "hurricane-marie-threatens-labor-day-weather",
      "country": "US",
      "category": "weather",
      "articles": 57,
      "publishers": 24,
      "first_seen": "2026-09-05T19:24:36Z",
      "latest": "2026-09-06T19:00:04Z",
      "url": "https://freenewsapi.ai/trends/us/hurricane-marie-…",
      "headlines": [ … ]
    }
  ]
}

Cada historia viene con dos recuentos y significan cosas distintas. articles es el volumen; publishers es la amplitud. Una historia con 200 artículos de 4 medios es la obsesión de una redacción. Una historia con 60 artículos de 40 medios es un evento. La ordenación predeterminada es por publishers, y min_publishers / min_articles te permiten establecer tú mismo la barra.

Las historias incluyen una categoría de un conjunto fijo: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

La ventana es una elección del lector, no del robot

Se trata de una decisión de diseño genuinamente elegante. Cada artículo se almacena junto con su hora de publicación y se asocia a su historia, por lo que cualquier ventana —quince minutos, una hora, un día, una fecha concreta del calendario— es simplemente una consulta de rango sobre los mismos datos almacenados. Un único cálculo sirve para todas las ventanas simultáneamente. window=15m, window=1h, window=24h, date=2026-09-01, o un par explícito since/until funcionan contra el mismo índice sin necesidad de recalcular nada.

Palabras clave: las palabras en las que se construye la noticia

curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"

Cada palabra clave se devuelve junto con el número de historias distintas que la incluyen, el número de artículos que contienen esas historias y, lo más interesante, cuántas publicaciones nacionales la utilizan. Esa última cifra marca la diferencia entre un evento global y uno doméstico. Una palabra que aparece en setenta países es una historia mundial; una palabra que domina la prensa de un solo país es una historia doméstica, por mucho ruido que haga allí.

Países en directo

curl "https://freenewsapi.ai/v1/trends/countries"

Devuelve todos los países rastreados con su conteo de historias en directo y cuántos minutos hace que se volvió a calcular: Turquía, Rusia, Irán, Grecia, India, Italia, Ucrania, Rumanía, Argentina, Alemania y Brasil tienen actualmente miles de historias en directo cada uno, recalculadas en los últimos diez minutos. Además, /v1/trends/{cc}/{slug} abre cualquier historia individual con su lista completa de artículos.

Mercados frente a cobertura: precio en un eje, atención en el otro

Esta es la característica más inusual del servicio, y existe porque el corpus hace que su desarrollo sea casi gratuito. Coloca una serie de precios junto a la cantidad de información que el mundo escribió sobre ese tema en las mismas horas, en una única línea de tiempo.

curl "https://freenewsapi.ai/v1/markets"

Se rastrean catorce instrumentos, en cuatro clases de activos:

curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

Esa única llamada te proporciona el tipo de cambio de la lira frente al dólar y el volumen de cobertura de la prensa turca en el mismo período, alineado hora por hora. La prensa turca constituye el tercer segmento más grande de este corpus, lo cual es precisamente la razón por la que esa combinación produce resultados significativos en lugar de ruido.

Y un bloque completo de sentimiento sobre Bitcoin

Bitcoin cuenta con su propia familia de siete puntos finales, ya que es el único instrumento en el que se debate constantemente sobre la relación entre el tono de las noticias y los movimientos de precio, pero rara vez se mide:

Las etiquetas de sentimiento provienen de un modelo de lenguaje que analiza artículos recientes de criptomonedas cada cinco minutos, en comparación con una lista de monedas calibrada. /v1/btc/correlation con un parámetro max_shift es el punto al que acudir si alguna vez has querido probar la afirmación de «las noticias provocan el movimiento» en lugar de limitarte a repetirla.

La misma búsqueda, como feed

Tres endpoints más toman los mismos parámetros de búsqueda y presentan los resultados en formatos de sindicación en lugar de JSON:

• GET /v1/rss — RSS 2.0
• GET /v1/atom — Atom 1.0
• GET /v1/feed.json — JSON Feed 1.1

https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=date

Lo que significa que cualquier búsqueda guardada se convierte en un feed que puedes pegar en un lector, un nodo de n8n, una integración de Slack, un desencadenador de Zapier o un generador de sitios estáticos: sin código y sin clave. Es una función pequeña que elimina silenciosamente toda una capa de integración para los no programadores.

MCP: Veintiocho herramientas, dos capas

El servidor MCP reside en una única URL, utiliza HTTP transmisible (JSON-RPC 2.0 sobre POST, versión del protocolo 2025-06-18), admite agrupación y, al igual que todo lo demás aquí, no tiene paso de autorización ni identificador de sesión.

claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcp

Expone 28 herramientas en dos capas deliberadas.

Capa uno: seis atajos que responden a una pregunta completa en una sola llamada

Capa dos: cada punto final, generado directamente por el propio servicio

Bajo los atajos, cada punto final en bruto se expone como una herramienta independiente con todos los parámetros que acepta API: news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, toda la familia news_get_btc_*, los renderizadores de feeds y news_get_health. Estos se generan a partir del servicio en vivo, por lo que no pueden desviarse de lo que API acepta realmente.

Dos herramientas metacerradas completan el ciclo: news_list_endpoints devuelve el catálogo de todo lo que existe, y news_get realiza una consulta en bruto GET sobre cualquier ruta; así, un agente que encuentre un punto final no cubierto por su lista de herramientas aún puede acceder a él.

curl "https://freenewsapi.ai/mcp?format=json"

Una única GET, sin negociación previa, y tienes el catálogo completo legible por máquinas: servidor, transporte, protocolo, cantidad de herramientas, cada herramienta con su descripción y cada punto final con su lista de parámetros.

Diseñado para ser leído por máquinas

La documentación no es un añadido añadido a la fuerza sobre API, sino una salida de primera clase del mismo. El sitio incluye 665 páginas estáticas, y varias de ellas existen específicamente para que un modelo nunca tenga que leer HTML:

• /openapi.json El esquema completo de OpenAPI.
• /llms.txt Un archivo de orientación breve: qué es el servicio, los puntos de conexión, cómo realizar consultas de forma efectiva y los errores.
• /llms-full.txt Toda la documentación en un único archivo de texto plano, con más de cien kilobytes de extensión, para que un agente pueda ingerir el manual completo en una sola descarga.
• /agents Treinta y nueve páginas dirigidas específicamente a los creadores de agentes: definiciones de funciones listas para usar de OpenAI, definiciones de uso de herramientas de Anthropic, prompts del sistema para la recuperación de noticias, recetas de RAG, tablas de costos de tokens y recetas para agentes.
• /agents/models Código para la llamada de herramientas por familia de modelos: Qwen, DeepSeek, MiniMax, Kimi, GLM, Doubao, Hunyuan, ERNIE, Yi, Step, GPT, Claude, Gemini, Grok, Mistral, Llama, Command, Nova, Phi, Jamba, Sonar, OpenRouter, Ollama, vLLM.
• /data Qué contiene el corpus, la metodología, el esquema del índice y una página titulada Calidad de los datos que documenta los errores del conjunto de datos.
• /sources Un catálogo navegable de 11.668 editores, filtrable por país, idioma y zona de dominio.
• /compare Páginas comparativas frente a NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube y FreeNewsAPI.io.

Además de 168 páginas por país, 121 páginas por idioma y 275 páginas por TLD: una superficie navegable por cada segmento del corpus, que muestra exactamente qué contiene cada uno.

Origen de los artículos

Dos vías de ingestión alimentan el mismo índice, y la diferencia entre ellas es importante.

La vía del archivo

Cada diez minutos, un proceso verifica la colección CC-NEWS de Common Crawl en busca de nuevos archivos WARC y procesa todo lo que no haya visto previamente, utilizando cuarenta trabajadores en paralelo. El extractor extrae cada artículo del rastreo en bruto mediante una cascada documentada por campo, y las cascadas se midieron frente a datos reales en lugar de asumirse:

La cifra por país es la más honesta, y por eso country_source se expone en cada artículo: aproximadamente una quinta parte de los registros no tiene ninguna señal fiable de país, y cerca de un tercio de los valores que existen son inferencias y no hechos. API te indica cuál es cuál en lugar de fingir lo contrario.

La vía en directo

Un segundo robot consulta los feeds de editores de RSS cada cinco minutos, en una rotación con peticiones condicionales: un feed que responde con 304 Not Modified tiene un coste casi nulo, y el intervalo de sondeo de cada feed se ajusta a la frecuencia real de publicación. Un medio que publica cinco artículos al día no se somete a sondeos cada quince minutos.

También solo toma lo que el editor ha incluido en el feed: título, resumen y texto completo cuando el feed lo contiene. No accede al sitio web del editor para obtener más contenido. Esta es una delimitación deliberada, y es la razón por la que el servicio puede cumplir las promesas que hace en su página legal orientada a editores.

Y la maquinaria que los rodea

Alrededor de las dos vías de ingestión hay una docena de robots más con horarios establecidos: descubrimiento y sincronización de fuentes, resolución de país por dominio, construcción y auditoría de tendencias, relleno de palabras clave, sentimiento de criptomonedas, extracción de datos de mercado, un catálogo de taxonomías, retención (la ventana de noventa días se aplica mediante una consulta nocturna sobre published_at, no por la antigüedad del índice), verificación diaria, reconsultas de artículos vacíos y un guardián de salud que reinicia cualquier proceso que se haya detenido. El corpus reside en un clúster de Elasticsearch dedicado.

Lo que falla en este conjunto de datos

El servicio publica sus propias limitaciones, que es la forma más rápida de juzgar si se adapta a tu problema.

• El país es inferido Lee country_source en cada artículo y añade strict_country=true cuando cuentes por país en lugar de navegar.
• published_at es proporcionado por el editor La fecha de publicación retroactiva es común. Ordena por crawled cuando consultes para ver lo nuevo.
• total está limitado a 10.000 Por velocidad. total_is_lower_bound te indica cuándo has alcanzado el límite.
• Sin extracción de sentimiento ni de entidades Fuera del bloque de Bitcoin, los artículos no incluyen puntuación de sentimiento ni entidades con nombre. Eso no está dentro del alcance.
• Noventa días, nada más No hay un archivo más profundo. Si necesitas 2019, esta no es la herramienta adecuada.
• Sin SLA Es gratuito. También está supervisado y protegido, pero nada está prometido por escrito.
• El texto pertenece a los editores Cada respuesta incluye el URL original, y se espera que los usuarios enlacen de vuelta a él.

Uso correcto: coste, paginación y errores

Disciplina de tokens

Para un agente, el tamaño de la respuesta es el coste real. La forma documentada de este:

Veinte artículos con full_text=true son aproximadamente 40.000 tokens. El patrón recomendado es siempre el mismo: cuenta, escanea y luego obtén los cuerpos de los pocos que necesites.

Navegar más allá del límite

offset se detiene en 9.900. Para recorrer un conjunto grande, no luches contra el límite; divídelo por tiempo en su lugar. Recorre día a día, o hora a hora en una consulta concurrida, con from/to y sort=date. La documentación tiene una página dedicada para recorrer un día completo.

Errores

El contrato es claro y fácil de implementar: 4xx significa que la solicitud es incorrecta: corrígela, no reintentes. 5xx significa que el servicio está caído: reduce la velocidad. 429 significa que reduzcas la velocidad y reintentes. Los parámetros de consulta desconocidos se ignoran en lugar de rechazarse, por lo que añadir un campo nunca romperá a un cliente existente.

Identifícate (Opcional, y genuinamente opcional)

Sin clave, no hay forma de identificar al cliente. La cortesía sugerida es un encabezado que nombre tu agente, el framework por el que se ejecuta y el modelo que lo impulsa:

X-Agent: agent_name=<agent>; software=<langchain|llamaindex|n8n|claude-desktop|cursor|openai-assistants|crewai|custom>; model=<model>; version=<v>; purpose=<rag|monitoring|research|digest>; contact=<url or mailto>
User-Agent: <agent>/<version> (+<contact url>)

Los mismos valores funcionan como parámetros de consulta simples, lo cual suele ser más fácil:

https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4o

Las claves desconocidas se ignoran, por lo que enviar claves adicionales es siempre seguro. No se valida nada, no se limita la velocidad por omitirlo, y la única instrucción es firme: nunca pongas datos personales del usuario final en estos campos.

Contra las noticias pagadas de API

Las páginas de comparación del sitio cubren a once competidores individualmente. Las diferencias estructurales que sobreviven a todas ellas:

Lo que los servicios de pago aún te ofrecen y esto no: puntuaciones de sentimiento y extracción de entidades como campos estándar, archivos que se remontan a años atrás y un contrato con una SLA detrás. Esos son reales, y si los necesitas, deberías comprarlos.

Recetas

Un monitor de países en vivo

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"

¿Es esta noticia global o doméstica?

curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world event

Anclar un modelo a la cobertura actual de forma económica

# 1. count first
curl "https://freenewsapi.ai/v1/stats?q=semiconductor+export+controls&date=7d"
# 2. scan metadata
curl "https://freenewsapi.ai/v1/search?q=semiconductor+export+controls&date=7d&lang=en&size=20&sort=relevance"
# 3. fetch bodies for the three you picked
curl "https://freenewsapi.ai/v1/article?url=<exact-url>&full_text=true"

¿La cobertura determina el precio?

curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"

Convertir una búsqueda guardada en un feed

https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50

Encuentra los medios que importan en un mercado

curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that slice

Versión corta

Free News API es un motor de búsqueda de texto completo sobre 21,5 millones de artículos de noticias de más de 25.000 editores en 100 países y aproximadamente 100 idiomas, con un margen de tiempo continuo de noventa días, actualizado constantemente, sin clave de API, sin registro y sin cupo más allá de un límite de velocidad por dirección IP. Además de la búsqueda, ofrece agrupación en vivo de historias por país en 115 países, análisis de palabras clave que separa los eventos mundiales de los nacionales, catorce instrumentos de mercado representados frente al volumen de cobertura, un bloque de sentimiento de Bitcoin de siete puntos finales, sindicación RSS/Atom/JSON para cualquier consulta y un servidor MCP de 28 herramientas generado a partir del propio servicio.

Documenta sus propias tasas de error, expone cómo se derivó cada valor por país y publica una página sobre los errores de los datos. Para un agente que necesita saber qué está diciendo el mundo —en turco, en griego, en hindi, en este mismo momento—, esa combinación es difícil de encontrar a cualquier precio, y esta es gratuita.

La búsqueda es AND (Y) entre todos los términos. Usa 2–5 palabras clave, no una pregunta en lenguaje natural.

Free News API, sobre cómo consultarla correctamente

Empieza aquí: freenewsapi.ai · MCP en freenewsapi.ai/mcp · todo el manual en un solo archivo en /llms-full.txt.