Free News API: Fulltekstsøking over 21 millioner artikler, 25 000 utgivere og 100 land — uten noen nøkkel i det hele tatt

NyhetsAPI selges vanligvis per forespørsel, er gjemt bak en nøkkel og begrenset til hundre kall per dag på gratisnivået. Free News API er ingen av disse tingene: 21,5 millioner artikler i et rullende 90-dagers vindu, 25 000+ utgivere, ingen nøkkel, ingen påmelding, ingen kvoter, kommersiell bruk tillatt. Her er hele grensesnittet — søk, statistikk, trender, markeder, kanaler og MCP — samt en ærlig gjennomgang av hva dataene gjør feil.

Problemetets form

Spør en AI-agent hva verden skriver om akkurat nå, og den har tre dårlige alternativer. Den kan skrape utgivere direkte, noe som er skjørt, sakte og rettslig uklart. Den kan kalle på en kommersiell nyhetsAPI, som betyr en konto, en nøkkel, en månedlig regning og — på hvert gratisnivå på markedet — hundre forespørsler per dag og artikler som er forsinket i tjuefire timer. Eller den kan gjette fra treningsdata som stoppet for måneder siden.

Free News API fjerner det mellomste alternativets pris og papirarbeid uten å fjerne dets evne. Én GET-forespørsel, ingen autentiseringsopplysninger, over et korpus som ved skrivetidspunktet inneholder 21 557 044 artikler fra mer enn tjuefem tusen utgivere, holdt i et rullende nittidagers vindu og oppdatert kontinuerlig — den nyeste artikkelen i indeksen er vanligvis under to minutter gammel.

Fire kjernepunkt, og litt til

Kjernen i tjenesten er fire GET-endepunkter, alle under https://freenewsapi.ai, alle som returnerer UTF-8 JSON med Access-Control-Allow-Origin: * slik at nettleserkode kan kalle dem direkte, og alle som rapporterer server-side tid i took_ms.

Rundt dette kjernen ligger fire flere familier, som hver for seg ville vært et eget produkt andre steder: trender (live emnegruppering per land), markeder (prisseires justert mot dekningsvolum), kryptostemning (en Bitcoin-blokk med sju endepunkter), og syndikering (den samme søkningen gjengitt som RSS, Atom eller JSON Feed). Alle disse behandles 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 felt i dette svaret fortjener umiddelbar oppmerksomhet, fordi de koder ærligheten til hele datasettet. total_is_lower_bound forteller deg når treffantallet traff taket på 10 000 og sluttet å telle. country_source forteller deg hvordan landet ble bestemt — fordi i et hvilket som helst nyhetsdatasett er en stor andel av landverdiene inferanser, ikke fakta. Og crawled_at er det pålitelige tidsstempelet: utgivere forfalsker published_at rutinemessig, men krypningstiden tildeles av pipeline-en og beveger seg bare fremover.

Søk: Hver parameter som betyr noe

Alle parametre er valgfrie. Et barekall returnerer de nyeste artiklene i indeksen.

Forespørselen

• q Matchet mot tittel (vekt 3), beskrivelse (vekt 2) og artikkelbrødteksten. AND-semantikk — hvert ledd må være til stede, så å legge til et ord innskrenker snarere enn å utvide. Maksimum 500 tegn.

Filterne

Filterne kombineres med AND på tvers av parametre og OR innenfor ett. Så country=DE,AT&lang=de leses som «artikler på tysk fra Tyskland eller Østerrike». Hvert av dem aksepterer en komma-separert liste med opptil femti verdier.

Utdatakontroll

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"

Telling før du søker

Den mest undereksploaterte endepunktet i tjenesten er /v1/stats. Det nyttige spørsmålet er ofte ikke «hva er artiklene», men «finnes det noe her i det hele tatt, og hvor er det?». telling svar koster en brøkdel av prisen — omtrent to hundre tokens mot flere tusen for en sides resultater — noe som gjør det til det rette første kall for en agent som avgjør om en søking er verdt å kjøre.

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

