Spravodajské APIy sa zvyčajne predávajú na základe požiadavky, sú ukryté za kľúčom a v bezplatnej úrovni sú obmedzené na sto volaní denne. Free News API je presný opak: 21,5 milióna článkov v rámci 90-dňového posuvného okna, viac ako 25 000 vydavateľov, žiadny kľúč, žiadna registrácia, žiadne kvóty, povolené komerčné použitie. Tu je celý rozsahu služieb — vyhľadávanie, štatistiky, trendy, trhy, kanály a MCP — a úprimný pohľad na to, kde dáta klamú.

Podoba problému

Opýtajte sa AI agenta, o čom sa práve píše vo svete, a má na výber tri zlé možnosti. Môže ťahať dáta priamo z vydavateľstiev, čo je krehké, pomalé a právne nejasné. Môže zavolať komerčné spravodajské API, čo znamená účet, kľúč, mesačný poplatok a — v kažnej bezplatnej úrovni na trhu — sto požiadaviek denne a články oneskorené o dvadsaťštyri hodín. Alebo môže hádať na základe dát z výcviku, ktoré zastarali pred niekoľkými mesiacmi.

Free News API odstraňuje cenu a administratívu strednej možnosti bez toho, aby obmedzilo jej možnosti. Jedna GET požiadavka, žiadne poverenia, nad korpustom, ktorý v čase písania tohto článku obsahuje 21 557 044 článkov od viac ako dvadsiatichpäťtisíca vydavateľov, uložených v 90-dňovom posuvnom okne a neustále aktualizovaných — najnovší článok v indexe je zvyčajne starý menej ako dve minúty.

21,5 mil.
článkov v indexe
25,000+
vydavateľov
100
krajín
~100
jazykov
90 dní
posuvné okno
0
API kľúčov v existencii
Pravidlo: Neexistuje žiadny API kľúč a ani nebude. Neexistuje preň žiadny parameter, nie je potrebné odosielať žiadnu hlavičku, nie je potrebné zakladať účet ani čerpať kvótu požiadaviek — existuje iba limit rýchlosti na základe IP adresy, ktorý umožňuje 20 požiadaviek za sekundu, takže jeden volajúci nemôže odstaviť službu pre všetkých ostatných.

Štyri základné endpointy a ešte niečo navyše

Jadrom služby sú štyri GET endpointy, všetky pod https://freenewsapi.ai, všetky vracajúce UTF-8 JSON s hlavičkou Access-Control-Allow-Origin: *, aby si ich mohol browser volať priamo, a všetky reportujú čas na serveri v poli took_ms.

EndpointNa čo odpovedá
GET /v1/searchFulltextové vyhľadávanie s filtrami. Endpoint, ktorý budeš používať 95 % času.
GET /v1/statsZhrnuté počty pre ľubovoľný úsek — podľa krajiny, jazyka, TLD, vydavateľa a dňa.
GET /v1/articleJeden článok s presnou hodnotou URL, vrátane celého textu.
GET /healthŽivotosť spolu s aktuálnym počtom dokumentov. Lacné na to, aby sa dalo pravidelne volať.

Okolo toho jadra sa nachádzajú štyri ďalšie rodiny, z ktorých by každá bola samostatným produktom inde: trendy (klasterizácia živých príbehov podľa krajiny), trhy (cenové série zarovnané podľa objemu pokrytia), sentiment kryptomien (sedembodová bitcoinová bloková štruktúra) a syndikácia (ten istý vyhľadávací výsledok zobrazený ako RSS, Atom alebo JSON Feed). Všetky z nich sú podrobnejšie popísané nižšie.

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

Tri polia v tejto odpovedi si zaslúžia okamžitú pozornosť, pretože kódujú úprimnosť celého datasetu. total_is_lower_bound vám povie, kedy počet zhôd dosiahol strop 10 000 a prestal počítať. country_source vám povie, ako bola krajina určená — pretože v akomkoľvek datasete správ veľká časť hodôt krajín je inferenciou, nie faktom. A crawled_at je dôveryhodné časové razítko: vydavatelia často predladujú published_at, ale čas crawlu je priradený pipeline a vždy sa posúva len vpred.

