Free News API: Fuldtekstsøgning i 21 millioner artikler, 25.000 udgivere og 100 lande — helt uden nøgle

NyhedsAPI sælges typisk pr. anmodning, er låst bag en nøgle og begrænset til hundrede opkald om dagen på den gratis version. Free News API er ikke noget af det: 21,5 millioner artikler i et rullende vindue på 90 dage, 25.000+ udgivere, ingen nøgle, ingen tilmelding, ingen kvote, kommerciel brug tilladt. Her er hele funktionsområdet — søgning, statistik, trends, markeder, feeds og MCP — samt en ærlig redegørelse for, hvor dataene kan tage fejl.

Problemets karakter

Spørg en AI-agent, hvad verden skriver om lige nu, og den har tre dårlige muligheder. Den kan scrape udgivere direkte, hvilket er skrøbeligt, langsomt og retligt uklart. Den kan kalde en kommerciel nyhedsAPI, hvilket betyder en konto, en nøgle, en månedlig regning og — på hver eneste gratis version på markedet — hundrede anmodninger om dagen og artikler, der er forsinket med 24 timer. Eller den kan gætte sig til svar ud fra træningsdata, der er flere måneder gamle.

Free News API fjerner mellemmulighedens pris og bureaukrati uden at fjerne dens kapacitet. Én GET-anmodning, ingen legitimationsoplysninger, over et korpus, der på tidspunktet for skrivningen indeholder 21.557.044 artikler fra mere end 25.000 udgivere, gemt i et rullende vindue på 90 dage og opdateret kontinuerligt — den nyeste artikel i indekset er typisk under to minutter gammel.

Fire kerneendepunkter, og så meget mere

Kernen i servicen er fire GET-endepunkter, alle under https://freenewsapi.ai, der alle returnerer UTF-8 JSON med Access-Control-Allow-Origin: *, så browserkode kan kalde dem direkte, og alle rapporterer server-side tid i took_ms.

Rundt om den kerne sidder fire flere familier, som hver for sig ville være et produkt et andet sted: trends (live-story-klyngedannelse pr. land), markets (prisrækker justeret mod dækningsvolumen), crypto sentiment (en Bitcoin-block med syv endpoints) og syndication (den samme søgning leveret som RSS, Atom eller JSON Feed). Alle disse dækkes nedenfor.

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"
    }
  ]
}

Tre felter i dette svar fortjener øjeblikkelig opmærksomhed, fordi de koder for hele datasættets ærlighed. total_is_lower_bound fortæller dig, hvornår matchantallet ramte sit loft på 10.000 og stoppede med at tælle. country_source fortæller dig, hvordan landet blev bestemt — fordi i ethvert nyhedsdatasæt er en stor del af landeværdierne inferenser, ikke fakta. Og crawled_at er det troværdige tidsstempel: udgivere bagdatere published_at rutinemæssigt, men crawl-tiden tildeles af pipeline'en og bevæger sig kun fremad.

Søgning: Alle parametre, der betyder noget

Alle parametre er valgfrie. Et enkelt kald returnerer de nyeste artikler i indekset.

Søgeordet

• q Matchet mod titel (vægt 3), beskrivelse (vægt 2) og artikelbrødteksten. AND-semantik — hvert led skal være til stede, så tilføjelse af et ord indsnærrer snarere end udvider. Maksimum 500 tegn.

Filtrene

Filtre kombineres med AND på tværs af parametre og OR inden for én. Så country=DE,AT&lang=de læses som "artikler på tysk fra Tyskland eller Østrig". Hvert felt accepterer en kommasepareret liste med op til halvtreds værdier.

Output-styring

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"

Tælling før du søger

Den mest undervurderede endpoint i tjenesten er /v1/stats. Ofte er det nyttige spørgsmål ikke "hvad er artiklerne", men "er der overhovedet noget her, og hvor er det". Tælling svarer på dette for en brøkdel af omkostningerne — cirka to hundrede tokens mod flere tusinde for en sides resultater — hvilket gør det til det rigtige første kald for en agent, der skal afgøre, om en søgning er værd at køre.

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

