Free News API: Fulltextové vyhledávání přes 21 milionů článků, 25 000 vydavatelů a 100 zemí — zcela bez klíčů

Zpravodajské API se obvykle prodávají na základě počtu požadavků, jsou uzavřeny za API klíčem a na bezplatné úrovni mají limit sto volání denně. Free News API je přesně opak: 21,5 milionu článků v rámci plynoucího 90denního okna, více než 25 000 vydavatelů, žádné klíče, žádné registrace, žádné kvóty, komerční použití povoleno. Zde je kompletní přehled — vyhledávání, statistiky, trendy, trhy, feedy a MCP — a upřímný pohled na to, kde data selhávají.

Podstata problému

Zeptejte se AI agenta, o čem se právě píše ve světě, a narazí na tři špatné možnosti. Může scrapovat vydavatele přímo, což je křehké, pomalé a právně nejasné. Může zavolat komerční zpravodajský API, což znamená účet, klíč, měsíční fakturu a — na každé bezplatné úrovni na trhu — sto požadavků denně a zpoždění článků o dvacet čtyři hodin. Nebo může hádat z trénovacích dat, která jsou stará několik měsíců.

Free News API odstraňuje cenu a byrokracii prostřední možnosti, aniž by snížila její schopnosti. Jeden GET požadavek, žádné přihlašovací údaje, nad souborem dat, který v době psaní tohoto textu obsahoval 21 557 044 článků od více než dvaceti pěti tisíc vydavatelů, udržovaných v plynoucím devadesetidenním okně a průběžně aktualizovaných — nejnovější článek v indexu je obvykle starý méně než dvě minuty.

Čtyři základní koncové body a ještě něco

Jádrem služby jsou čtyři koncové body GET, všechny pod adresou https://freenewsapi.ai, všechny vracející UTF-8 JSON s hlavičkou Access-Control-Allow-Origin: *, což umožňuje volání přímo z kódu v prohlížeči, a všechny hlásující čas na straně serveru v poli took_ms.

Okolo tohoto jádra se nacházejí čtyři další rodiny, z nichž by každá byla samostatným produktem v jiném kontextu: trends (sdružování živých příběhů podle zemí), markets (cenové série zarovnané podle objemu coverage), crypto sentiment (sedmibodový blok Bitcoinu) a syndication (totožný vyhledávací výstup jako RSS, Atom nebo JSON Feed). Všechny z nich jsou podrobněji popsány níže.

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

Tři pole v této odpovědi si zaslouží okamžitou pozornost, protože kódují poctivost celého datasetu. total_is_lower_bound vám sdělí, kdy počet shod dosáhl stropu 10 000 a přestal počítat. country_source vám říká, jak byla země určena — protože v jakémkoli datasetu zpráv je velká část hodnot o zemi odvozena, nikoli založena na faktických datech. A crawled_at je důvěryhodné časové razítko: vydavatelé často pozadívají published_at, ale čas crawlování je přiřazen pipeline a vždy se posouvá pouze vpřed.

Vyhledávání: Každý parametr, který má význam

Všechny parametry jsou volitelné. Holé volání vrátí nejnovější články v indexu.

Dotaz

• q Srovnává se s titulkem (váha 3), popisem (váha 2) a tělem článku. Logika AND — každý term musí být přítomen, takže přidání sloha spíše zužuje než rozšiřuje výsledky. Maximálně 500 znaků.

Filtry

Filtry se kombinují s AND mezi parametry a OR uvnitř jednoho parametru. Takže country=DE,AT&lang=de čteme jako „články v němčině z Německa nebo Rakouska“. Každý filtr přijímá čárkami oddělený seznam až padesáti hodnot.

Ovládání výstupu

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"

Počítání před vyhledáváním

Nejméně využívaným koncovým bodem služby je /v1/stats. Často není užitečnou otázkou „jaké jsou články“, ale „je tam vůbec něco a kde to je“. Počítání odpoví na tuto otázku za zlomek nákladů — přibližně dvě stě tokenů oproti několika tisícům za stránku výsledků — což z něj činí správný první přívol pro agenta, který rozhoduje, zda se vyplatí vyhledávání spustit.

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