Det returnerer tellinger fordelt på land, språk, TLD, utgiver og dag, beregnet over hele matchende sett i stedet for den nåværende siden. Dette er også hvordan du måler dekningen før du stoler på den. Ufiltrert øyeblikksbilde ved skrivetidspunktet:

Toppeland

Hovedspråk

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 · gresk 466 504 · japansk 427 085 · vietnamesisk 385 719 · rumensk 358 766 · kinesisk 352 720 · ukrainsk 345 809 · koreansk 335 079 · persisk 268 126 · polsk 238 904 · bulgarsk 183 204.

Denne fordeling fortjener et øyeblikks oppmerksomhet, fordi den er det motsatte av det de fleste nyhetsAPIer gir deg. Det vanlige engelsk-først, USA-først-korpuset er ikke det dette er: India rangeres høyere enn USA, tyrkisk rangeres høyere enn tysk, og gresk, vietnamesisk, persisk og bulgarsk har alle seks-sifret representasjon. Hvis spørsmålet ditt handler om et ikke-engelsk pressekorpus, er dette et materielt annerledes datasett.

Volum

Den daglige kurven i by_day dekker det fulle nitti-dagersvinduet. Nylige dager ligger i området på omtrent 400 000 til 700 000 artikler per dag; tidligere i vinduet, før RSS-laget ble lagt til sammen med arkivopptaket, lå det daglige volumet på 130 000–230 000. Begge tallene er synlige i samme svar, som poenget — tjenesten viser deg sin egen opptrapping fremfor å sitere et markedsføringsgjennomsnitt.

Trender: Hva pressen faktisk dekker akkurat nå

Søk svarer på «hvad som ble skrevet om X». Trender svarer på et annet og ofte bedre spørsmål: "hva som skjer" — uten at X er nødvendig.

En robot grupperer artikler i historier per land og holder dem oppdatert. Hvert femte minutt blir nye artikler festet til kjente historier ved hjelp av identifiserende ord, helt uten modellkall; hvert par timer gjennomgår et land en full gjennomgang der en språkmodell leser overskriftene og navngir historiene på nytt. På tidspunktet for skriving dekker trendlaget 115 land, hver gjenberegnet innenfor de siste få minuttene.

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 tellinger følger med hver historie og de betyr forskjellige ting. articles er styrke; publishers er bredde. En historie med 200 artikler fra 4 aviser er en redaksjons besettelse. En historie med 60 artikler fra 40 aviser er en begivenhet. Standard sortering er etter utgivere, og min_publishers / min_articles lar deg sette terskelen selv.

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

Vinduet er leserens valg, ikke robotens

Dette er en virkelig elegant designbeslutning. Hver artikkel lagres med sin publiseringstid og knyttes til sin historie, så ethvert vindu — femten minutter, en time, en dag, en spesifikk kalenderdato — er bare et intervallspørring over den samme lagrede dataen. Én beregning dekker alle vinduer samtidig. window=15m, window=1h, window=24h, date=2026-09-01 eller et eksplisitt since/until-par fungerer alle mot den samme indeksen uten ny beregning.

Nøkkelord: ordene nyhetene er bygget på

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

Hvert nøkkelord returneres med antall distinkte historier som inneholder det, hvor mange artikler disse historiene inneholder, og — det interessante — hvor mange nasjonale aviser som bruker det. Det siste tallet er forskjellen mellom en global hendelse og en internasjonal. Et ord som forekommer på tvers av sytti land er en verdensnyhet; et ord som dominerer en lands presse er en internasjonal nyhet, uansett hvor høylydt det er der.

Hvilke land som er live

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

