Free News API: Cerca de text complet sobre 21 milions d'articles, 25.000 editors i 100 països — Sense cap tipus de clau

Les API de notícies solen vendre's per sol·licitud, darrere d'una clau, i limitades a cent crides al dia en el pla gratuït. Free News API no és res d'això: 21,5 milions d'articles en una finestra mòbil de 90 dies, més de 25.000 editors, sense clau, sense registre, sense quota, amb ús comercial permès. Aquí teniu tota la superfície — cerca, estadístiques, tendències, mercats, feeds i MCP — i un relat honest de què fallan les dades.

L'estructura del problema

Pregunta a un agent d'IA què s'escriu al món en aquest moment i té tres opcions dolentes. Pot fer scraping directament als editors, que és fràgil, lent i legalment ambigu. Pot cridar una API de notícies comercial, la qual cosa significa un compte, una clau, una factura mensual i — en cada pla gratuït del mercat — cent sol·licituds al dia i articles retardats vint-i-quatre hores. O pot endevinar a partir de les dades d'entrenament que es van aturar fa mesos.

Free News API elimina el preu i la burocràcia de l'opció intermèdia sense eliminar-ne la capacitat. Una sol·licitud GET, sense credencials, sobre un corpus que en el moment de l'escriptura conté 21.557.044 articles de més de vint-i-cinc mil editors, mantinguts en una finestra mòbil de noranta dies i actualitzats contínuament — l'article més nou de l'índex sol tenir menys de dos minuts.

Quatre punts d'entrada principals, i més

El nucli del servei són quatre punts d'entrada GET, tots sota https://freenewsapi.ai, que retornen dades JSON en UTF-8 amb Access-Control-Allow-Origin: * perquè el codi del navegador pugui cridar-los directament, i que indiquen el temps de servidor a took_ms.

Al voltant d'aquest nucli hi ha quatre famílies més, cadascuna de les quals seria un producte per dret propi en altres contextos: tendències (agrupació de notícies en directe per país), mercats (sèries de preus alineades amb el volum de cobertura), sentiment cripto (un bloc de Bitcoin amb set punts d'extrem) i sindicació (la mateixa cerca representada com a RSS, Atom o canal JSON). Totes elles es tracten a continuació.

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 camps d'aquesta resposta mereixen una atenció immediata, ja que codifiquen l'honestedat de tot el conjunt de dades. total_is_lower_bound t'indica quan el recompte de coincidències ha arribat al límit de 10.000 i ha deixat de comptar. country_source t'indica com s'ha determinat el país — perquè en qualsevol conjunt de dades de notícies, una gran part dels valors de país són inferències, no fets. I crawled_at és l'indicador horari de confiança: els editors solen posar data de publicació retroactiva a published_at, però l'hora d'exploració és assignada per la canalització i només avança.

Cerca: Cada paràmetre que importa

Tots els paràmetres són opcionals. Una crida bàsica retorna els articles més recents de l'índex.

La consulta

• q S'ha de fer coincidir amb el títol (pes 3), la descripció (pes 2) i el cos de l'article. Semàntica AND — cada terme ha d'estar present, de manera que afegir una paraula estreita els resultats en lloc d'obrir-los. Màxim 500 caràcters.

Els filtres

Els filtres es combinen amb AND entre paràmetres i OR dins d'un mateix. Per tant, country=DE,AT&lang=de es llegeix com a "articles en alemany d'Alemanya o Àustria". Cada un accepta una llista separada per comes de fins a cinquanta valors.

Control de la sortida

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"

Comptar abans de cercar

L'endpoint menys aprofitat del servei és /v1/stats. Sovint, la pregunta útil no és «quins són els articles», sinó «n'hi ha cap, i on són». Comptar-ho respon aquesta qüestió per una fracció del cost — aproximadament dos-cents tokens, en comparació amb diversos milers per una pàgina de resultats —, cosa que el converteix en la primera crida correcta per a un agent que decideix si val la pena executar una cerca.

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