Vrací počty podle země, jazyka, TLD, vydavatele a data, vypočtené pro celou sadu shodných výsledků, nikoli pouze pro aktuální stránku. Také tak můžete měřit pokrytí, než začnete výsledkům důvěřovat. Ne filtrovaný snímek v době psaní:

Nejlepší země

Nejčastější jazyky

Angličtina 5 513 650 · španělština 2 699 457 · ruština 1 785 796 · turečtina 1 501 004 · italština 992 200 · němčina 733 677 · francouzština 689 136 · arabština 664 016 · portugalština 637 607 · hindština 560 840 · řečtina 466 504 · japonština 427 085 · vietnamština 385 719 · rumunština 358 766 · čínština 352 720 · ukrajinština 345 809 · korejština 335 079 · perština 268 126 · polština 238 904 · bulharština 183 204.

Toto rozložení stojí za to si na chvíli prohlédnout, protože je přesným opakem toho, co vám většina zpravodajských API poskytuje. Běžný anglikánsko-americký korpus není tím, co zde najdete: Indie předčí Spojené státy, turečtina předčí němčinu a řečtina, vietnamština, perština i bulharština mají všechny zástoupení s šesticiferným počtem. Pokud se ptáte na tisk mimo angličtinu, jedná se o materiálně odlišnou sadu dat.

Objem

Denní křivka v by_day pokrývá celé devadesátidenní okno. Nedávné dny se pohybují v rozmezí přibližně 400 000 až 700 000 článků denně; dříve v tomto okně, před přidáním vrstvy RSS spolu s archivním příjmem, denní objem činil 130 000–230 000. Obě čísla jsou viditelná ve stejné odpovědi, což je podstatou věci — služba vám ukazuje své vlastní nárůstové křivky, nikoliv uvádí marketingový průměr.

Trendy: Co zpravodajství právě skutečně pokrývá

Vyhledávání odpovídá na otázku „co bylo napsáno o X“. Trendy odpovídají na jinou a často lepší otázku: co se děje — bez nutnosti uvést X.

Robot seskupuje články do příběhů podle zemí a udržuje je aktuální. Každých pět minut se nové články přidávají k známým příběhům pomocí jejich identifikujících slov, zcela bez volání modelu; každé několik hodin prochází jedna země celým průchodem, kde jazykový model čte nadpisy a od začátku pojmenovává příběhy. V době psaní trendová vrstva pokrývá 115 zemí, každá přepočítaná během posledních několika minut.

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

Každý příběh přináší dva počty, které znamenají různé věci. articles je hlasitost; publishers je šířka. Příběh se 200 články ze 4 vydavatelství je posedlostí jedné redakce. Příběh se 60 články ze 40 vydavatelství je událostí. Výchozí třídění je podle vydavatelů a parametry min_publishers / min_articles vám umožňují si práh nastavit sami.

Příběhům jsou přiřazeny kategorie z pevné množiny: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

Okno je na volbě čtenáře, ne robota

Jde o skutečně elegantní designové rozhodnutí. Každý článek je uložen spolu s časem publikace a přiřazen k příslušnému příběhu, takže jakékoli okno — patnáct minut, hodina, den, konkrétní kalendářní datum — je jen dotaz na rozsah přes stejná uložená data. Jediný výpočet obslouží všechna okna najednou. Parametry window=15m, window=1h, window=24h, date=2026-09-01 nebo explicitní dvojice since/until fungují proti stejnému indexu bez nutnosti přepočítávání.

Klíčová slova: slova, na nichž jsou zprávy postaveny

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

Každé klíčové slovo je vráceno spolu s počtem odlišných příběhů, která jej obsahují, počtem článků, které tyto příběhy mají, a — tou zajímavější hodnotou — počtem národních tiskových agentur, která jej používají. To poslední číslo rozlišuje globální událost od domácí. Slovo vyskytující se ve sedmdesáti zemích je příběhem světovým; slovo dominující v tisku jedné země je příběhem domácím, ať už je v dané zemi jakkoli hlasité.

Které země jsou v přímém přenosu

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