Vyhľadávanie: Každý parameter, na ktorom záleží

Všetky parametre sú voliteľné. Čistý volací príkaz vráti najnovšie články v indexe.

Zadanie dotazu

Pýtajte sa ako vyhľadávací engine, nie ako chatbot: Toto je najčastejšia chyba. Vyhľadávanie je logické AND medzi všetkými výrazmi, preto píšte 2–5 kľúčových slov, nie vetu. opec production cut funguje. what did OPEC decide about oil vráti nič.

Filtre

Filtre sa kombinujú s logickým AND medzi parametrami a logickým OR v rámci jedného parametra. Takže country=DE,AT&lang=de sa číta ako „články v nemčine z Nemecka alebo Rakúska“. Každý akceptuje zoznam hodôt oddelených čiarkou, maximálne päťdesť hodôt.

FilterFormátPoznámky
countryISO 3166-1 alpha-2, veľké písmenáKrajina vydávateľa. Odvodené, nie deklarované — pozri country_source a strict_country.
langISO 639-1, malé písmenáZistené priamo z dokumentu. Pokrytie 99,9 %.
tldbez bodkyDoménová zóna vydávateľa. tld=ua je skutočnosť; country=UA je odhad.
hostpresné názvy hostiteľovTak, ako sa vyskytujú v URL — zahrňte www., ak ho vydávateľ používa.
datednes · včera · 24 h · 48 h · 7 dní · 30 dníPrednastavené obdobie, vyhodnocované voči published_at.
from / toDátumy vo formáte ISOExplicitné okno, keď prednastavenia nevyhovujú.
strict_countrytrue/falseZapočítavajte iba články, ktorých krajina je tvrdým faktom, a nie iba odhadom.

Ovládanie výstupu

ParameterHodnotyÚčinok
sortdate · date_asc · crawled · crawled_asc · relevanceZoraďte podľa crawled pri sledovaní nových článkov — vydavatelia často posúvajú dátumy publikovania späť; čas získania sa pohybuje len dopredu.
size1–100Počet výsledkov na stránku.
offset0–9900Posun stránkovania.
full_texttrue/falseZahrnúť telo článku. Predvolene je vypnuté.
highlighttrue/falseVrátiť zhodné úryvky.
fieldsCSVObmedzte odpoveď na polia, ktoré skutočne používate.
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čítanie pred vyhľadávaním

Najmenej využívaným koncovým bodom v službe je /v1/stats. Často je dôležitejšou otázkou nie to, aké články existujú, ale či tam vôčo je a kde sa nachádza. Počítanie odpovedí stojí zlomok nákladov — približne dve stovky tokenov oproti niekoľkým tisícom za stránku výsledkov — čo z neho robí správny prvý krok pre agenta, ktorý sa rozhoduje, či sa vyhľadávaní oplatí spustiť.

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

Vracia počty podľa krajiny, jazyka, TLD, vydavateľa a dňa, vypočítané pre celý zhodujúci sa súbor, nie len pre aktuálnu stránku. To je tiež spôsob, ako zmerať pokrytie, kým dôverujete výsledkom. Ne filtrovaný snímok v čase písania:

Najlepšie krajiny

KrajinaČlánky
India2,286,014
Spojené štáty2,180,797
Turecko1,499,897
Rusko1,436,556
Taliansko1,057,479
Argentína826,947
Španielsko812,347
Ukrajina662,041
Brazília551,013
Nemecko543,132
Francúzsko502,846
Grécko460,372
Japonsko437,209
Vietnam408,934
Mexiko402,320
Južná Kórea362,945
Rumunsko354,229
Spojené kráľovstvo334,379
Irán291,782
Poľsko255,599

Najpoužívanejšie jazyky