Retorna recompte per país, idioma, TLD, editor i dia, calculats sobre el conjunt sencer de coincidències en lloc de només la pàgina actual. Això és també com mesures la cobertura abans de confiar-hi. L'instantània sense filtrar al moment de redactar-ho:

Principals països

Llengües principals

Anglès 5.513.650 · Espanyol 2.699.457 · Rus 1.785.796 · Turc 1.501.004 · Italià 992.200 · Alemany 733.677 · Francès 689.136 · Àrab 664.016 · Portuguès 637.607 · Hindi 560.840 · Grec 466.504 · Japonès 427.085 · Vietnamita 385.719 · Romanès 358.766 · Xinès 352.720 · Ucraïnès 345.809 · Coreà 335.079 · Persa 268.126 · Polonès 238.904 · Búlgar 183.204.

Aquesta distribució val la pena observar-la un moment, perquè és l'oposat del que us ofereixen la majoria de fonts de notícies API. El corpus habitual, en anglès i centrat als Estats Units, no és el que trobareu aquí: l'Índia supera els Estats Units, el turc supera l'alemany, i el grec, el vietnamita, el persa i el búlgar tenen tots ells representació de sis xifres. Si la vostra pregunta tracta sobre una premsa no anglesa, es tracta d'un conjunt de dades materialment diferent.

Volum

La corba diària a by_day cobreix tot el període de noranta dies. Els dies recents es situen en l'interval d'aproximadament 400.000 a 700.000 articles per dia; a principis del període, abans que s'afegís la capa RSS juntament amb la ingesta de l'arxiu, el volum diari era de 130.000 a 230.000. Totes dues xifres són visibles a la mateixa resposta, que és precisament el punt: el servei us mostra la seva pròpia rampa de creixement en lloc de citar una mitjana de màrqueting.

Tendències: Què cobreix realment la premsa en aquest moment

Les cerques responen a «què s'ha escrit sobre X». Les tendències responen a una pregunta diferent i sovint millor: «què està passant» — sense necessitat d'un X.

Un robot agrupa articles en històries per país i les manté actualitzades. Cada cinc minuts s'afegeixen nous articles a les històries conegudes mitjançant les seves paraules clau, sense cap crida a un model; cada poques hores, un país passa per una revisió completa on un model de llenguatge llegeix els titulars i nomena les històries des de zero. En el moment d'escriure aquestes línies, la capa de tendències cobreix 115 països, cadascun recalculat en els últims minuts.

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 història ve acompanyada de dos recomptes que tenen significats diferents. articles és la intensitat; publishers és l'amplitud. Una història amb 200 articles de 4 mitjans és l'obsessió d'una redacció. Una història amb 60 articles de 40 mitjans és un esdeveniment. L'ordenació predeterminada és per editors, i min_publishers / min_articles us permeten establir el llindar vosaltres mateixos.

Les notícies tenen una categoria d'un conjunt fix: política, negocis, mercats, tecnologia, esports, salut, ciència, cultura, criminalitat, conflicte, meteorologia, societat.

La finestra és una elecció del lector, no del robot

Aquesta és una decisió de disseny realment elegant. Cada article s'emmagatzema amb la seva hora de publicació i s'associa a la seva notícia, de manera que qualsevol finestra — quinze minuts, una hora, un dia, una data concreta del calendari — és simplement una consulta de rang sobre les mateixes dades emmagatzemades. Un sol càlcul serveix per a totes les finestres alhora. window=15m, window=1h, window=24h, date=2026-09-01 o un parell explícit since/until funcionen sobre el mateix índex sense necessitat de recalculacions.

Paraules clau: les paraules en què es basa la notícia

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

Cada paraula clau es retorna amb el nombre de notícies diferents que la contenen, el nombre d'articles que tenen aquestes notícies i — l'aspecte més interessant — quant premsa nacional la utilitza. Aquesta última xifra marca la diferència entre un esdeveniment global i un d'interès nacional. Una paraula que apareix a setanta països és una notícia mundial; una paraula que domina la premsa d'un sol país és una notícia nacional, per molt sorollós que sigui allà.