Den returnerer tællinger fordelt på land, sprog, TLD, udgiver og dag, beregnet over hele den matchende mængde frem for den aktuelle side. Det er også sådan, du måler dækningen, før du stoler på den. Det ufiltrerede øjebliksbillede på tidspunktet for skrivning:

Fremragende lande

Hovedsprog

Engelsk 5.513.650 · Spansk 2.699.457 · Russisk 1.785.796 · Tyrkisk 1.501.004 · Italiensk 992.200 · Tysk 733.677 · Fransk 689.136 · Arabisk 664.016 · Portugisisk 637.607 · Hindi 560.840 · Græsk 466.504 · Japansk 427.085 · Vietnamesisk 385.719 · Rumænsk 358.766 · Kinesisk 352.720 · Ukrainisk 345.809 · Koreansk 335.079 · Persisk 268.126 · Polsk 238.904 · Bulgarsk 183.204.

Den fordeling er værd at kigge nærmere på, fordi den er det modsatte af, hvad de fleste nyhedsAPI giver dig. Den sædvanlige engelsk-først, USA-først korpus er ikke det, dette er: Indien overgår USA, tyrkisk overgår tysk, og græsk, vietnamesisk, persisk og bulgarsk har alle seks-cifret repræsentation. Hvis dit spørgsmål handler om et ikke-engelsk presse, er dette et materielt anderledes dataset.

Omfang

Den daglige kurve i by_day dækker det fulde halvfjerdsdagesvindue. Nylige dage ligger i området på cirka 400.000 til 700.000 artikler om dagen; tidligere i vinduet, før RSS-laget blev tilføjet sammen med arkivoptagelsen, løb det daglige omfang på 130.000–230.000. Begge tal er synlige i det samme svar, hvilket er pointen — tjenesten viser dig sin egen optrapning frem for at citere et marketing-gennemsnit.

Tendenser: Hvad presset faktisk dækker lige nu

Søg svarer "hvad der blev skrevet om X". Tendenser svarer på et andet og ofte bedre spørgsmål: "hvad der sker" — uden at X er nødvendig.

En robot grupperer artikler i historier pr. land og opdaterer dem. Hver femte minut tilføjes nye artikler til kendte historier ved deres identificerende ord, helt uden modelkald; hver time eller to gennemgår et land en fuld gennemgang, hvor en sprogmodel læser overskrifterne og navngiver historierne fra bunden. På tidspunktet for skrivningen dækker trendlaget 115 lande, der hver især er blevet genberegnet inden for de sidste par minutter.

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": [ … ]
    }
  ]
}

To tællinger følger med hver historie, og de betyder forskellige ting. articles er højhed; publishers er bredde. En historie med 200 artikler fra 4 medier er et redaktionskontors besættelse. En historie med 60 artikler fra 40 medier er en begivenhed. Den standard sortering er efter udgivere, og min_publishers / min_articles lader dig sætte stregen selv.

Historier tildeles en kategori fra et fast sæt: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

Vinduet er læserens valg, ikke robotens

Dette er en ægte elegant designbeslutning. Hver artikel gemmes med sin publiceringstid og tilknyttes sin historie, så ethvert vindue — femten minutter, en time, en dag, en specifik kalenderdato — blot er et områdesøgning i de samme gemte data. Én beregning dækker alle vinduer på én gang. window=15m, window=1h, window=24h, date=2026-09-01 eller et eksplicit since/until-par fungerer alle mod den samme indeks uden omregning.

Nøgleord: de ord, nyhederne er bygget på

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

Hvert nøgleord returneres med oplysning om, hvor mange distinkte historier der indeholder det, hvor mange artikler disse historier består af, og — det interessante — hvor mange nationale medier der bruger det. Det sidste tal er forskellen på en global begivenhed og en indenrigssag. Et ord, der optræder i halvfjerds lande, er en verdensnyhed; et ord, der dominerer ét lands medielandskab, er en indenrigssag, uanset hvor højlydt det er der.

Hvilke lande er live

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