angličtina 5 513 650 · španielčina 2 699 457 · ruština 1 785 796 · turečtina 1 501 004 · taliančina 992 200 · nemčina 733 677 · francúzština 689 136 · arabčina 664 016 · portugalčina 637 607 · hindčina 560 840 · gréčtina 466 504 · japončina 427 085 · vietnamčina 385 719 · rumunčina 358 766 · čínština 352 720 · ukrajinčina 345 809 · kórejčina 335 079 · perzština 268 126 · poľština 238 904 · bulharčina 183 204.

Toto rozdelenie stojí za to si na chvíľu prezrieť, pretože je presným opakom toho, čo vám väčšina spravodajských API poskytuje. Zvyčajný anglicko-americký, USA-first korpus nie je tým, čo toto je: India predčí Spojené štáty, turečtina predčí nemčinu a gréčtina, vietnamčina, perzština a bulharčina majú všetky šesťmiestne zastúpenie. Ak sa pýtate na neanglickú tlač, ide o materiálne odlišnú dátovú sadu.

Objem

Denná krivka v by_day pokrýva celé deväťdesťdňové okno. Nedávne dni sa pohybujú v rozmedzí približne 400 000 až 700 000 článkov denne; v staršej časti okna, pred pridaním vrstvy RSS spolu s ingestom archívu, bol denný objem 130 000 – 230 000. Obe čísla sú viditeľné v rovnakej odpovedi, čo je podstatou — služba vám ukazuje vlastné nárastové fázy, nie uvádza marketingový priemer.

Trendy: Čo tlač aktuálne skutočne pokrýva

Vyhľadávanie odpovedá na otázku „čo bolo napísané o X“. Trendy odpovedajú na inú a často lepšiu otázku: „čo sa práve deje“ — bez potreby X.

Robot zhlukuje články do príbehov podľa krajín a udržiava ich aktuálne. Každých päť minút sa nové články pripájajú k známym príbehom pomocou ich identifikujúcich slov, a to úplne bez volania modelu; každých pár hodín prejde jedna krajina úplným cyklom, kde jazykový model prečíta nadpisy a od začiatku vymyslí názvy príbehov. V čase písania vrstva trendov pokrýva 115 krajín, každá prepočítaná v posledných pár minútach.

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

K každému príbehu patria dva počty a znamenajú odlišné veci. articles je hlasitosť; publishers je šírka. Príbeh so 200 článkami zo 4 vydavateľstvami je obsesiou jednej redakcie. Príbeh so 60 článkami zo 40 vydavateľstvami je udalosťou. Predvolené triedenie je podľa vydavateľstiev a min_publishers / min_articles vám umožňujú nastaviť si vlastnú hranicu.

Príbehy nesú kategóriu z pevného zoznamu: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

Okno je na výbere čitateľa, nie robota

Toto je skutočne elegantné dizajnové rozhodnutie. Každý článok je uložený spolu s časom publikovania a priradený k príbehu, takže akékoľvek okno — pätnásť minút, hodina, deň, konkrétny kalendárny dátum — je len rozsahovým dotazom na rovnaké uložené dáta. Jeden výpočet obsluží všetky okná naraz. window=15m, window=1h, window=24h, date=2026-09-01 alebo explicitný pár since/until fungujú proti rovnakému indexu bez potreby ďalšieho výpočtu.

Kľúčové slová: slová, na ktorých sú správy postavené

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

Každé kľúčové slovo sa vracia spolu s počtom rôznych príbehov, ktoré ho obsahujú, počtom článkov, ktoré tieto príbehy majú, a — to zaujímavé — kým koľko národných tlačí ho používajú. Táto posledná hodnota rozlišuje globálnu udalosť od vnútroštátnej. Slovo, ktoré sa vyskytuje v siedmich desiatkach krajín, je svetovým príbehom; slovo, ktoré dominuje tlači v jednej krajine, je vnútroštátnym príbehom, hoci je tam veľmi hlasno.

