NyhetsAPI säljs vanligtvis per begäran, är gömda bakom en nyckel och begränsade till hundra anrop per dag i den kostnadsfria nivån. Free News API är inget av detta: 21,5 miljoner artiklar i ett löpande 90-dagarsfönster, 25 000+ utgivare, ingen nyckel, ingen registrering, ingen kvot, kommersiell användning tillåten. Här är hela ytan — sökning, statistik, trender, marknader, flöden och MCP — samt en ärlig redogörelse för vad datan missar.
Problemets utformning
Fråga en AI-agent vad världen skriver om just nu, så har den tre dåliga alternativ. Den kan skrapa utgivare direkt, vilket är skört, långsamt och juridiskt grått. Den kan anropa en kommersiell nyhetsAPI, vilket innebär ett konto, en nyckel, en månatlig faktura och — på varje kostnadsfri nivå på marknaden — hundra begäranden per dag och artiklar som försenas med tjugo fyra timmar. Eller så kan den gissa utifrån träningsdata som slutade för några månader sedan.
Free News API tar bort mellankostnadens pris och pappersarbete utan att ta bort dess kapacitet. Ett GET-anrop, inga inloggningsuppgifter, över en korpus som vid skrivtidpunkten innehåller 21 557 044 artiklar från mer än tjugofem tusen utgivare, lagrade i ett löpande nittio dagars fönster och uppdaterade kontinuerligt — den nyaste artikeln i indexet är vanligtvis mindre än två minuter gammal.
Fyra kärnslutpunkter, och lite till
Tjänstens kärna utgörs av fyra GET-slutpunkter, alla under https://freenewsapi.ai, som alla returnerar UTF-8 JSON med Access-Control-Allow-Origin: * så att webbkod kan anropa dem direkt, och som alla rapporterar servertid i took_ms.
| Slutpunkt | Vad den besvarar |
|---|---|
GET /v1/search | Fulltextsökning med filter. Slutpunkten du använder 95 % av tiden. |
GET /v1/stats | Aggregerade räknesiffror för vilken snitt som helst – efter land, språk, TLD, utgivare och dag. |
GET /v1/article | En artikel med dess exakta URL, inklusive hela brödtexten. |
GET /health | Liveness plus det aktuella dokumentantalet. Billigt nog att polla. |
Runt den kärnan finns fyra ytterligare familjer, var och en av vilka skulle vara en egen produkt någon annanstans: trends (live story clustering per land), markets (prissierier i relation till täckningsvolym), crypto sentiment (en sju-punkts Bitcoin-block) och syndication (sökningen som RSS, Atom eller JSON-flöde). Alla dessa täcks nedan.
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 fält i svaret förtjänar omedelbar uppmärksamhet eftersom de kodar hela datasetets ärlighet. total_is_lower_bound visar när matchningsantalet nått sin takgräns på 10 000 och slutat räkna. country_source visar hur landet bestämdes — eftersom i ett stort nyhetsdataset är en stor del av landsvärdena inferenser, inte fakta. Och crawled_at är den tillförlitliga tidsstämpeln: publicerare bakdaterar published_at regelbundet, men crawl-tiden tilldelas av pipeline och rör sig bara framåt.
Sök: Varje parameter som betyder något
Alla parametrar är valfria. Ett tomt anrop returnerar de senaste artiklarna i indexet.
Frågan
- q Matchas mot titel (vikt 3), beskrivning (vikt 2) och artikelbrödtexten. AND-semantik — varje term måste vara närvarande, så att lägga till ett ord smalnar av snarare än att bredda. Maximalt 500 tecken.
opec production cut fungerar. what did OPEC decide about oil returnerar ingenting.Filtern
Filter kombineras med AND över parametrar och OR inom en parameter. Så country=DE,AT&lang=de läses som "artiklar på tyska från Tyskland eller Österrike". Var och en accepterar en kommaseparerad lista med upp till femtio värden.
| Filter | Format | Noteringar |
|---|---|---|
country | ISO 3166-1 alpha-2, versaler | Utgivarens land. Härlett, inte angivet — se country_source och strict_country. |
lang | ISO 639-1, gemener | Detekteras från dokumentet i sig. 99,9 % täckning. |
tld | utan punkt | Domänzon för utgivaren. tld=ua är en faktum; country=UA är en slutsats. |
host | exakta värdnamn | Som de visas i URL — inkludera www. om utgivaren använder det. |
date | idag · igår · 24h · 48h · 7d · 30d | Förinställd period, utvärderad mot published_at. |
från / till | ISO-datum | Explicit fönster när förinställningarna inte passar. |
strict_country | sant/falskt | Räkna endast artiklar vars land är en fast faktauppgift snarare än en slutsats. |
Utmatningskontroll
| Parameter | Värden | Effekt |
|---|---|---|
sort | datum · datum_asc · crawlad · crawlad_asc · relevans | Sortera efter crawlad vid hämtning av nya artiklar — publiceringstider fördras ibland av utgivare; crawltiden går bara framåt. |
size | 1–100 | Resultat per sida. |
offset | 0–9900 | Sidhoppningsoffset. |
full_text | true/false | Inkludera artikelns brödtext. Avstängt som standard. |
highlight | true/false | Returnera matchande fragment. |
fields | CSV | Begränsa svaret till de fält du faktiskt använder. |
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"Räkna innan du söker
Den mest underutnyttjade slutpunkten i tjänsten är /v1/stats. Den mest användbara frågan är ofta inte "vad är artiklarna" utan "finns det något här alls, och var finns det". Att räkna svar kostar en bråkdel av priset — ungefär tvåhundra tokens jämfört med flera tusen för en sida med resultat — vilket gör det till det korrekta första anropet för en agent som avgör om en sökning är värd att köra.
curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"Den returnerar antal per land, språk, TLD, utgivare och dag, beräknade över hela den matchande mängden snarare än den aktuella sidan. Detta är också hur du mäter täckningen innan du litar på den. Den ofiltrerade ögonblicksbilden vid skrivtidpunkten:
Topp länder
| Land | Artiklar |
|---|---|
| Indien | 2,286,014 |
| USA | 2,180,797 |
| Turkiet | 1,499,897 |
| Ryssland | 1,436,556 |
| Italien | 1,057,479 |
| Argentina | 826,947 |
| Spanien | 812,347 |
| Ukraina | 662,041 |
| Brasilien | 551,013 |
| Tyskland | 543,132 |
| Frankrike | 502,846 |
| Grekland | 460,372 |
| Japan | 437,209 |
| Vietnam | 408,934 |
| Mexiko | 402,320 |
| Sydkorea | 362,945 |
| Rumänien | 354,229 |
| Storbritannien | 334,379 |
| Iran | 291,782 |
| Polen | 255,599 |
Toppade språk
Engelska 5 513 650 · spanska 2 699 457 · ryska 1 785 796 · turkiska 1 501 004 · italienska 992 200 · tyska 733 677 · franska 689 136 · arabiska 664 016 · portugisiska 637 607 · hindi 560 840 · grekiska 466 504 · japanska 427 085 · vietnamesiska 385 719 · rumänska 358 766 · kinesiska 352 720 · ukrainska 345 809 · koreanska 335 079 · persiska 268 126 · polska 238 904 · bulgariska 183 204.
Denna fördelning är värd att titta närmare på, eftersom den är raka motsatsen till vad de flesta nyhetsAPI ger dig. Den vanliga engelsk-först, USA-först-korpusen är inte vad detta är: Indien slår USA, turkiska slår tyska, och grekiska, vietnamesiska, persiska och bulgariska har alla sexsiffrigt representation. Om din fråga handlar om en icke-engelsk press är detta en materiellt annorlunda dataset.
Volym
Den dagliga kurvan i by_day täcker hela fönstret på nittio dagar. De senaste dagarna ligger i intervallet cirka 400 000 till 700 000 artiklar per dag; tidigare i fönstret, innan RSS-lagret lades till tillsammans med arkivinsamlingen, var den dagliga volymen 130 000–230 000. Båda siffrorna är synliga i samma svar, vilket är poängen – tjänsten visar dig sin egen uppbyggnad snarare än att citera ett marknadsföringsgenomsnitt.
Trender: Vad pressen faktiskt täcker just nu
Sök svarar på "vad som skrevs om X". Trender svarar på en annan och ofta bättre fråga: "vad som händer" – utan att X krävs.
En robot klustrar artiklar i berättelser per land och håller dem uppdaterade. Varje femte minut fästs nya artiklar vid kända berättelser via deras identifierande ord, helt utan modellanrop; varannan timme genomgår ett land en fullständig passning där en språkmodell läser rubrikerna och namnger berättelserna från grunden. Vid skrivtidpunkten täcker trendlagret 115 länder, var och en omberäknad inom de senaste minuterna.
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": [ … ]
}
]
}Varje berättelse följs av två räkningar som betyder olika saker. articles är högljuddhet; publishers är bredd. En berättelse med 200 artiklar från 4 utgivare är ett nyhetsrumss intresse. En berättelse med 60 artiklar från 40 utgivare är en händelse. Den默认排序 är efter utgivare, och min_publishers / min_articles låter dig sätta tröskeln själv.
Berättelser tillhör en kategori från ett fast urval: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.
Fönstret är läsarens val, inte robotens
Detta är ett genuint elegant designval. Varje artikel sparas med sin publiceringstid och kopplas till sin berättelse, så vilket fönster som helst — femton minuter, en timme, en dag, ett specifikt kalenderdatum — är bara ett intervallfilter mot samma lagrade data. En enda beräkning fungerar för alla fönster samtidigt. window=15m, window=1h, window=24h, date=2026-09-01 eller ett explicit since/until-par fungerar mot samma index utan ny beräkning.
Nyckelord: orden som nyheterna bygger på
curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"Varje nyckelord returneras med information om hur många distinkta berättelser som innehåller det, hur många artikler dessa berättelser består av, och — det intressanta — hur många nationella tidningar som använder det. Det sista talet är skillnaden mellan en global händelse och en inhemsk. Ett ord som förekommer i sjuttio länder är en världshändelse; ett ord som dominerar en nations press är en inhemsk händelse, oavsett hur högt det ekar där.
Vilka länder som är live
curl "https://freenewsapi.ai/v1/trends/countries"Returnerar alla spårade länder med deras antal live-berättelser och hur många minuter sedan de beräknades om — Turkiet, Ryssland, Iran, Grekland, Indien, Italien, Ukraina, Rumänien, Argentina, Tyskland och Brasilien har alla för närvarande tusentals live-berättelser var, beräknade om inom de senaste tio minuterna. Och /v1/trends/{cc}/{slug} öppnar en enskild berättelse med dess fullständiga artikelista.
Marknader mot täckning: Pris på en axel, uppmärksamhet på den andra
Detta är det mest udda med tjänsten, och det finns eftersom corpuset gör det nästan kostnadsfritt att bygga. Placera en prisserie bredvid hur mycket världen skrev om den saken under samma timmar, på en tidslinje.
curl "https://freenewsapi.ai/v1/markets"Fyrtiotvå instrument spåras, över fyra tillgångsslag:
| Klass | Instrument | Upplösning | Källa |
|---|---|---|---|
| Krypto | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | timme | Binance |
| Metaller | Guld (USD/oz) | timme | Binance |
| Valuta | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | dag | ECB |
| Energi | Tyskt elpris (EUR/MWh) | timme | Energy-Charts |
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"Det enda anropet ger dig kursen för lira mot dollar samt volymen av turkisk pressbevakning under samma period, matchad timme för timme. Den turkiska pressen utgör den tredje största delen av detta korpus, vilket är exakt varför den här kombinationen ger något meningsfullt snarare än brus.
Och ett komplett block för Bitcoin-sentiment
Bitcoin får sin egen familj med sju slutpunkter, eftersom det är det enda instrument där nyhetston och prisrörelser ständigt diskuteras men sällan mäts:
| Slutpunkt | Svar |
|---|---|
/v1/btc/summary | Senaste pris, senaste rörelser och dagens nyhetstonsläge. |
/v1/btc/price | BTC/USDT-lysstavlar efter intervall. |
/v1/btc/sentiment | Nyhetston per period. |
/v1/btc/series | Pris och ton utjämnade på en tidslinje. |
/v1/btc/correlation | Korrelation mellan ton och prisrörelse med tidsförskjutning — leder täckningen priset, eller följer den det? |
/v1/btc/news | Kryptoartiklar med deras sentimentetikett, filtrerbara efter etikett, värd, språk och fråga. |
/v1/btc/sources | Vilka medier som driver kryptojournalistiken och hur de respektive bedömer läget. |
Sentimentetiketterna hämtas från en språkmodell som analyserar färsk kryptojournalistik var femte minut mot en kalibrerad lista över mynt. /v1/btc/correlation med en max_shift-parameter är den att välja om du någonsin velat testa påståendet att "nyheterna orsakar rörelsen" snarare än att upprepa det.
Sökningen som en flödeskälla
Tre ytterligare slutpunkter tar samma sökparametrar och returnerar resultaten som syndikeringsformat istället för JSON:
GET /v1/rss— RSS 2.0GET /v1/atom— Atom 1.0GET /v1/feed.json— JSON Feed 1.1
https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=dateDet innebär att en sparad sökning blir ett flöde som du kan klistra in i en läsare, en n8n-nod, en Slack-integration, en Zapier-triggern eller en statisk webbplatsgenerator — utan kod och utan nyckel. Det är en liten funktion som i det tysta tar bort en hel integrationslager för icke-utvecklare.
MCP: Tjugoåtta verktyg, två lager
MCP-servern finns på en enda URL, stödjer Streamable HTTP (JSON-RPC 2.0 över POST, protokollversion 2025-06-18), stödjer batchbearbetning och — precis som allt annat här — saknar autentiseringssteg och session-id.
claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcpDen exponerar 28 verktyg i två medvetna lager.
Lager ett: sex genvägar som besvarar en hel fråga i ett enda anrop
| Verktyg | För |
|---|---|
search_news | "Vad som skrevs om X" — fulltextsökning, med avkortade resultat. |
get_trends | "Vad som händer" — grupperade nyheter snarare än en artikelista. |
trend_keywords | De ord som nyheterna bygger på just nu, med antalet berättelser och spridning per land. |
find_publishers | Sök efter utgivare: namn, domän, land, språk, artiklar per dag. |
list_countries | Vilka länder som har levande nyheter, hur många och hur färskt materialet är. |
market_vs_news | En prisserie bredvid täckningsvolym. Anropas utan instrument för att se vad som finns tillgängligt. |
Lager två: varje slutpunkt, genererad från tjänsten i sig
Under genvägarna exponeras varje rå slutpunkt som ett eget verktyg med alla parametrar som API accepterar — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, hela familjen news_get_btc_*, feed-renderingarna och news_get_health. Dessa genereras från den aktiva tjänsten, så de kan inte avvika från vad API faktiskt accepterar.
Två metaverktyg sluter cirkeln: news_list_endpoints returnerar katalogen över allt som finns, och news_get utför en rå GET på vilken sökväg som helst — så att en agent som stöter på en slutpunkt som inte täcks av dess verktygslista fortfarande kan nå den.
curl "https://freenewsapi.ai/mcp?format=json"En GET, inget handslag, och du har hela den maskinläsbara katalogen: server, transport, protokoll, antal verktyg, alla verktyg med sin beskrivning och varje slutpunkt med sin parametralista.
Byggd för att läsas av maskiner
Dokumentationen är inte en efterhandsfix som fästs på API — det är en förstklassig produkt från den. Webbplatsen levererar 665 statiska sidor, och flera av dem finns specifikt för att en modell aldrig ska behöva läsa HTML:
- /openapi.json Den fullständiga OpenAPI-schema.
- /llms.txt En kort orienteringsfil — vad tjänsten är, vilka slutpunkter som finns, hur man ställer frågor på bästa sätt samt felhantering.
- /llms-full.txt Hela dokumentationen som en enda textfil, som är över hundra kilobyte stor, så att en agent kan läsa in hela manualen vid ett enda anrop.
- /agents Trettionio sidor riktade direkt till utvecklare av agenter: färdiga OpenAI-funktionsdefinitioner, definitioner för verktygsanvändning i Anthropic, systemprompter för nyhetsinhämtning, RAG-recept, tabeller över tokenkostnader och agentrecept.
- /agents/models Kod för verktygsanrop per modellfamilj — 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 Vad som finns i corpuset, metodologin, indexschema och en sida med titeln Datakvalitet som dokumenterar vad datasetet har fel med.
- /sources Ett genomlysbart katalog över 11 668 utgivare, som kan filtreras efter land, språk och domäntoppdomän.
- /compare Jämförelsesidor mot NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube och FreeNewsAPI.io.
Tillkommer 168 landsidor, 121 språksidor och 275 TLD-sidor – en sökväg per del av corpuset, där du ser exakt vad som finns i respektive avsnitt.
Varifrån artiklarna kommer
Två inmatningsvägar matar samma index, och skillnaden mellan dem spelar roll.
Arkivvägen
Varje tionde minut kontrollerar en uppgift Common Crawl:s CC-NEWS-arkiv efter nya WARC-filer och bearbetar allt som inte har setts tidigare, med fyrtio parallella arbetare. Extraktorn hämtar varje artikel ur den råa crawlen med en dokumenterad kedja för varje fält – och kedjorna har mätts mot verklig data snarare än antagits:
| Fält | Kedja | Täckning |
|---|---|---|
| beskrivning | JSON-LD → meta → OpenGraph → Twitter-kort → articleBody → inledande stycke | 98.1% |
| språk | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| land | ccTLD → JSON-LD addressCountry → språk-region → og:locale | 79.1% |
| datum | JSON-LD datePublished → meta → trafilatura → crawl-tid | 100% |
Den där siffran för land är den ärliga, och det är därför som country_source exponeras i varje artikel: ungefär en femtedel av posterna saknar ett tillförlitligt landsignal, och ungefär en tredjedel av de värden som finns är härledda snarare än fakta. API visar vilken som är vilken istället för att låtsas.
Den direkta vägen
En andra robot hämtar från publicerarens RSS-flöden var femte minut, i en rotation med villkorliga begäranden — ett flöde som svarar med 304 Not Modified kostar nästan inget, och varje flödes hämtningsintervall är anpassat efter hur ofta det faktiskt publicerar. En utgivning som lägger ut fem artiklar om dagen hamnar inte under konstant belastning varannan kvart.
Den tar också bara det som publiceraren lagt i flödet: titel, ingress och fulltext när flödet innehåller det. Den går inte in på publicerarens webbplats för att hämta mer. Det är en medveten gräns, och det är anledningen till att tjänsten kan hålla de löften den ger på sin juridiska sida för publicerare.
Och maskineriet kring dem
Runt de två inmatningsvägarna finns ett dussintal andra robotar med schemalagda uppgifter: källupptäckt och synkronisering, landsbestämning per domän, trendbyggnad och granskning, nyckelordsåterfyllnad, kryptokänsla, marknadsdragningar, ett taxonomikatalog, retention (fönstret på nittio dagar upprätthålls av en nattlig fråga på published_at, inte via ålder i index), dagverifiering, kontroller av tomma artiklar, och en hälsoskyddare som startar om allt som har stannat. Korpusen finns på en dedikerad Elasticsearch-cluster.
Vad denna dataset missar
Tjänsten publicerar sina egna begränsningar, vilket är det snabbaste sättet att bedöma om den passar ditt problem.
- Land är härlett Läs
country_sourcei varje artikel, och lägg tillstrict_country=truenär du räknar per land snarare än att bläddra. - published_at anges av publiceraren Tillbakadatering är vanligt. Sortera efter
crawlednär du hämtar vad som är nytt. - total är begränsat till 10 000 För hastighet.
total_is_lower_boundberättar för dig när du når taket. - Ingen känslomässig analys eller entitetsutvinning Utanför Bitcoin-blocket bär artiklarna ingen känslomässig bedömning och inga namngivna entiteter. Det ligger inte inom ramen för tjänsten.
- Nittio dagar och inte mer Det finns inget djupare arkiv. Om du behöver data från 2019 är detta fel verktyg.
- Ingen SLA Det är gratis. Det övervakas och skyddas dock, men inget lovas skriftligen.
- Texten tillhör utgivarna Varje svar innehåller den ursprungliga URL, och användare förväntas länka tillbaka till den.
Att använda det på rätt sätt: Kostnad, paginering och fel
Token-disciplin
För en agent är svaretstorleken den faktiska kostnaden. Den dokumenterade strukturen:
| Anrop | Ungefärlig tokenkostnad | När |
|---|---|---|
/v1/stats | ~200 | Först. Bestäm om sökningen är värd att utföra överhuvudtaget. |
/v1/search endast metadata | några tusen per sida | Skanna och välj. |
/v1/search?full_text=true | ~900 per artikel | Endast för de få du faktiskt valde. |
Tjugo artiklar med full_text=true motsvarar ungefär 40 000 tokens. Det rekommenderade mönstret är alltid detsamma: räkna, skanna och hämta sedan texten för de få du behöver.
Bläddra förbi takgränsen
offset stannar vid 9 900. För att bläddra igenom ett stort urval bör du inte kämpa mot takgränsen utan dela upp datan efter tid. Loopa dag för dag, eller timme för timme vid en intensiv fråga, med from/to och sort=date. Dokumentationen har en dedikerad sida om hur man bläddrar igenom en hel dag.
Fel
Kontraktet är rakt på sak och enkelt att hantera i kod: 4xx betyder att begäran är felaktig — åtgärda den, försök inte om. 5xx betyder att tjänsten är nere — dra ner på takten. 429 betyder att du ska sänka takten och försöka om. Okända frågeparametrar ignoreras snarare än att avvisas, så att lägga till ett fält kan aldrig bryta en befintlig klient.
Identifiera dig själv (Valfritt, och verkligen valfritt)
Utan en nyckel finns inget sätt att nå en klient. Den föreslagna artigheten är ett header-värde som anger ditt agentprogram, det ramverk det körs via och modellen som 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>)Samma värden fungerar som vanliga frågeparametrar, vilket oftast är enklare:
https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4oOkända nycklar ignoreras, så extra nycklar är alltid säkra att skicka. Inget valideras, inget throttles för att det utelämnas, och den enda instruktionen är bestämd: lägg aldrig persondata för slutanvändare i dessa fält.
Mot de betalda nyheterna APIs
Jämförelsesidorna på webbplatsen täcker elva konkurrenter var för sig. De strukturella skillnader som överlever alla:
100 förfrågningar/dygn, 24 timmars fördröjning
Den vanliga formen på en gratis nyhets-API-nivå: en tokenhink som är liten nog att fungera som en demo, där färskt innehåll hålls tillbaka för betalkunder.
- Nyckel krävs
- Daglig gräns
- Fördröjda artiklar
- Endast icke-kommersiell användning
Ingen gräns, ingen fördröjning, ingen nyckel
20 förfrågningar per sekund per IP är den enda begränsningen. Den senaste artikeln är vanligtvis under två minuter gammal, och kommersiell användning är tillåten.
- Ingen nyckel, ingen registrering
- Ingen daglig eller månadsmässig gräns
- Kontinuerlig uppdatering
- Kommersiell användning tillåten
Engelska först, USA först
De flesta korpusar byggs utifrån en lista över engelskspråkiga utgivare och resten av världen läggs till.
- Engelskt dominerande
- Tunn täckning av icke-latinska språk
Indien > USA, turkiska > tyska
Cirka 100 språk med sexsiffriga volymer i grekiska, vietnamesiska, persiska, ukrainska och bulgariska.
- 100 länder
- Cirka 100 språk
- 11 668 katalogiserade källor
Det som de betalda tjänsterna fortfarande erbjuder och som denna inte gör: stämningsanalyser och entitetsextrahering som standardfält, arkiv som går tillbaka i flera år, och ett avtal med en SLA bakom sig. Dessa är verkliga, och om du behöver dem bör du köpa dem.
Recept
En live-landövervakare
curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"Är denna historia global eller nationell?
curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world eventFörankra en modell i dagens täckning, 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"Leders täckning priset?
curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"Gör en sparad sökning till en flöde
https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50Hitta de utgivare som är viktiga på en marknad
curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that sliceKortversionen
Free News API är en fulltextsökning över 21,5 miljoner nyhetsartiklar från mer än 25 000 utgivare i 100 länder och ungefär 100 språk, med ett löpande nittidagarsfönster som uppdateras kontinuerligt, utan nyckel, utan registrering och utan kvot utöver en per-IP-satsningsgräns. Ovanpå sökningen finns livekluster för landsspecifika nyhetstrender över 115 länder, nyckelordsanalys som skiljer på världshändelser och inhemska händelser, fjorton marknadsinstrument som plottas mot täckningsvolymen, en block för Bitcoin-sentiment med sju slutpunkter, RSS/Atom/JSON-syndikering av valfri fråga och en 28-verktygs MCP-server som genereras från tjänsten i sig.
Den dokumenterar sina egna felmarginaler, visar hur varje landsvärde har beräknats och publicerar en sida om vad datan gör fel. För en agent som behöver veta vad världen säger – på turkiska, grekiska, hindi, just nu – är den kombinationen svår att hitta till vilket pris som helst, och denna är gratis.
Sökningen är AND över alla termer. Använd 2–5 nyckelord, inte en fråga på naturligt språk.
Free News API, om hur du ställer frågor på bästa sätt
Börja här: freenewsapi.ai · MCP på freenewsapi.ai/mcp · hela manualen som en enda fil på /llms-full.txt.