Returnerer alle sporede lande med deres antal live-historier og hvor mange minutter siden de blev genberegnet — Tyrkiet, Rusland, Iran, Grækenland, Indien, Italien, Ukraine, Rumænien, Argentina, Tyskland og Brasilien har alle i øjeblikket tusindvis af live-historier hver, der er genberegnet inden for de sidste ti minutter. Og /v1/trends/{cc}/{slug} åbner en enkelt historie med dens fulde artikeliste.

Markeder vs. dækning: Pris på den ene akse, opmærksomhed på den anden

Dette er det mest usædvanlige ved tjenesten, og det findes, fordi korpusset gør det næsten gratis at bygge. Placer en prisside ved siden af, hvor meget verden skrev om det pågældende emne i de samme timer, på én tidslinje.

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

Fjorten instrumenter spores på tværs af fire aktivklasser:

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

Den ene enkelt forespørgsel giver dig liren mod dollaren samt dækningsgraden fra det tyrkiske presse i samme periode, time for time. Det tyrkiske presse er den tredjestørste del af dette korpus, hvilket er præcis årsagen til, at denne kombination giver noget meningsfuldt frem for støj.

Og et komplet Bitcoin-sentimentsblok

Bitcoin får sin egen familie med syv slutpunkter, fordi det er det eneste instrument, hvor nyhedstonen og prisudviklingen konstant diskuteres, men sjældent måles:

Sentimentmærkningerne stammer fra en sprogmodel, der kører over friske kryptoartikler hvert femte minut, mod en kalibreret liste over mønter. /v1/btc/correlation med en max_shift-parameter er det, du skal bruge, hvis du nogensinde har ønsket at teste påstanden "nyhederne forårsager bevægelsen" i stedet for blot at gentage den.

Den samme søgning som en feed

Tre yderligere endpoints bruger de identiske søgeparametre og gengiver resultaterne som syndikeringsformater i stedet for 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

Det betyder, at enhver gemt søgning bliver til en feed, du kan indsætte i en læser, en n8n-node, en Slack-integration, en Zapier-trigger eller en statisk sidegenerator — uden kode og uden nøgle. Det er en lille funktion, der stille og roligt fjerner et helt integrationslag for ikke-udviklere.

MCP: 28 værktøjer, to lag

Serveren for MCP findes på ét URL, taler Streamable HTTP (JSON-RPC 2.0 over POST, protokolversion 2025-06-18), understøtter batching, og — ligesom alt andet her — har ingen godkendelsesproces og ingen session-id.

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

Den udstiller 28 værktøjer i to bevidste lag.

Lag ét: seks genveje, der besvarer et helt spørgsmål i ét kald

Lag to: hvert endpoint, genereret fra selve tjenesten

Under genvejene udstilles hvert rå endpoint som sit eget værktøj med alle parametre, som API accepterer — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, hele news_get_btc_*-familien, feed-rendererne og news_get_health. Disse genereres fra den live-tjeneste, så de kan ikke afvige fra det, API faktisk accepterer.

To meta-værktøjer lukker løkken: news_list_endpoints returnerer kataloget over alt, hvad der findes, og news_get udfører en rå GET på enhver sti — så en agent, der støder på et endpoint, som dens værktøjsliste ikke dækker, stadig kan nå det.

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

Én GET, ingen håndtryk, og du har det fulde maskinlæsbare katalog: server, transport, protokol, antal værktøjer, hvert værktøj med sin beskrivelse og hvert endpoint med sin parameterliste.

Bygget til at blive læst af maskiner

Dokumentationen er ikke en eftertanke, der er skruet på API — det er et førsteklasse output fra det. Webstedet leverer 665 statiske sider, og flere af dem findes specifikt, så en model aldrig behøver at læse HTML:

• /openapi.json Det fulde OpenAPI-schema.
• /llms.txt En kort orienteringsfil — hvad tjenesten er, slutpunkterne, hvordan man stiller forespørgsler korrekt, og fejlmeddelelserne.
• /llms-full.txt Den fulde dokumentation som én ren tekstfil, der er over hundrede kilobytes stor, så en agent kan indlæse hele manualen i ét enkelt opslag.
• /agents Niogtredive sider målrettet udviklere af agenter: færdige OpenAI-funktionsdefinitioner, Anthropic-værktøjsdefinitioner, systemprompter til nyhedsindsamling, RAG-opskrifter, tabeller over tokenomkostninger og opskrifter til agenter.
• /agents/models Kode til værktøjskald pr. modellfamilie — 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 Hvad der findes i korpusset, metodikken, indexeskemaet og en side med titlen Datakvalitet, der dokumenterer, hvor datasættet tager fejl.
• /sources Et gennemgængeligt katalog over 11.668 udgivere, der kan filtreres efter land, sprog og domæneendelse.
• /compare Sider, der sammenligner med NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube og FreeNewsAPI.io.

Derudover 168 landesider, 121 sprog-sider og 275 TLD-sider — én gennemgribelig flade for hvert lag i korpusset, der viser, hvad der reelt er indeholdt i det.

Hvor artiklerne stammer fra

To indlæsningsveje foder den samme indeks, og forskellen mellem dem er afgørende.

Arkivvejen

Hvert tiende minut tjekker en opgave Common Crawl's CC-NEWS-arkiv for nye WARC-filer og behandler alt, den ikke har set før, ved hjælp af fyrre parallelle arbejdere. Ekstraktoren trækker hver artikel ud af den rå crawl ved hjælp af en dokumenteret kaskade pr. felt — og kaskaderne er målt mod reelle data frem for antaget:

Landetallet er den ærlige del af billedet, og det er grunden til, at country_source eksponeres på hver artikel: cirka en femtedel af posterne har overhovedet ingen pålidelig landesignal, og omkring en tredjedel af de værdier, der findes, er inferenceer snarere end fakta. API fortæller dig, hvilken der er hvilken, i stedet for at foregive det.

Den live-sti

En anden robot poller udgiverens RSS-feeds hvert femte minut i en rotation med betingede anmodninger — et feed, der svarer med 304 Not Modified, koster næsten ingenting, og hvert feeds polleringsinterval er tilpasset, hvor ofte det faktisk publicerer. En udgivelse, der poster fem historier om dagen, bliver ikke hamret hver femtende minut.

Den tager også kun det, som udgiveren har sat i feedet: titel, indledning og fuld tekst, når feedet indeholder det. Den går ikke ind på udgiverens hjemmeside for at hente mere. Det er en bevidst grænse, og det er årsagen til, at tjenesten kan give de løfter, den giver på sin juridiske side over for udgivere.

Og maskineriet omkring dem

Rundt om de to ingest-stier sidder et dusin flere robotter på skemaer: opdagelse og synkronisering af kilder, landeopløsning per domæne, trendopbygning og revision, keyword-backfill, kryptostemning, markedsudtræk, et taksonomikatalog, retention (vinduet på 90 dage håndhæves af en natlig forespørgsel på published_at, ikke ved alder på index), dagverifikation, tjek af tomme artikler og en health-guard, der genstarter alt, hvad der er stoppet. Korpusset lever på et dedikeret Elasticsearch-cluster.

Hvad dette dataset har forkert

Tjenesten publicerer sine egne begrænsninger, hvilket er den hurtigste måde at vurdere, om den passer til dit problem.

• Land er inference Læs country_source på hver artikel, og tilføj strict_country=true, når du tæller efter land i stedet for at browse.
• published_at er udgiverleveret Baguddatering er almindeligt. Sortér efter crawled, når du poller for, hvad der er nyt.
• total er begrænset til 10.000 For hastighed. total_is_lower_bound fortæller dig, hvornår du rammer loftet.
• Ingen sentiment- eller entitetsudtrækning Uden for Bitcoin-blocken bærer artiklerne ingen sentiment-score og ingen navngivne enheder. Det er ikke inden for omfanget.
• Nitti dage og ikke mere Der findes ingen dybere arkiv. Hvis du har brug for 2019, er dette det forkerte værktøj.
• Ingen SLA Det er gratis. Det overvåges og beskyttes dog, men der gives ingen skriftlige garantier.
• Teksten tilhører udgiverne Hvert svar indeholder den originale URL, og brugere forventes at linke tilbage til den.