Returnerer alle spårede land med deres antall live-historier og hvor mange minutter siden det ble beregnet på nytt — Tyrkia, Russland, Iran, Hellas, India, Italia, Ukraina, Romania, Argentina, Tyskland og Brasil har alle for øyeblikket tusenvis av live-historier hver, beregnet på nytt innenfor de siste ti minuttene. Og /v1/trends/{cc}/{slug} åpner en enkelt historie med sin fulle artikkelliste.

Markeder vs. dekning: Pris på den ene aksen, oppmerksomhet på den andre

Dette er det mest uvanlige ved tjenesten, og det eksisterer fordi korpusset gjør det nesten kostnadsfritt å bygge. Legg en prisseires ved siden av hvor mye verden skrev om det i de samme timene, på én tidslinje.

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

Fjorten instrumenter spores, på tvers av fire eiendelsklasser:

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

Det ene kallget gir deg lira mot dollar og volumet av dekningen i tyrkisk presse over samme periode, timevis sammenfallende. Den tyrkiske pressen utgjør den tredje største delen av dette korpuset, noe som er nettopp grunnen til at denne kombinasjonen gir noe meningsfullt snarere enn støy.

Og et fullt sentimentblokk for Bitcoin

Bitcoin får sin egen familie med sju endepunkter, fordi det er det eneste instrumentet der nyhetstemning og prisbevegelser stadig diskuteres, men sjelden måles:

Stemningsmerkene kommer fra en språkmodell som kjører over ferske kryptoartikler hvert femte minutt, mot en kalibrert liste over mynter. /v1/btc/correlation med en max_shift-parameter er det du bør bruke hvis du noen gang har ønsket å teste påstanden «nyhetene forårsaker bevegelser» i stedet for å gjenta den.

Søket, som en feed

Tre flere endepunkter tar de identiske søkeparameterne og returnerer resultatene 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 betyr at enhver lagret søkeforespørsel blir til en feed du kan lime inn i en leser, en n8n-node, en Slack-integrasjon, en Zapier-utløser eller en statisk sidegenerator — uten kode og uten nøkkel. Det er en liten funksjon som stille fjerner et helt integrasjonslag for ikke-programmerere.

MCP: 28 verktøy, to lag

MCP-serveren bor på en URL, snakker Streamable HTTP (JSON-RPC 2.0 over POST, protokollversjon 2025-06-18), støtter batch-behandling, og — som alt annet her — har ingen autorisasjonstrinn og ingen økt-ID.

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

Den eksponerer 28 verktøy i to bevisste lag.

Lag én: seks snarveier som svarer på et helt spørsmål i ett kall

Lag to: alle endepunkter, generert fra tjenesten selv

Under snarveiene eksponeres hvert råe endepunkt som sitt eget verktøy med alle parameterne API godtar — 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 er generert fra den live-tjenesten, så de kan ikke avvike fra det API faktisk godtar.

To meta-verktøy lukker syklusen: news_list_endpoints returnerer katalogen over alt som finnes, og news_get utfører en rå GET på enhver sti — slik at en agent som støter på et endepunkt som ikke dekkes av verktøylisten sin, fortsatt kan nå det.

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

En GET, ingen håndtrykk, og du har hele maskinlesbare katalogen: server, transport, protokoll, antall verktøy, hvert verktøy med sin beskrivelse, og hvert endepunkt med sin parameterliste.

Bygd for å leses av maskiner

Dokumentasjonen er ikke en ettertanke som er limt på API — det er et førsteklasse-utdata fra den. Nettstedet leverer 665 statiske sider, og flere av dem eksisterer spesifikt slik at en modell aldri trenger å lese HTML:

• /openapi.json Det fullstendige OpenAPI-skjemaet.
• /llms.txt En kort orienteringsfil — hva tjenesten er, endepunktene, hvordan du utfører spørringer på en god måte, og feilmeldinger.
• /llms-full.txt Hele dokumentasjonen som én ren tekstfil, over hundre kilobytters stor, slik at en agent kan laste inn hele manualen i ett enkelt kall.
• /agents Niogtredve sider rettet direkte mot agentutviklere: ferdige OpenAI-funksjonsdefinisjoner, Anthropic-verktøysdefinisjoner, systemprompter for nyhetsoppslag, RAG-oppskrifter, tabeller over token-kostnader og agentoppskrifter.
• /agents/models Kode for verktøypåkalling per 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 Hva som finnes i korpusmet, metodikken, indeks-skjemaet og en side med tittelen Datakvalitet som dokumenterer hva datasettet gjør feil.
• /sources Et gjennomgåbart katalog over 11 668 utgivere, som kan filtreres etter land, språk og domenenavn.
• /compare Sider side ved side med NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube og FreeNewsAPI.io.

Pluss 168 landssider, 121 språksider og 275 TLD-sider — én utforskbar flate per segment av korpuset, der du kan se hva som faktisk befinner seg i det.

Hvor artiklene kommer fra

To inntakspor foder samme indeksen, og forskjellen mellom dem er viktig.

Arkivveien

Hvert tiende minutt sjekker en jobb Common Crawls CC-NEWS-arkiv for nye WARC-filer og behandler alt den ikke har sett tidligere, ved hjelp av førti parallellarbeidere. Uttrekkeren henter hver artikkel ut av den råe crawlen med en dokumentert trappeløsning per felt — og trappeløsningene ble målt mot reelle data i stedet for å bli antatt:

Den landegruppfiguren er den ærlige, og det er grunnen til at country_source eksponeres i hver artikkel: omtrent en femtedel av registreringen har ingen pålitelig landsignal, og om lag en tredjedel av verdiene som finnes, er inferenser snarere enn fakta. API forteller deg hvilken som er hvilken i stedet for å late som.

Den sanne veien

En annen robot poller utgiver RSS-feed hver femte minutt, i en rotasjon med betingede forespørsler — en feed som svarer med 304 Not Modified koster nesten ingenting, og hver feeds pollintervall er tilpasset hvor ofte den faktisk publiserer. En utgivelse som publiserer fem historier i dagen blir ikke hamret hver femtende minutt.

Den tar også bare det som utgiveren la inn i feeden: tittel, innledning og full tekst når feeden inneholder den. Den går ikke inn på utgiverens nettsted for å hente mer. Det er en bevisst grense, og det er grunnen til at tjenesten kan gi løftene den gir på sin juridiske side for utgivere.

Og maskineriet rundt dem

Rundt de to inngangsveiene sitter et dusin flere roboter på tidstabeller: kildeoppdagelse og synkronisering, per-domene landoppløsning, trendbygging og revisjon, nøkkelord-tilbakefylling, krypto-sentiment, markedstrekker, et taksonomikatalog, beholdning (nittidagersvinduet håndheves av en nattlig spørring på published_at, ikke av indeksalder), dagsverifisering, tomme artikkelkontroller, og en helsevakt som starter opp alt som har stoppet. Korpusset bor på et dedikert Elasticsearch-klynge.

Hva dette datasettet gjør feil

Tjenesten publiserer sine egne begrensninger, som er den raskeste måten å vurdere om den passer ditt problem.

• Land er inferert Les country_source i hver artikkel, og legg til strict_country=true når du teller etter land i stedet for å bla gjennom.
• published_at er utgiver-levert Tilbakedatering er vanlig. Sorter etter crawled når du poller for hva som er nytt.
• total er begrenset til 10 000 For hastighet. total_is_lower_bound forteller deg når du treffer taket.
• Ingen sentiment- eller entitetsuttrekk Utenfor Bitcoin-blokk, bærer artikler ingen sentimentpoeng og ingen navngitte entiteter. Det er ikke i omfang.
• Nitti dager og ikke mer Det finnes ingen dypere arkiv. Hvis du trenger data fra 2019, er dette verktøyet for feil.
• Ingen SLA Det er gratis. Det overvåkes og beskyttes likevel, men ingenting er lovet skriftlig.
• Teksten tilhører utgiverne Hvert svar inneholder den opprinnelige URL, og brukerne forventes å lenke tilbake til den.