Ktoré krajiny sú aktívne

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

Vracia všetky sledované krajiny s počtom aktívnych príbehov a počtom minút, ktoré uplynuli od poslednej prepočtu — Turecko, Rusko, Irán, Grécko, India, Taliansko, Ukrajina, Rumunsko, Argentína, Nemecko a Brazília majú aktuálne tisíce aktívnych príbehov, ktoré boli prepočítané v posledných desiatich minútach. A /v1/trends/{cc}/{slug} otvorí ľubovoľný jednotlivý príbeh s jeho úplným zoznamom článkov.

Trhy vs. pokrytie: Cena na jednej osi, pozornosť na druhej

Toto je najzaujímavejšia časť služby a existuje preto, že korpus ju robí takmer zadarmo na vytvorenie. Umiestnite rad cien vedľa toho, koľko sveta o tom v rovnakých hodinách písal, na jednom časovom rade.

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

Sledovaných je štrnásť inštrumentov naprieč štyr triedami aktív:

TriedaInštrumentyZrnoZdroj
KryptoBitcoin, Ethereum, Solana, XRP, BNB, DogecoinhodinaBinance
KovyZlato (USD/oz)hodinaBinance
ForexEUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLNdeňEBC
EnergiaNemecká cena elektriny (EUR/MWh)hodinaEnergy-Charts
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

Tento jediný volací bod vám poskytuje kurz liry voči doláru a objem pokrytia tureckými médiami za rovnaké obdobie, zaradený po hodinách. Tlač v Turecku tvorí tretí najväčší diel tejto koreňovej databázy, čo je presne dôvod, prečo tento pár poskytuje zmysluplné výsledky namiesto šumu.

A kompletný blok sentimentu Bitcoinu

Bitcoin získava vlastnú rodinu siedmich endpointov, pretože je to jediný nástroj, pri ktorom sa neustále diskutuje o vzťahu medzi tónom správ a pohybom ceny, pričom tento vzťah je zriedka meraný:

EndpointVrátené údaje
/v1/btc/summaryAktuálna cena, nedávne pohyby a tón dnešného pokrytia.
/v1/btc/priceKandele BTC/USDT podľa intervalu.
/v1/btc/sentimentTón správ podľa obdobia.
/v1/btc/seriesCena a tón zarovnané na jednej časovej osi.
/v1/btc/correlationKorelácia medzi tónom a pohybom ceny podľa časového posunu — či pokrytie predchádza pohybu ceny, alebo ho nasleduje?
/v1/btc/newsČlánky o kryptomenách s ich štítkom sentimentu, filtrovateľné podľa štítku, hostiteľa, jazyka a dotazu.
/v1/btc/sourcesKtoré médiá pokrývajú kryptomeny a aký smer sa v nich preferuje.

Štítky sentimentu pochádzajú z jazykového modelu, ktorý prechádza čerstvými článkami o kryptomenách každých päť minút na základe kalibrovaného zoznamu mincí. Endpoint /v1/btc/correlation s parametrom max_shift je ten správny, ak ste kedy chceli otestovať tvrdenie, že „správa spôsobuje pohyb“, namiesto toho, aby ste ho len opakovali.

Ten istý vyhľadávací dotaz ako feed

Tri ďalšie endpointy prijímajú rovnaké parametre vyhľadávania a výsledky zobrazujú v formátoch syndikácie namiesto JSON:

https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=date

To znamená, že každé uložené vyhľadávanie sa stane feedom, ktorý môžete vložiť do čítačky, uzla n8n, integrácie Slack, spúšťača Zapier alebo generátora statických stránok — bez kódu aj bez API kľúča. Je to malá funkcia, ktorá ticho odstráni celú vrstvu integrácie pre neprogramátorov.

MCP: Dvadsaťosem nástrojov, dve vrstvy