Vrací všechny sledované země s počtem aktuálních příběhů a informací o tom, před kolika minutami byl výpočet proveden — Turecko, Rusko, Írán, Řecko, Indie, Itálie, Ukrajina, Rumunsko, Argentina, Německo a Brazílie mají aktuálně tisíce živých příběhů, které byly přepočteny během posledních deseti minut. A endpoint /v1/trends/{cc}/{slug} otevře libovolný jednotlivý příběh s jeho kompletním seznamem článků.

Trhy vs. pokrytí: cena na jedné ose, pozornost na druhé

Toto je nejzajímavější část služby a existuje proto, že díky korpusu je její vytvoření téměř bez nákladů. Položte cenový vývoj vedle toho, kolik o dané věci svět ve stejných hodinách napsal, na jednu časovou osu.

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

Sledováno je čtrnáct obchodovatelných instrumentů ve čtyřech třídách aktiv:

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

Tento jediný dotaz vám poskytne kurz liry vůči dolaru a objem zpravodajství tureckých médií za stejné období, rozložený po hodinách. Turecká tiskařská média tvoří třetí největší část tohoto korpusu, což je právě důvod, proč tento pár poskytuje smysluplná data, nikoliv jen šum.

A kompletní blok sentimentu Bitcoinu

Bitcoin získává vlastní rodinu s pěti koncovými body, protože jde o jediný aktivum, kde se neustále diskutuje o vztahu mezi tónem zpráv a pohybem ceny, ale málo se měří:

Označení sentimentu pocházejí z jazykového modelu, který každých pět minut analyzuje čerstvé články o kryptoměnách v kontextu kalibrovaného seznamu mincí. Endpoint /v1/btc/correlation s parametrem max_shift je ten, který byste měli použít, pokud chcete spíše otestovat tvrzení „zpráva způsobuje pohyb“, než ho jen opakovat.

Téžé vyhledávání jako datový kanál

Tři další endpointy přijímají identické parametry vyhledávání a výsledky zobrazují ve formátech pro syndikaci místo ve formátu 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

To znamená, že každé uložené vyhledávání se stane datovým kanálem, který můžete vložit do čtecího programu, uzlu n8n, integrace se Slackem, spouštěče v Zapieru nebo generátoru statických webů — bez psaní kódu i bez nutnosti API klíče. Jde o malou funkci, která tiše odstraní celou integrační vrstvu pro uživatele bez programátorských zkušeností.

MCP: Dvacet osm nástrojů, dvě vrstvy

Server MCP běží na jedné URL, používá protokol Streamable HTTP (JSON-RPC 2.0 přes POST, verze protokolu 2025-06-18), podporuje dávkování a — jako vše ostatní zde — nemá krok ověření ani session id.

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

Používá 28 nástrojů ve dvou promyšlených vrstvách.

První vrstva: šest zkratek, které odpoví na celou otázku jedním voláním

Vrstva dvě: každý endpoint generovaný přímo službou

Pod zkratkami je každý surový endpoint vystaven jako samostatný nástroj se všemi parametry, které API přijímá — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, celou rodinu news_get_btc_*, renderery feedů a news_get_health. Tyto nástroje jsou generovány z živé služby, takže nemohou odchýlit od toho, co API skutečně přijímá.

Dva meta-nástroje uzavírají smyčku: news_list_endpoints vrací katalog všeho, co existuje, a news_get provádí surový GET na libovolné cestě — takže agent, který narazí na endpoint, který jeho seznam nástrojů nepokrývá, se k němu stále může připojit.

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

Jeden GET, žádné vyjednávání, a máte celý strojově čitelný katalog: server, transport, protokol, počet nástrojů, každý nástroj s jeho popisem a každý endpoint se seznamem parametrů.

Navrženo pro čtení stroji

Dokumentace není dodatečným doplňkem přilepeným k API — je jejím plnohodnotným výstupem. Web obsahuje 665 statických stránek a několik z nich existuje právě proto, aby model nikdy nemusel číst HTML:

• /openapi.json Plný schéma OpenAPI.
• /llms.txt Stručný orientační soubor — co služba je, koncové body, jak správně provádět dotazy a chyby.
• /llms-full.txt Celá dokumentace jako jeden prostý textový soubor, přesahující stovky kilobajtů, aby agent mohl načíst celý manuál najednou.
• /agents Třicet devět stránek určených přímo tvůrcům agentů: předpřipravené definice funkcí OpenAI, definice nástrojů pro Anthropic, systémové výzvy pro vyhledávání zpráv, recepty na RAG, tabulky nákladů na tokeny a recepty pro agenty.
• /agents/models Kód pro volání nástrojů podle rodiny modelů — 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 Co je součástí korpusu, metodologie, schéma indexu a stránka s názvem Kvalita dat, která dokumentuje, kde dataset chybuje.
• /sources Procházitelný katalog 11 668 vydavatelů, který lze filtrovat podle země, jazyka a domény.
• /compare Stránky s porovnáním s NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube a FreeNewsAPI.io.

Plus 168 zemí, 121 jazykových stránek a 275 stránek TLD — jedna proklikatelná plocha pro každý dílčí soubor dat, která ukazuje, co v něm skutečně je.

Původ článků

Dvě ingestní civy napájejí stejný index a rozdíl mezi nimi má význam.

Cesta k archivu

Každých deset minut úloha kontroluje archiv CC-NEWS Common Crawl na nové soubory WARC a zpracovává vše, co ještě neviděla, pomocí čtyřiceti paralelních pracovníků. Extraktor vytáhne každý článek z hrubého náhledu pomocí zdokumentované kaskády pro každé pole — a kaskády byly měřeny proti reálným datům, nikoli předpokládány:

Tato země je ta upřímná, a právě proto je country_source vystaveno u každého článku: přibližně pětina záznamů nemá spolehlivý signál o zemi vůbec a přibližně třetina hodnot, které existují, jsou odvozené, nikoliv faktické. API vám prozradí, která hodnota je která, místo aby se předstíralo opak.

Živá cesta

Druhý robot kontroluje kanály RSS vydavatele každých pět minut v rotaci s podmíněnými požadavky – kanál, který vrací 304 Not Modified, stojí téměř nic, a interval pollingování každého kanálu je laděn podle toho, jak často skutečně publikuje. Redakce, která vydává pět článků denně, není namáhána každých patnáct minut.

Také bere pouze to, co vydavatel umístil do kanálu: název, úvod a celý text, pokud ho kanál obsahuje. Nechodí na web vydavatele pro získání dalších informací. To je záměrná hranice a důvod, proč může služba slibovat to, co slibuje na své právní stránce pro vydavatele.

A strojírna kolem nich

Okolo dvou cest příjmu dat stojí dalších tucet robotů v rozvrhu: objevování zdrojů a synchronizace, rozlišení země podle domény, budování trendů a audit, doplňování klíčových slov, sentiment kryptoměn, tahy na trhu, katalog taxonomií, retence (devadesátidenní okno je vynuceno nočním dotazem na published_at, nikoliv stářím indexu), ověřování dne, opakované kontroly prázdných článků a stráž zdraví, která restartuje cokoli, co se zastavilo. Korpus běží na vyhrazeném clusteru Elasticsearch.

Co tento dataset dělá špatně

Služba zveřejňuje své vlastní limity, což je nejrychlejší způsob, jak posoudit, zda odpovídá vašemu problému.

• Země je odvozená Čtěte country_source u každého článku a přidejte strict_country=true, když počítáte podle zemí, nikoliv když procházíte.
• published_at je dodáno vydavatelem Zpětné datování je běžné. Řaďte podle crawled, když kontrolujete, co je nové.
• total je omezeno na 10 000 Pro rychlost. total_is_lower_bound vám řekne, kdy jste narazili na strop.
• Žádný sentiment ani extrakce entit Mimo Bitcoin blok články nemají skóre sentimentu ani jmenné entity. To není v rozsahu.
• Devadesát dní a ne více Archiv není hlubší. Pokud potřebujete data z roku 2019, toto je nesprávný nástroj.
• Bez SLA Je zdarma. Je také monitorováno a střeženo, ale nic není slíbeno písemně.
• Text patří vydavatelům Každá odpověď obsahuje původní URL a uživatelé by měli k ní umisťovat zpětné odkazy.