Sådan bruger du det optimalt: Omkostninger, paging og fejl

Token-disciplin

For en agent er svarstørrelsen den egentlige omkostning. Den dokumenterede struktur herfor:

Tyve artikler med full_text=true er cirka 40.000 tokens. Det anbefalede mønster er altid det samme: tæl, scan, og hent derefter indholdet for de få, du har brug for.

Navigering forbi loftet

offset stopper ved 9.900. For at gennemgå en stor mængde data, skal du ikke kæmpe mod loftet — del i stedet dataene efter tid. Kør en løkke dag for dag, eller time for time ved en travl forespørgsel, med from/to og sort=date. Dokumentationen har en dedikeret side om at gennemgå en hel dag.

Fejl

Kontrakten er ret linjet og let at programmere imod: 4xx betyder, at forespørgslen er forkert — ret den, og prøv ikke igen. 5xx betyder, at tjenesten er nede — træk dig tilbage. 429 betyder, at du skal sænke farten og prøve igen. Ukendte forespørgselsparametre ignoreres frem for at blive afvist, så tilføjelse af et felt kan aldrig ødelægge en eksisterende klient.

Identificer dig selv (Valgfrit, og ægte valgfrit)

Uden en nøgle er der ingen måde at nå en klient på. Den foreslåne høflighed er en header, der angiver dit agentprogram, det framework, det kører igennem, og modellen, der driver det:

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>)

De samme værdier fungerer som almindelige forespørgselsparametre, hvilket normalt er lettere:

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

Ukendte nøgler ignoreres, så ekstra nøgler er altid sikre at sende. Intet valideres, og der er ingen throttling for at udelade det, og den ene instruktion er fast: sæt aldrig persondata fra slutbrugere i disse felter.

Mod de betalte nyheder APIs

Sammenligningssiderne på webstedet dækker elleve konkurrenter individuelt. De strukturelle forskelle, der overlever dem alle:

Det, som de betalte tjenester stadig leverer, og som dette ikke gør: stemningsanalyser og entitetsudtræk som standardfelter, arkiver, der går tilbage i flere år, og en kontrakt med en SLA bagved. Det er reelle fordele, og hvis du har brug for dem, bør du købe dem.

Opskrifter

En live-landmonitor

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

Er denne historie global eller indenlandsk?

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

Forankr en model i dagens dækning, billigt

# 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"

Fører dækningen prisen?

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

Omdan en gemt søgning til en feed

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

Find de medievirksomheder, der betyder noget på markedet

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

Den korte version

Free News API er en fuldtekstsøgning over 21,5 millioner nyhedsartikler fra mere end 25.000 udgivere i 100 lande og cirka 100 sprog, med et løbende vindue på 90 dage, der opdateres kontinuerligt, uden nøgle, uden tilmelding og uden kvote bortset fra en ratebegrænsning per IP. Oven på søgningen findes live clustering af historier per land på tværs af 115 lande, nøgleordsanalyse, der adskiller verdensbegivenheder fra indenrigspolitik, fjorten markedsinstrumenter plotet mod dækningsvolumen, en blokke med Bitcoin-sentiment med syv endepunkter, RSS/Atom/JSON-syndikering af enhver forespørgsel og en 28-værktøjs MCP-server genereret fra selve tjenesten.

Det dokumenterer sine egne fejlprocenter, afslører, hvordan hver landeværdi er udledt, og publicerer en side om, hvad dataene gør forkert. For en agent, der har brug for at vide, hvad verden siger — på tyrkisk, på græsk, på hindi, lige nu — er denne kombination svær at finde til nogen pris, og denne er gratis.

Søgningen er AND på tværs af alle termer. Brug 2–5 nøgleord, ikke et naturligt sprogspørgsmål.

Free News API, om hvordan du query'r det godt

Start her: freenewsapi.ai · MCP på freenewsapi.ai/mcp · hele manualen som én fil på /llms-full.txt.