Server MCP beží na jednej URL, podporuje Streamable HTTP (JSON-RPC 2.0 cez POST, verzia protokolu 2025-06-18), podporuje dávkovanie a — ako všetko ostatné v tomto systéme — nemá krok overenia ani session ID.

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

Vystavuje 28 nástrojov v dvoch zámerne oddelených vrstvách.

Vrstva jedna: šesť skratiek, ktoré odpovedia na celú otázku v jednom volaní

NástrojPre
search_news"Čo sa písalo o X" — full-textové vyhľadávanie, skrátený výsledok.
get_trends"Čo sa deje" — zoskupené príbehy namiesto zoznamu článkov.
trend_keywordsSlová, na ktorých sú aktuálne správy postavené, s počtom príbehov a rozložením podľa krajín.
find_publishersVyhľadanie médií: názov, doména, krajina, jazyk, počet článkov za deň.
list_countriesKtoré krajiny majú živé príbehy, koľko ich je a aké sú čerstvé.
market_vs_newsCenová séria vedľa objemu pokrytia. Volajte bez inštrumentu a zobrazíte, čo existuje.

Vrstva dva: každý endpoint, generovaný priamo zo služby

Pod skratkami je každý surový endpoint vystavený ako samostatný nástroj so všetkými parametrami, ktoré API akceptuje — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, celá rodina news_get_btc_*, renderovače kanálov a news_get_health. Tieto endpointy sú generované z live služby, takže sa nemôžu líšiť od toho, čo API skutočne akceptuje.

Dva metanástroje uzatvárajú slučku: news_list_endpoints vracia katalóg všetkého, čo existuje, a news_get vykonáva surové GET na akejkoľvek ceste — takže agent, ktorý narazí na endpoint, ktorý jeho zoznam nástrojov nepokrýva, ho môže stále dosiahnuť.

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

Jedno GET, žiadne rukovanie a máte celý strojovo čitateľný katalóg: server, transport, protokol, počet nástrojov, každý nástroj s jeho popisom a každý endpoint so zoznamom parametrov.

Navrhované na čítanie strojmi

Dokumentácia nie je postrádaným doplnkom pripnutým k API — je to plnohodnotný výstup služby. Stránka obsahuje 665 statických stránok a niekoľkých z nich existuje špeciálne preto, aby ich model nemusel čítať ako HTML:

Ďalších 168 krajín, 121 jazykových stránok a 275 stránok TLD — jeden prehľadný rozhranie pre každý úsek korpusu, ktorý zobrazuje, čo je v ňom skutočne obsiahnuté.

Odkiaľ pochádzajú články

Dve cesty ingestácie napájajú rovnaký index a rozdiel medzi nimi má význam.

Archívna cesta

Každých desať minút kontroluje úloha archív CC-NEWS Common Crawl-u na nové súbory WARC a spracováva všetko, čo ešte nevidel, pomocou štyridsiatich paralelných pracovníkov. Extraktor vyberá každý článok z hrubého crawlu s dokumentovaným kaskádovým spracovaním pre každé pole — a kaskády boli merané na skutočných dátach, nie predpokladané:

PoleKaskádaPokrytie
popisJSON-LD → meta → OpenGraph → Twitter karta → articleBody → úvodný odsek98.1%
jazyk<html lang> → JSON-LD inLanguage → og:locale99.9%
krajinaccTLD → JSON-LD addressCountry → jazyk-región → og:locale79.1%
dátumJSON-LD datePublished → meta → trafilatura → čas crawlu100%

Toto je úprimný prístup k údajom o krajine a práve preto je pole country_source dostupné v každom článku: približne pätina záznamov nemá spoľahlivý signál o krajine a približne tretina existujúcich hodnôt sú odvodené (inferencie), nie overené fakty. API vám presne ukáže, ktorá hodnota je ktorá, namiesto toho, aby si to len domýšľalo.

Živý dátový kanál