Jak ji používat efektivně: náklady, stránkování a chyby

Disciplína tokenů

Pro agenta je velikostí odpovědi skutečným nákladem. Dokumentovaný tvar:

Dvacet článků s full_text=true představuje přibližně 40 000 tokenů. Doporučený vzorec je vždy stejný: spočítat, naskenovat a následně načíst těla článků pouze pro ty, které potřebujete.

Posunování se za strop

offset se zastaví na 9 900. Pro procházení velkých sad dat nebojte se stropu — místo toho je rozdělte podle času. Procházejte den po dni nebo hodinu po hodině při náročných dotazech pomocí parametrů from/to a sort=date. Dokumentace obsahuje samostatnou stránku věnovanou procházení celého dne.

Chyby

Smlouva je přímá a snadno použitelná: 4xx znamená, že je požadavek chybný — opravte jej, neprovádějte opakování. 5xx znamená, že služba nefunguje — ustupte. 429 znamená zpomalit a zkusit to znovu. Neznámé parametry dotazu jsou ignorovány místo jejich zamítnutí, takže přidání nového pole nikdy nerozbije existujícího volajícího.

Identifikujte se (Volitelné a skutečně volitelné)

Bez klíče neexistuje způsob, jak volajícího identifikovat. Doporučenou zdvořilostí je hlavička uvádějící jméno vašeho agenta, framework, přes který běží, a model, který jej pohání:

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

Stejné hodnoty lze použít jako běžné parametry dotazu, což je obvykle jednodušší:

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

Neznámé klíče jsou ignorovány, takže odesílání dalších klíčů je vždy bezpečné. Nic není ověřováno, nic není omezeno pro jejich vynechání a jediné přísné pravidlo zní: do těchto polí nikdy nevkládejte osobní údaje koncových uživatelů.

Proti placeným zpravodajství API

Stránky s porovnáním na webu pokrývají jedenáct konkurentů jednotlivě. Strukturní rozdíly, které u všech z nich přetrvávají:

Co vám placené služby stále poskytují a co tato ne: sentimentální skóre a extrakci entit jako standardní pole, archivy sahající roky zpět a smlouvu s garancí SLA. To jsou reálné výhody a pokud je potřebujete, měli byste si je koupit.

Recepty

Živý monitor zemí

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

Je tento příběh globální, nebo domácí?

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

Levné ukotvení modelu v aktuálním pokrytí

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

Vedou ceny pokrytí?

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

Převést uložené vyhledávání na kanál

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

Najděte vydavatele, kteří mají ve trhu význam

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

Stručný přehled

Free News API je vyhledávání v plném textu přes 21,5 milionu zpravodajských článků od více než 25 000 vydavatelů ve 100 zemích a přibližně 100 jazycích, s posuvným oknem 90 dnů, průběžně aktualizováno, bez klíče, bez registrace a bez kvóty s výjimkou omezení rychlosti na základě IP adresy. Nad vyhledáváním pak běží živé seskupování příběhů podle jednotlivých zemí pro 115 zemí, analýza klíčových slov, která rozlišuje světové události od domácích, čtrnáct obchodních nástrojů vykreslených proti objemu pokrytí, sedmibodový blok sentimentu Bitcoinu, syndikace RSS/Atom/JSON pro libovolný dotaz a server MCP s 28 nástroji generovaný přímo z této služby.

Dokumentuje vlastní míru chyb, zveřejňuje, jak byly odvozeny jednotlivé hodnoty zemí, a publikuje stránku s informacemi o tom, kde data selhávají. Pro agenta, který potřebuje vědět, co se ve světě děje — v turečtině, v řečtině, v hindštině, právě teď — je tato kombinace obtížně dostupná za jakoukoli cenu, a tato je zdarma.

Vyhledávání používá logické AND pro všechny výrazy. Použijte 2–5 klíčových slov, nikoli otázku v přirozeném jazyce.

Free News API, jak správně zadávat dotazy

Začněte zde: freenewsapi.ai · MCP na freenewsapi.ai/mcp · celý manuál jako jeden soubor na /llms-full.txt.