Bruk på rett måte: Kostnad, sidehopping og feil

Token-disiplin

For en agent er svarstørrelsen den reelle kostnaden. Den dokumenterte strukturen:

Tjue artikler med full_text=true tilsvarer omtrent 40 000 tokens. Det anbefalte mønsteret er alltid det samme: tell, skann, og hent deretter kroppene for de få du trenger.

Blar forbi taket

offset stopper ved 9 900. For å traversere et stort sett, ikke kjemp mot taket — del opp etter tid i stedet. Loop dag for dag, eller time for time ved en travel spørring, med from/to og sort=date. Dokumentasjonen har en dedikert side om å traversere en hel dag.

Feil

Kontrakten er rett på sak og enkel å kode mot: 4xx betyr at forespørselen er feil — rett den, ikke prøv på nytt. 5xx betyr at tjenesten er nede — trekk deg tilbake. 429 betyr å senke farten og prøve på nytt. Ukjente spørringsparametere ignoreres i stedet for å forkastes, slik at det å legge til et felt aldri kan ødelegge for en eksisterende klient.

Identifiser deg selv (Valgfritt, og virkelig valgfritt)

Uten en nøkkel er det ingen måte å nå en klient på. Den foreslåtte høfligheten er en header som navngir agenten din, rammeverket den kjører gjennom og modellen som driver den:

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 verdiene fungerer som vanlige spørringsparametere, noe som vanligvis er enklere:

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

Ukjente nøkler ignoreres, slik at ekstra nøkler alltid er trygge å sende. Ingen validering foretas, ingen throttling skjer for å utelate den, og den ene instruksen er bestemt: sett aldri persondata for sluttbrukere i disse feltene.

Mot de betalte nyhetene API

Sammenligningssidene på nettstedet dekker elleve konkurrenter individuelt. De strukturelle forskjellene som overlever dem alle:

Hva de betalte tjenestene fortsatt tilbyr, og som dette ikke gjør: stemningsanalyser (sentiment scores) og entitetsuttrekk som standardfelt, arkiver som strekker seg tilbake i flere år, og en kontrakt med en SLA bak seg. Disse er reelle, og hvis du trenger dem, bør du kjøpe dem.

Oppskrifter

En live-landmonitor

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

Er denne saken global eller innenlandsk?

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

Forankre en modell i dagens dekning, til lav pris

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

Styrer dekningen prisen?

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

Konverter en lagret søkeforespørsel til en feed

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

Finn dekningene som betyr noe 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

Kortversjonen

Free News API tilbyr fulltekstsøk over 21,5 millioner nyhetsartikler fra mer enn 25 000 utgivere i 100 land og rundt 100 språk, med et rullende vindu på nitti dager som oppdateres kontinuerlig, uten nøkkel, uten påmelding og uten kvote utover en per-IP-hastighetsbegrensning. Over søket ligger sanntidsklustering av historier per land i 115 land, nøkkelordsanalyse som skiller mellom internasjonale og nasjonale hendelser, kartlegging av fjorten markedsinstrumenter mot dekningsvolum, en blokk for Bitcoin-sentiment med sju endepunkter, RSS/Atom/JSON-syndikering av alle søk, og en 28-verktøys MCP-server generert fra tjenesten selv.

Den dokumenterer sine egne feilrater, viser hvordan hver landverdi er beregnet, og publiserer en side om hva dataene kan feile. For en agent som trenger å vite hva verden sier — på tyrkisk, gresk, hindi, akkurat nå — er denne kombinasjonen vanskelig å finne til noen pris, og denne er gratis.

Søket er en AND-operasjon over alle ledd. Bruk 2–5 nøkkelord, ikke et spørsmål på naturlig språk.

Free News API, om hvordan du søker effektivt

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