Druhý robot pravidelne každých päť minút kontroluje kanály RSS vydavateľov v rotácii s podmienenými požiadavkami — kanál, ktorý vracia kód 304 Not Modified, stojí takmer nič, a interval kontroly každého kanála je prispôsobený tomu, ako často daný vydavateľ skutočne publikuje nové články. Redakcia, ktorá zverejní päť príbehov denne, nie je ťahaná každých desaťpäť minút.

Spracováva iba to, čo vydavateľ umiestnil do kanála: nadpis, úvod a úplný text, ak ho kanál obsahuje. Nechodí na web vydavateľa, aby zistil viac. Toto je zámerne stanovená hranica a práve preto služba môže poskytnúť záväzné sľuby uvedené na svojej právnej stránke pre vydavateľov.

A mechanizmy okolo nich

Okolo dvoch vstupných ciest beží ďalších tucet robotov podľa harmonogramu: objavovanie zdrojov a synchronizácia, určovanie krajiny pre domény, budovanie trendov a audit, dopĺňanie kľúčových slov, analýza sentimentu kryptomien, získavanie tržných dát, katalóg taxonómií, správa retencie (deväťdesiatdňové okno je vynucované nočným dotazom na pole published_at, nie vekom indexu), overovanie dát, opätovné kontroly prázdnych článkov a ochranný mechanizmus, ktorý reštartuje všetko, čo sa zastavilo. Korpus je uložený na špeciálnom klastri Elasticsearch.

Čo tento dataset zisťuje nesprávne

Služba uvádza svoje vlastné obmedzenia, čo je najrýchlejší spôsob, ako posúdiť, či vyhovuje vášmu problému.

Správne využívanie: náklady, stránkovanie a chyby

Disciplína tokenov

Pre agenta je veľkosť odpovede skutočnou nákladovou položkou. Dokumentovaný rozsah je:

VolaniePribližná nákladovosť tokenovKedy
/v1/stats~200Najprv. Rozhodnite sa, či sa vyhľadávaní oplatí spustiť vôbec.
/v1/search len metadátaniekoľko tisíc na stránkuSkenovať a vybrať.
/v1/search?full_text=true~900 na článokIba pre tú malú skupinu, ktorú ste skutočne vybrali.

Dvainásť článkov s full_text=true predstavuje približne 40 000 tokenov. Odporúčaný postup je vždy rovnaký: spočítať, preskenovať a následne načítať texty len pre tie, ktoré potrebujete.

Prechádzanie za limitom stránkovania

offset sa zastaví na hodnote 9 900. Pri prechádzaní veľkých množstiev dát sa nesnažte poraziť tento limit — namiesto toho údaje rozdeľte podľa času. Prechádzajte ich deň po dni alebo hodinu po hodine pri náročných dotazoch, pomocou parametrov from/to a sort=date. Dokumentácia obsahuje samostatnú stránku venovanú prechádzaniu celého dňa.

Chyby

Zmluvné pravidlá sú jasné a ľahko použiteľné pri kódovaní: 4xx znamená, že je chyba v požiadavke — opravte ju a neskúšajte ju znova. 5xx znamená, že je služba nedostupná — počkajte a skúste to znova. 429 znamená spomaliť a skúsiť to znova. Neznáme parametry sú ignorované, nie odmietnuté, takže pridaním nového poľa nikdy nedôjde k porušeniu funkčnosti existujúcich klientov.

Identifikujte sa (voliteľné a skutočne voliteľné)

Bez kľúča nie je možné identifikovať volajúceho klienta. Odporúčanou zdvorilosťou je odoslať hlavičku, ktorá obsahuje názov vášho agenta, framework, v ktorom beží, a model, ktorý ho poháňa:

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

Tieto isté hodnoty možno použiť aj ako bežné parametre URL, čo je zvyčajne jednoduchšie:

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

Neznáme kľúče sú ignorované, takže odoslanie ďalších kľúčov je vždy bezpečné. Nič nie je validované ani obmedzované kvôli ich vynechaniu a jedno pravidlo je pevné: do týchto polí nikdy nevkladajte osobné údaje koncových používateľov.