Quins països estan en directe

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

Retorna tots els països seguits amb el seu recompte de notícies en directe i quantes minuts fa que es va recalcular — Turquia, Rússia, Iran, Grècia, Índia, Itàlia, Ucraïna, Romania, Argentina, Alemanya i Brasil tenen actualment milers de notícies en directe cadascun, recalculades en els últims deu minuts. I /v1/trends/{cc}/{slug} obre qualsevol notícia individual amb la seva llista completa d'articles.

Merceats vs. Cobertura: el preu en un eix, l'atenció en l'altre

Aquesta és la cosa més inusual del servei, i existeix perquè el corpus fa que sigui gairebé gratuït construir-la. Col·loqueu una sèrie de preus al costat de quant va escriure el món sobre això en les mateixes hores, en una única línia de temps.

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

Quatorze instruments estan seguits, a través de quatre classes d'actius:

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

Aquesta única crida us proporciona el tipus de canvi de la lira davant del dòlar i el volum de la cobertura de premsa turca durant el mateix període, alineat hora per hora. La premsa turca és la tercera part més gran d'aquest corpus, i exactament per això aquesta combinació produeix alguna cosa significativa en lloc de soroll.

I un bloc complet de sentiment sobre Bitcoin

Bitcoin obté la seva pròpia família de set punts de connexió, perquè és l'instrument on constantment es discuteix la relació entre el to de les notícies i el moviment dels preus, i rarament es mesura:

Les etiquetes de sentiment provenen d'un model de llenguatge que analitza les notícies recents sobre criptomonedes cada cinc minuts, en relació amb una llista de monedes calibrada. L'endpoint /v1/btc/correlation amb el paràmetre max_shift és el que cal utilitzar si mai heu volgut provar la afirmació que «les notícies provoquen els moviments» en lloc de repetir-la.

La mateixa cerca, com a canal de notícies

Tres endpoints més prenen els mateixos paràmetres de cerca i mostren els resultats en formats de sindicació en lloc 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

Això significa que qualsevol cerca desada es converteix en un canal que podeu enganxar en un lector, un node d'n8n, una integració de Slack, un activador de Zapier o un generador de llocs estàtics — sense necessitat de codi ni de clau. És una funció menor que elimina silenciosament una capa sencera d'integració per als no programadors.

MCP: Vint-i-vuit eines, dues capes

El servidor MCP resideix en un únic URL, parla HTTP Streamable (JSON-RPC 2.0 sobre POST, versió del protocol 2025-06-18), admet lotificació i, com tota la resta d'aquest projecte, no té cap pas d'autorització ni cap identificador de sessió.

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

Exposa 28 eines en dues capes deliberades.

Capa 1: sis dreceres que responen a una pregunta sencera en una sola crida

Capa dos: cada punt final, generat directament pel servei

Per sota dels atalls, cada punt final en brut s'exposa com a eina pròpia amb tots els paràmetres que accepta el API: news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, tota la família news_get_btc_*, els renderitzadors de feeds i news_get_health. Aquests són generats a partir del servei en directe, de manera que no poden desviar-se del que accepta realment el API.

Dues eines meta tanquen el cercle: news_list_endpoints retorna el catàleg de tot el que existeix, i news_get realitza una cruda GET a qualsevol ruta — de manera que un agent que es trobi amb un punt final que la seva llista d'eines no cobreixi, encara hi pot accedir.

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

Una GET, sense apretada de mans, i tens tot el catàleg llegible per màquina: servidor, transport, protocol, nombre d'eines, cada eina amb la seva descripció i cada punt final amb la seva llista de paràmetres.

Dissenyat per ser llegit per màquines

La documentació no és un afegitó muntat a sobre del API — és una sortida de primera categoria d'aquest mateix. El lloc web inclou 665 pàgines estàtiques, i algunes d'elles existeixen específicament perquè un model no hagi de llegir HTML:

• /openapi.json L'esquema complet de l'OpenAPI.
• /llms.txt Un fitxer d'orientació breu: què és el servei, els punts d'entrada, com fer consultes de manera efectiva i els errors.
• /llms-full.txt Tota la documentació en un sol fitxer de text pla, amb més de cent kilobytes de dades, perquè un agent pugui ingerir tot el manual amb una única sol·licitud.
• /agents Trentanou pàgines dirigides específicament als creadors d'agents: definicions de funcions per a OpenAI llestes per utilitzar, definicions d'eines per a Anthropic, prompts de sistema per a la recuperació de notícies, receptes RAG, taules de costos de tokens i receptes per a agents.
• /agents/models Codi per a la crida d'eines per família de models: 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è hi ha dins del corpus, la metodologia, l'esquema de l'índex i una pàgina titulada Qualitat de les dades que documenta què fa malament el conjunt de dades.
• /sources Un catàleg navegable de 11.668 editors, filtrable per país, idioma i zona de domini.
• /compare Pàgines de comparació amb NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube i FreeNewsAPI.io.

Més de 168 pàgines de països, 121 pàgines d'idiomes i 275 pàgines de TLD: una superfície navegable per a cada fragment del corpus, que mostra què conté realment.

L'origen dels articles

Dues vies d'ingestació alimenten el mateix índex, i la diferència entre elles és rellevant.

La via d'arxiu

Cada deu minuts, una tasca comprova l'arxiu CC-NEWS de Common Crawl en busca de nous fitxers WARC i processa qualsevol element que no hagi vist mai, mitjançant quaranta treballadors en paral·lel. L'extractor extreu cada article de l'escaneig brut mitjançant una cascada documentada per a cada camp, i les cascades es van mesurar amb dades reals en lloc de ser assumides:

Aquesta xifra de país és l'honesta, i és per això que country_source s'exposa a cada article: aproximadament una cinquena part de les registres no tenen cap senyal de país fiable en absolut, i al voltant d'una tercera part dels valors que existeixen són inferències en lloc de fets. El API us indica quina és quina en lloc de fer veure que no.

La via en directe

Un segon robot consulta els fluxos RSS de l'editorial cada cinc minuts, en una rotació amb sol·licituds condicionals: un flux que respon 304 Not Modified costa gairebé res, i l'interval de consulta de cada flux s'ajusta a la freqüència amb què publica realment. Un mitjà que publica cinc històries al dia no es veu sotmès a una càrrega excessiva cada quinze minuts.

També només pren el que l'editorial ha posat al flux: títol, resum i text complet quan el flux el conté. No accedeix al lloc web de l'editorial per obtenir més contingut. Aquesta és una línia de contorn deliberada, i és la raó per la qual el servei pot fer les promeses que fa a la seva pàgina legal per a editors.

I la maquinària que els envolta

Al voltant de les dues vies d'ingestació hi ha una dotzena de robots més en horaris: descobriment i sincronització de fonts, resolució del país per domini, construcció i auditoria de tendències, reintegració de paraules clau, sentiment cripto, consultes de mercat, un catàleg de taxonomies, retenció (el període de noranta dies s'aplica mitjançant una consulta nocturna a published_at, no per l'antiguitat de l'índex), verificació del dia, reconsultes d'articles buits i un guardià de salut que reinicia qualsevol procés que hagi deixat de funcionar. El corpus es troba en un clúster d'Elasticsearch dedicat.

Què falla en aquest conjunt de dades

El servei publica les seves pròpies limitacions, que és la manera més ràpida de jutjar si s'ajusta al vostre problema.

• El país s'inferix Llegiu country_source a cada article, i afegiu strict_country=true quan compteu per país en lloc de navegar.
• published_at és proporcionat per l'editorial La datació retroactiva és habitual. Ordeneu per crawled quan consulteu per veure què és nou.
• total està limitat a 10.000 Per velocitat. total_is_lower_bound us indica quan heu arribat al límit.
• Sense extracció de sentiments ni d'entitats Fora del bloc de Bitcoin, els articles no tenen cap puntuació de sentiment ni entitats amb nom. Això no està dins de l'àmbit.
• Nouanta dies i no més No hi ha cap arxiu més profund. Si necessites el 2019, aquesta no és l'eina adequada.
• Sense SLA És gratuït. També està monitoritzat i vigilat, però no es promet res per escrit.
• El text pertany als editors Cada resposta inclou l'URL original, i se n'espera que els usuaris en enllaçin.

