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.
Š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.
| Endpoint | Na čo odpovedá |
|---|---|
GET /v1/search | Fulltextové vyhľadávanie s filtrami. Endpoint, ktorý budeš používať 95 % času. |
GET /v1/stats | Zhrnuté počty pre ľubovoľný úsek — podľa krajiny, jazyka, TLD, vydavateľa a dňa. |
GET /v1/article | Jeden č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
- q Zosúladené s titulkom (váha 3), popisom (váha 2) a telom článku. Logické AND — každý výraz musí byť prítomný, takže pridaním slova sa vyhľadávanie zužuje, nie rozširuje. Maximálne 500 znakov.
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.
| Filter | Formát | Poznámky |
|---|---|---|
country | ISO 3166-1 alpha-2, veľké písmená | Krajina vydávateľa. Odvodené, nie deklarované — pozri country_source a strict_country. |
lang | ISO 639-1, malé písmená | Zistené priamo z dokumentu. Pokrytie 99,9 %. |
tld | bez bodky | Doménová zóna vydávateľa. tld=ua je skutočnosť; country=UA je odhad. |
host | presné názvy hostiteľov | Tak, ako sa vyskytujú v URL — zahrňte www., ak ho vydávateľ používa. |
date | dnes · včera · 24 h · 48 h · 7 dní · 30 dní | Prednastavené obdobie, vyhodnocované voči published_at. |
from / to | Dátumy vo formáte ISO | Explicitné okno, keď prednastavenia nevyhovujú. |
strict_country | true/false | Započítavajte iba články, ktorých krajina je tvrdým faktom, a nie iba odhadom. |
Ovládanie výstupu
| Parameter | Hodnoty | Účinok |
|---|---|---|
sort | date · date_asc · crawled · crawled_asc · relevance | Zoraď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. |
size | 1–100 | Počet výsledkov na stránku. |
offset | 0–9900 | Posun stránkovania. |
full_text | true/false | Zahrnúť telo článku. Predvolene je vypnuté. |
highlight | true/false | Vrátiť zhodné úryvky. |
fields | CSV | Obmedzte 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 |
|---|---|
| India | 2,286,014 |
| Spojené štáty | 2,180,797 |
| Turecko | 1,499,897 |
| Rusko | 1,436,556 |
| Taliansko | 1,057,479 |
| Argentína | 826,947 |
| Španielsko | 812,347 |
| Ukrajina | 662,041 |
| Brazília | 551,013 |
| Nemecko | 543,132 |
| Francúzsko | 502,846 |
| Grécko | 460,372 |
| Japonsko | 437,209 |
| Vietnam | 408,934 |
| Mexiko | 402,320 |
| Južná Kórea | 362,945 |
| Rumunsko | 354,229 |
| Spojené kráľovstvo | 334,379 |
| Irán | 291,782 |
| Poľsko | 255,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:
| Trieda | Inštrumenty | Zrno | Zdroj |
|---|---|---|---|
| Krypto | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | hodina | Binance |
| Kovy | Zlato (USD/oz) | hodina | Binance |
| Forex | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | deň | EBC |
| Energia | Nemecká cena elektriny (EUR/MWh) | hodina | Energy-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ý:
| Endpoint | Vrátené údaje |
|---|---|
/v1/btc/summary | Aktuálna cena, nedávne pohyby a tón dnešného pokrytia. |
/v1/btc/price | Kandele BTC/USDT podľa intervalu. |
/v1/btc/sentiment | Tón správ podľa obdobia. |
/v1/btc/series | Cena a tón zarovnané na jednej časovej osi. |
/v1/btc/correlation | Korelá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/sources | Ktoré 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:
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=dateTo 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/mcpVystavuje 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ástroj | Pre |
|---|---|
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_keywords | Slová, na ktorých sú aktuálne správy postavené, s počtom príbehov a rozložením podľa krajín. |
find_publishers | Vyhľadanie médií: názov, doména, krajina, jazyk, počet článkov za deň. |
list_countries | Ktoré krajiny majú živé príbehy, koľko ich je a aké sú čerstvé. |
market_vs_news | Cenová 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:
- /openapi.json Úplný schém OpenAPI.
- /llms.txt Stručný orientačný súbor — čo služba je, endpointy, ako ju dobre využiť a možné chyby.
- /llms-full.txt Celá dokumentácia ako jeden čistý textový súbor, s veľkosťou presahujúcou sto kilobajtov, aby agent mohol stiahnuť celý manuál naraz.
- /agents Tridsaťdeväť strán určených priamo tvorcom agentov: pripravené definície funkcií OpenAI, definície nástrojov Anthropic, systémové výzvy na vyhľadávanie správ, recepty na RAG, tabuľky nákladov na tokeny a recepty na agentov.
- /agents/models Kód na volanie nástrojov pre jednotlivé rodiny modelov — 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 Čo obsahuje korpus, metodológia, schéma indexu a stránka s názvom Kvalita dát, ktorá dokumentuje, kde sú dáta chybné.
- /sources Prehľadný katalóg 11 668 vydavateľov, ktorý možno filtrovať podľa krajiny, jazyka a domény.
- /compare Stránky s porovnaním vedľa seba so službami NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube a FreeNewsAPI.io.
Ď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é:
| Pole | Kaskáda | Pokrytie |
|---|---|---|
| popis | JSON-LD → meta → OpenGraph → Twitter karta → articleBody → úvodný odsek | 98.1% |
| jazyk | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| krajina | ccTLD → JSON-LD addressCountry → jazyk-región → og:locale | 79.1% |
| dátum | JSON-LD datePublished → meta → trafilatura → čas crawlu | 100% |
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.
- Krajina je odvodená Vždy čítajte pole
country_sourcea pridajtestrict_country=true, keď počítate podľa krajiny, nie keď len prehliadate dáta. published_atje dodané vydavateľom Dátumovanie späť je bežné. Pri kontrole nových článkov zoraďte podľa poľacrawled.- Hodnota
totalje obmedzená na 10 000 Pre rýchlosť. Poletotal_is_lower_boundvám povie, kedy ste dosiahli strop. - Žiadny sentiment ani extrakcia entít Mimo bitcoinových blokov články neobsahujú skóre sentimentu ani menovité entity. To nie je súčasťou rozsahu služieb.
- Deväťdesiat dní a nie viac Hlbšie archívy nie sú k dispozícii. Ak potrebujete dáta z roku 2019, toto nie je správny nástroj.
- Bez SLA Je to zadarmo. Je tiež monitorované a chránené, ale nič nie je sľúbené písomne.
- Text patrí vydavateľom Každá odpoveď obsahuje pôvodný URL a volajúci sú povinní k nemu vytvoriť spätný odkaz.
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:
| Volanie | Približná nákladovosť tokenov | Kedy |
|---|---|---|
/v1/stats | ~200 | Najprv. Rozhodnite sa, či sa vyhľadávaní oplatí spustiť vôbec. |
/v1/search len metadáta | niekoľko tisíc na stránku | Skenovať a vybrať. |
/v1/search?full_text=true | ~900 na článok | Iba 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-4oNezná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:
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
Ž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
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
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 eventLacné 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=50Ná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 sliceStruč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.