Proti plateným správam API

Porovnávacie stránky na webe podrobne analyzujú jedenásť konkurentov. Štrukturálne rozdiely, ktoré pretrvávajú naprieč všetkými:

Bezplatné tarify u iných poskytovateľov

100 požiadaviek za deň, 24-hodinové oneskorenie

Štandardná podoba bezplatnej news-API tarify: tokenový vedierko dostatočne malé na ukážku, so čerstvými článkami vyhradenými pre platiacich zákazníkov.

  • Vyžaduje sa API kľúč
  • Denný limit
  • Oneskorené články
  • Len nekomerčné použitie
Free News API

Žiadny limit, žiadne oneskorenie, žiadny kľúč

Jediným obmedzením je 20 požiadaviek za sekundu na IP adresu. Najnovší článok je zvyčajne starý menej ako dve minúty a komerčné použitie je povolené.

  • Žiadny kľúč, žiadna registrácia
  • Žiadny denný ani mesačný limit
  • Nepretržité obnovovanie
  • Povolené komerčné použitie
Pokrytie u iných poskytovateľov

Prevažne angličtina, USA

Väčšina korpusov je zostavená zo zoznamu anglickojazyčných vydavateľov, ku ktorým je pripojený zvyšok sveta.

  • Prevládanie angličtiny
  • Chudobné pokrytie jazykov používajúcich nelatinkové písmo
Pokrytie tu

India > USA, turečtina > nemčina

Okolo 100 jazykov s objemami v šesťcifernom rozsahu v gréčtine, vietnamčine, perzštine, ukrajinčine a bulharčine.

  • 100 krajín
  • ~100 jazykov
  • 11 668 katalógových zdrojov

Čo vám stále poskytujú platené služby, čo toto nie: štandardné polia pre skóre sentimentu a extrakciu entít, archivy siahaajúce roky späť a zmluva so zárukou SLA. To sú skutočné výhody a ak ich potrebujete, mali byste si ich kúpiť.

Recepty

Živý monitor krajín

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

Je tento príbeh globálny alebo domáci?

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

Lacné zakotvenie modelu v dnešnom 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"

Vedie pokrytie cenu?

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

Premeniť uložené vyhľadávanie na feed

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

Nájdite vydavateľov, ktorí majú v danom 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ý prehľad

Free News API je plnotextové vyhľadávanie cez 21,5 milióna spravodajských článkov od viac ako 25 000 vydavateľov z 100 krajín a približne 100 jazykov, s posuvným oknom 90 dní, ktoré sa neustále obnovuje, bez API kľúča, bez registrácie a bez kvóty okrem obmedzenia rýchlosti na základe IP adresy. Nad týmto vyhľadávaním sa nachádzajú živé zhluky príbehov podľa krajín pre 115 krajín, analýza kľúčových slov, ktorá oddeľuje svetové udalosti od domácich, štrnásť obchodných nástrojov vykreslených vo vzťahu k objemu pokrytia, blok sentimentu bitcoinu s siedmimi endpointmi, syndikácia RSS/Atom/JSON pre ľubovoľný dopyt a 28nástrojový server MCP generovaný priamo zo služby.

Dokumentuje vlastné miery chýb, zverejňuje, ako bola odvodená každá hodnota pre jednotlivé krajiny, a publikuje stránku o tom, kde dáta klamú. Pre agenta, ktorý potrebuje vedieť, čo sa deje vo svete — v turečine, v gréčtine, v hindčine, práve teraz — je táto kombinácia ťažko dostupná za akúkoľvek cenu, a táto je zadarmo.

Vyhľadávanie používa logický AND pre všetky výrazy. Použite 2–5 kľúčových slov, nie otázku v prirodzenom jazyku.

Free News API, ako ho dobre využiť

Začnite tu: freenewsapi.ai · MCP na freenewsapi.ai/mcp · celý manuál ako jeden súbor na /llms-full.txt.