Ús correcte: cost, paginació i errors

Disciplina dels tokens

Per a un agent, la mida de la resposta és el cost real. L'estructura documentada:

Vint articles amb full_text=true són aproximadament 40.000 tokens. El pató recomanat és sempre el mateix: compta, escaneja i després obtén els cossos per als pocs que necessitis.

Paginació més enllà del sostre

offset s'atura al 9.900. Per recórrer un conjunt gran, no lluitis contra el sostre; fes-ho per franges temporals. Fes un bucle dia a dia, o hora a hora en una consulta amb molta activitat, amb from/to i sort=date. La documentació té una pàgina dedicada a recórrer un dia sencer.

Errors

El contracte és clar i fàcil de programar: 4xx significa que la sol·licitud és incorrecta — corregeix-la, no tornis a intentar-la. 5xx significa que el servei està caigut — redueix la freqüència. 429 significa que afluixis i tornis a intentar-ho. Els paràmetres de consulta desconeguts s'ignoren en lloc de ser rebutjats, de manera que afegir un camp mai pot trencar un client existent.

Identifica't (Opcional, i realment opcional)

Sense clau, no hi ha manera d'identificar un client. La cortesia suggerida és un capçalera que indiqui el teu agent, el marc amb el qual es connecta i el model que el 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>)

Els mateixos valors funcionen com a paràmetres de consulta plans, cosa que sol ser més fàcil:

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

Les claus desconegudes s'ignoren, de manera que és sempre segur enviar claus addicionals. No es valida res, no es limita res per ometre-ho, i l'única instrucció és ferma: no posis mai dades personals de l'usuari final en aquests camps.

Contra les notícies pagades API

Les pàgines de comparació del lloc cobrenc onze competidors individualment. Les diferències estructurals que es mantenen en tots ells:

El que els serveis de pagament encara us ofereixen i això no: puntuacions de sentiment i extracció d'entitats com a camps estàndard, arxius que remunten anys enrere i un contracte amb una SLA darrere. Aixòs són reals i, si en necessiteu, hauríeu de comprar-los.

Receptes

Un monitor de països en directe

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

Aquesta notícia és global o nacional?

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

Ancelar un model en la cobertura actual, a baix cost

# 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 lidera el preu?

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

Convertir una cerca desada en un feed

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

Troba els mitjans que importen en un mercat

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

Versió breu

Free News API és un cercador de text complet sobre 21,5 milions d'articles de notícies de més de 25.000 editors en 100 països i aproximadament 100 idiomes, en una finestra mòbil de noranta dies, actualitzat contínuament, sense clau, sense registre i sense límit de quota més enllà d'un límit de freqüència per IP. A sobre de la cerca hi ha agrupació de notícies en temps real per país en 115 països, anàlisi de paraules clau que separa els esdeveniments mundials dels domèstics, catorze instruments de mercat representats en funció del volum de cobertura, un bloc de sentiment de Bitcoin de set punts finals, RSS/Atom/JSON de sindicació de qualsevol consulta i un servidor MCP de 28 eines generat a partir del propi servei.

Documenta les seves pròpies taxes d'error, exposa com es va derivar cada valor de país i publica una pàgina sobre què és incorrecte en les dades. Per a un agent que necessita saber què diu el món —en turc, en grec, en hindi, ara mateix—, aquesta combinació és difícil de trobar a qualsevol preu, i aquesta és gratuïta.

La cerca és AND (I) entre tots els termes. Utilitza 2-5 paraules clau, no una pregunta en llenguatge natural.

Free News API, sobre com consultar-lo correctament

Comença aquí: freenewsapi.ai · MCP a freenewsapi.ai/mcp · tot el manual en un sol fitxer a /llms-full.txt.