A hírek API-ját általában kérelemnként értékesítik, kulcs mögé rejtik, és a ingyenes csomagban napi száz hívásra korlátozzák. A Free News API egyik sem ezek közül: 21,5 millió cikk egy 90 napos mozgó ablakban, 25 000+ kiadó, kulcs nélkül, regisztráció nélkül, kvóta nélkül, kereskedelmi felhasználás megengedett. Íme az összes funkció — keresés, statisztikák, trendek, piacok, hírfolyamok és MCP — valamint egy őszinte áttekintés arról, hol tévednek az adatok.
A probléma természete
Kérdezd meg egy AI ügynököt, hogy miről szólnak éppen a világ hírei, és három rossz opció közül választhat. Közvetlenül másolhatja a kiadókat, ami törékeny, lassú és jogilag bizonytalan. Felhívhat egy kereskedelmi hír API-ot, amihez fiók, kulcs, havi számla és — a piac összes ingyenes csomagjában — napi száz kérés és huszonnégy órával késleltetett cikkek tartoznak. Vagy megpróbálhat találgatni a hónapokkal ezelőtt leállt tanítási adatok alapján.
A Free News API megszünteti a köztes opció árát és papírmunkáját anélkül, hogy csökkentené a képességeit. Egyetlen GET kérés, hitelesítő adatok nélkül, egy olyan adatbázis felett, amely írás közben 21 557 044 cikket tartalmaz több mint huszonötezer kiadótól, egy 90 napos mozgó ablakban, folyamatosan frissítve — az indexben lévő legújabb cikk általában mindössze két perccel ezelőtt készült.
Négy alapvető végpont, és még sok más
A szolgáltatás magját négy GET végpont alkotja, mindegyik a https://freenewsapi.ai címen érhető el, mindegyik UTF-8 JSON formátumban ad vissza választ Access-Control-Allow-Origin: * fejléccel, így a böngésző kód közvetlenül hívhatja őket, és mindegyik a took_ms mezőben jelzi a kiszolgáló oldali futási időt.
| Végpont | Mire válaszol |
|---|---|
GET /v1/search | Teljes szövegű keresés szűrőkkel. Ez a végpont, amelyet az esetek 95%-ában használunk. |
GET /v1/stats | Összesített számok bármely szelektre — ország, nyelv, TLD, kiadó és nap szerint bontva. |
GET /v1/article | Egy cikk pontosan a(z) URL alapján, a teljes szövegtartalommal együtt. |
GET /health | Liveness és a jelenlegi dokumentumszám. Elég olcsó a rendszeres lekérdezéshez. |
Ez körülött négy további csoporthelyezkedik el, amelyek mindegyike külön termék lenne máshol: trendek (élő hírcsoportosítás országok szerint), piacok (árfolyamsorozatok a lefedettségi volumenhez igazítva), kriptó hangulat (egy hét végpontú Bitcoin blokk), és szindikáció (ugyanaz a keresés, mint RSS, Atom vagy JSON hírfolyam). Mindegyikről alább részletesen olvashattok.
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"
}
]
}A válaszban három mező azonnali figyelmet érdemel, mert a teljes adathalmaz őszinteségét kódolják. A total_is_lower_bound jelzi, ha a találati szám elérte a 10 000-es plafont, és abbahagyta a számlálást. A country_source megmutatja, hogyan határozták meg az országot – mert bármelyik híradat-halmazban a földrajzi értékek nagy része következtetés, nem tény. A crawled_at pedig a megbízható időbélyeg: a kiadók gyakran visszamenőlegesen állítják be a published_at értéket, de a másolási időt a pipeline határozza meg, és az csak előre halad.
Keresés: Minden lényeges paraméter
Minden paraméter opcionális. Egy alapvető hívás a legfrissebb cikkeket adja vissza az indexből.
A keresési lekérdezés
- q Összehasonlítás a címmel (súly 3), a leírással (súly 2) és a cikk testével. AND logika – minden kifejezésnek jelen kell lennie, így egy szó hozzáadása szűkíti, nem pedig tágítja a találatokat. Maximum 500 karakter.
opec production cut működik. A what did OPEC decide about oil pedig semmit sem ad vissza.A szűrők
A szűrők AND logikával kombinálódnak paraméterek között, és OR logikával egy paraméteren belül. Tehát a country=DE,AT&lang=de azt jelenti: „Német nyelvű cikkek Németországból vagy Ausztriából”. Mindegyik elfogad egy vesszővel elválasztott listát, maximum ötven értékkel.
| Szűrő | Formátum | Megjegyzések |
|---|---|---|
country | ISO 3166-1 alpha-2, nagybetűkkel | A kiadó országa. Következtetés, nem deklaráció — lásd country_source és strict_country. |
lang | ISO 639-1, kisbetűkkel | A dokumentumból észlelve. 99,9%-os lefedettség. |
tld | pont nélkül | A kiadó domain zónája. tld=ua egy tény; country=UA egy következtetés. |
host | pontos gépnév | Ahogy a URL-ben szerepelnek — ha a kiadó használja, akkor www. előtaggal. |
date | ma · tegnap · 24h · 48h · 7h · 30h | Előre definiált időintervallum, amelyet a published_at mező alapján értékelünk. |
from / to | ISO dátumok | Kifejezett ablak, amikor az előre definiált beállítások nem illeszkednek. |
strict_country | true/false | Csak azokat a cikkeket számoljuk, amelyek országa egy tény, nem pedig következtetés. |
Kimenet vezérlése
| Paraméter | Értékek | Hatás |
|---|---|---|
sort | date · date_asc · crawled · crawled_asc · relevance | Új cikkek lekérdezésekor a crawled mező szerint rendezz — a kiadók visszamenőleges publikációs időket adhatnak meg; a másolási idő csak előre halad. |
size | 1–100 | Találatok oldalanként. |
offset | 0–9900 | Oldalazási eltolás. |
full_text | true/false | Az article törzsének belefoglalása. Alapértelmezetten ki van kapcsolva. |
highlight | true/false | A találati részek visszaadása. |
fields | CSV | A válasz vágása a ténylegesen használt mezőkre. |
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"Számolás keresés előtt
A szolgáltatás leggyakrabban alulhasznált végpontja a /v1/stats. Gyakran nem az a hasznos kérdés, hogy „melyek a cikkek”, hanem az, hogy „van-e egyáltalán valami itt, és hol található”. A számolás erre választ ad töredékáron — körülbelül két száz tokenért, szemben a több ezerrel, amit egy találati oldal igényel —, így ez a helyes első hívás egy olyan ügynök számára, amely eldönti, megéri-e elindítani a keresést.
curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"Ország, nyelv, TLD, kiadó és nap szerinti számokat ad vissza, a teljes egyező halmaz alapján, nem pedig az aktuális oldal alapján. Ez az, amivel a lefedettséget is mérheted, mielőtt megbíznál benne. A szűrés nélküli pillanatfelvétel írás időpontjában:
Vezető országok
| Ország | Cikkek |
|---|---|
| India | 2,286,014 |
| Egyesült Államok | 2,180,797 |
| Törökország | 1,499,897 |
| Oroszország | 1,436,556 |
| Olaszország | 1,057,479 |
| Argentína | 826,947 |
| Spanyolország | 812,347 |
| Ukrajna | 662,041 |
| Brazília | 551,013 |
| Németország | 543,132 |
| Franciaország | 502,846 |
| Görögország | 460,372 |
| Japán | 437,209 |
| Vietnám | 408,934 |
| Mexikó | 402,320 |
| Dél-Korea | 362,945 |
| Románia | 354,229 |
| Egyesült Királyság | 334,379 |
| Irán | 291,782 |
| Lengyelország | 255,599 |
Főbb nyelvek
angol 5 513 650 · spanyol 2 699 457 · orosz 1 785 796 · török 1 501 004 · olasz 992 200 · német 733 677 · francia 689 136 · arab 664 016 · portugál 637 607 · hindi 560 840 · görög 466 504 · japán 427 085 · vietnámi 385 719 · román 358 766 · kínai 352 720 · ukrán 345 809 · koreai 335 079 · perzsa 268 126 · lengyel 238 904 · bolgár 183 204.
Ez az eloszlás megéri egy pillantást, mert épp az ellenkezőjét mutatja, mint amit a legtöbb hírforrás API nyújt. A szokásos angol- és USA-közpúsú korpusz nem ez: India megelőzi az Egyesült Államokat, a török nyelv előnybe kerül a némettel szemben, a görög, vietnámi, perzsa és bolgár nyelv pedig hatjegyű reprezentációval rendelkezik. Ha nem angol nyelvű sajtóval kapcsolatos kérdésed van, akkor ez egy teljesen más adathalmaz.
Mennyiség
A by_day napi görbe a teljes kilencven napos ablakot lefedi. A legutóbbi napok nagyjából 400 000 és 700 000 cikk közötti napi terjedelemben mozognak; az ablak korábbi szakaszában, a RSS réteg és az archivum beolvasása mellett való hozzáadás előtt a napi mennyiség 130 000–230 000 között volt. Mindkét adat látható ugyanabban a válaszban, ami a lényeg – a szolgáltatás a saját növekedési ívét mutatja, nem pedig egy marketingátlagot idéz.
Trendek: Miről szól valójában a sajtó most
A keresés megválaszolja a „miről írtak X-ről” kérdést. A trendek egy másik, gyakran jobb kérdésre adnak választ: „mi történik éppen” – X nélkül is.
Egy robot csoportosítja a cikkeket történetekké országonként, és naprakészen tartja őket. Minden öt percben új cikkeket kapcsolnak ismert történetekhez azonosító szavaik alapján, modellhívás nélkül; minden pár órában egy ország átmegy egy teljes átfutáson, ahol egy nyelvi modell elolvassa a címeket, és alaphelyzetből elnevezi a történeteket. A trend réteg írási időpontjában 115 országot fed le, mindegyiket az elmúlt néhány percben frissítve.
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": [ … ]
}
]
}Minden történethez két szám tartozik, és más-más jelentésük van. Az articles a hangerőt jelenti; a publishers a szélességet. Egy olyan történet, amelynek 200 cikke van 4 kiadótól, egy hírügynökség megszállottsága. Egy olyan történet, amelynek 60 cikke van 40 kiadótól, az egy esemény. Az alapértelmezett rendezés a kiadók száma szerint történik, a min_publishers / min_articles pedig lehetővé teszi, hogy magad állítsd meg a mércét.
A történetek egy rögzített készletből származó kategóriát hordoznak: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.
Az ablak az olvasó választása, nem a roboté.
Ez egy igazán elegáns tervezési döntés. Minden cikket tárolunk a megjelenés idejével, és a történethez kapcsolunk, így bármely ablak — tizenöt perc, egy óra, egy nap, egy adott naptári dátum — csupán egy tartománylekérdezés ugyanazon tárolt adatokon. Egyetlen számítási művelet szolgál minden ablakot egyszerre. A window=15m, window=1h, window=24h, date=2026-09-01 vagy egy explicit since/until pár is ugyanazon az indexen működik újraszámítás nélkül.
Kulcsszavak: a hírek alapját képező szavak
curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"Minden kulcsszavhoz tartozik, hogy hány különböző történet tartalmazza, hány cikket tartalmaznak ezek a történetek, és — ami a legérdekesebb — hány nemzeti sajtóorgánum használja. Ez az utolsó szám jelenti a különbséget egy globális és egy hazai esemény között. Egy szó, amely hetven országban megjelenik, világhírű történet; egy szó, amely egy ország sajtóját uralja, hazai történet, akár milyen hangosan is szólal meg ott.
Mely országok élő
curl "https://freenewsapi.ai/v1/trends/countries"Visszaadja az összes nyomon követett országot a élő történetek számával és azzal, hogy hány perce lett újra kiszámítva — Törökország, Oroszország, Irán, Görögország, India, Olaszország, Ukrajna, Románia, Argentína, Németország és Brazília jelenleg ezer-nagyobb élő történetet tartalmaznak, amelyek utóbbi tíz percben lettek újra kiszámítva. A /v1/trends/{cc}/{slug} pedig bármely egyetlen történetet megnyitja a teljes cikkelistával.
Piacok vs. Lefedettség: Az ár az egyik tengelyen, a figyelem a másikon
Ez a szolgáltatás legkülönösebb vonása, és létezik, mert a korpusz szinte ingyen lehetővé teszi az építését. Helyezz el egy ársorozatot mellette annak, hogy mennyit írt a világ erről az eseményről ugyanazon órákban, egy közös idővonalon.
curl "https://freenewsapi.ai/v1/markets"Tizennégy instrumentumot követünk nyomon, négy eszközosztályon át:
| Osztály | Instrumentumok | Granularitás | Forrás |
|---|---|---|---|
| Kriptovaluta | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | óra | Binance |
| Fémek | Arany (USD/oz) | óra | Binance |
| Devizák | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | nap | EKB |
| Energia | Németországi áramár (EUR/MWh) | óra | Energy-Charts |
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"Egyetlen hívással lekérheted a líra/dollár árfolyamot és a török sajtó által lefedett volumen adatokat ugyanarra az időszakra, óránkénti bontásban. A török sajtó eznek a korpusznak a harmadik legnagyobb rétegét adja, ami pontosan azért eredményez értelmes adatokat, nem pedig zajt a párosításnál.
És egy teljes Bitcoin hangulati blokk
A Bitcoin saját, hét végpontból álló családot kap, mivel ez az egyetlen eszköz, amelynek hírek szerinti hangulatát és árfolyammozgását folyamatosan vitatják, de ritkán mérik:
| Végpont | Visszatérési értékek |
|---|---|
/v1/btc/summary | Legfrissebb ár, legutóbbi mozgások és a mai sajtóközlemények hangulata. |
/v1/btc/price | BTC/USDT gyertyadiagramok időközönként. |
/v1/btc/sentiment | Hírek hangulata időszakokra bontva. |
/v1/btc/series | Az ár és a hangulat egy közös idővonalon. |
/v1/btc/correlation | Korreláció a hangulat és az árfolyammozgás között időeltolással — előzi meg a hírfedés az árat, vagy követi azt? |
/v1/btc/news | Kriptovalutával kapcsolatos cikkek hangulati címkéikkel, címké, host, nyelv és keresési kifejezés szerint szűrhetők. |
/v1/btc/sources | Mely kiadványok foglalkoznak a kriptovalutákkal, és hogyan állnak hozzájuk. |
A hangulati címkéket egy nyelvi modell generálja, amely minden öt percben feldolgozza a friss kriptocikk-eket egy kalibrált érme-lista alapján. A /v1/btc/correlation végpont a max_shift paraméterrel az, amit érdemes használni, ha valaha is tesztelni akarta azt az állítást, hogy „a hírek okozzák az áringadozást”, ahelyett, hogy csak ismételné azt.
Ugyanaz a keresés, mint hírfolyam
Három további végpont ugyanazokat a keresési paramétereket fogadja, és az eredményeket syndikációs formátumban jeleníti meg, nem pedig JSON formátumban:
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=dateEz azt jelenti, hogy bármely mentett keresés átalakítható hírfolyammá, amelyet beilleszthet egy olvasóba, egy n8n csomópontba, egy Slack-integrációba, egy Zapier-triggerbe vagy egy statikus oldalgenerátorba — kód és API-kulcs nélkül. Ez egy apró funkció, amely csendesen megszüntet egy teljes integrációs réteget a nem programozók számára.
MCP: Huszonnyolc eszköz, két réteg
A MCP szerver egy URL címen érhető el, Streamable HTTP-t (JSON-RPC 2.0 POST-on keresztül, 2025-06-18 protokollverzió) használ, támogatja a tömbösítést, és — mint minden más itt — nincs hitelesítési lépése és nincs munkamenet-azonosítója.
claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcpKét szándékos rétegben 28 eszközt tesz elérhetővé.
Első réteg: hat gyorsbillentyű, amelyek egy hívással megválaszolnak egy teljes kérdést
| Eszköz | Cél |
|---|---|
search_news | "Mi íródott X-ről" — teljes szövegű keresés, tömörített eredmény. |
get_trends | "Mi történik" — csoportosított történetek, nem cikkegylisták. |
trend_keywords | Azok a szavak, amelyekre a hírek most épülnek, történetszámokkal és országok szerinti eloszlással. |
find_publishers | Keresse meg a kiadókat: név, domain, ország, nyelv, napi cikkszám. |
list_countries | Mely országokban vannak élő történetek, hány darab, és mennyire frissek. |
market_vs_news | Árfolyamsorozat a lefedettségi volumen mellett. Hívja meg műszer megadása nélkül, hogy megtekinthesse, mi létezik. |
2. réteg: minden végpont, a szolgáltatás maga által generálva
A gyorsítótárolók alatt minden nyers végpont külön eszközként jelenik meg, minden olyan paraméterrel, amelyet a API elfogad — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, az egész news_get_btc_* család, a hírfolyam-megjelenítők és a news_get_health. Ezek a élő szolgáltatásból származnak, így nem térhetnek el attól, amit a API ténylegesen elfogad.
Két metaeszköz zárja a kört: a news_list_endpoints visszaadja a létezők katalógusát, a news_get pedig egy nyers GET hajt végre bármely útvonalon — így egy olyan ügynök, amelyik egy olyan végponttal találkozik, amelyet eszközkészlete nem fed le, továbbra is elérheti azt.
curl "https://freenewsapi.ai/mcp?format=json"Egyetlen GET, nincs kézfogás, és máris megvan az egész géppel olvasható katalógus: szerver, közlekedési réteg, protokoll, eszközsám, minden eszköz leírásával és minden végpont paraméterlistájával.
Gépek számára olvashatóan tervezve
A dokumentáció nem egy utólag a API-hoz csavart mellékes elem — hanem annak elsőrangú kimenete. A weboldal 666 statikus oldalt tartalmaz, és többük kifejezetten azért létezik, hogy egy modellnek ne kelljen HTML-t olvasnia:
- /openapi.json A teljes OpenAPI sémája.
- /llms.txt Egy rövid tájékoztató fájl — a szolgáltatásról, az endpointokról, a hatékony lekérdezésről és a hibákról.
- /llms-full.txt A teljes dokumentáció egyetlen szöveges fájlként, több mint száz kilobájtnyi tartalommal, hogy egy AI ügynok egyetlen lekéréssel be tudja emészteni az egész kézikönyvet.
- /agents Harmincnégy oldal kifejezetten ügynökfejlesztőknek: kész OpenAI függvénydefiníciók, Anthropic eszközhasonználati definíciók, rendszergyűjtemények a hírek lekérdezéséhez, RAG receptek, tokenköltség-táblázatok és ügynök receptek.
- /agents/models Eszközhívó kódok modellcsaládonként — 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 A korpusz tartalma, a módszertan, az index sémája és egy Adatminőség című oldal, amely dokumentálja, hol hibázik a készlet.
- /sources Egy böngészhető katalógus 11 668 kiadóból, amely szűrhető ország, nyelv és domain zóna szerint.
- /compare Oldalról oldalra összehasonlítás a NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube és FreeNewsAPI.io szolgáltatásokkal.
Plus 168 országoldal, 121 nyelvi oldal és 275 TLD-oldal – minden adathalmaz-részhez tartozik egy böngészhető felület, amely megmutatja, mi található benne valójában.
Honnan származnak a cikkek?
Két befogadási útvonal táplálja ugyanazt az indexet, és a kettő közötti különbség jelentős.
Az archiválási útvonal
Minden tíz percben egy feladat ellenőrzi a Common Crawl CC-NEWS archívumát új WARC fájlok után, és feldolgozza azokat, amelyeket még nem látott, negyven párhuzamos munkafolyamat segítségével. A kinyerő minden cikket kibont a nyers másolatból, mezőnként dokumentált prioritási sorrendet alkalmazva – és ezeket a prioritási sorrendeket valós adatok alapján mérték, nem feltételezés alapján:
| Mező | Prioritási sorrend | Lefedettség |
|---|---|---|
| leírás | JSON-LD → meta → OpenGraph → Twitter kártya → articleBody → bevezető bekezdés | 98.1% |
| nyelv | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| ország | ccTLD → JSON-LD addressCountry → nyelv-ország → og:locale | 79.1% |
| dátum | JSON-LD datePublished → meta → trafilatura → másolás ideje | 100% |
Ez az országos adat az őszinte, és ezért van a country_source minden cikkben: a rekordok körülbelül egyötöde egyáltalán nem rendelkezik megbízható országjelzővel, és a meglévő értékek körülbelül egyharmada következtetésen alapul, nem tényeken. A API megmutatja, melyik melyik, nem pedig úgy tesz, mintha tény lenne.
A közvetlen elérési út
Egy második robot ötpercenként lekérdezi a kiadó RSS hírcsatornáit, feltételes kérésekkel kombinálva – egy 304 Not Modified (Nem módosítva) választ adó hírcsatorna lekérdezése szinte semmibe kerül, és minden hírcsatorna lekérdezési intervalluma ahhoz van igazítva, hogy milyen gyakran publikál valójában. Egy olyan kiadó, amely naponta öt cikket tesz közzé, nem kap elöntést minden tizenöt percben.
Csak azt veszi át, amit a kiadó a hírcsatornába helyezett: címet, bevezetőt és a teljes szöveget, ha a hírcsatorna tartalmazza azt. Nem lép be a kiadó weboldalára további adatokért. Ez egy szándékos határ, és ez az oka annak, hogy a szolgáltatás meg tudja adni az ígéreteit a kiadók felé irányuló jogi oldalán.
És a körülöttük működő gépezet
A két befogadási út körül egy tucat további robot működik ütemezéssel: forráskutatás és szinkronizálás, domainenkénti országmeghatározás, trendépítés és ellenőrzés, kulcsszó-utólagos feltöltés, kriptó hangulat, piaci lekérdezések, taxonómia-katalógus, megtartás (a kilencvennapos ablakot egy éjszakai lekérdezés érvényesíti a published_at alapján, nem az index életkora), napellenőrzés, üres cikkek utólagos ellenőrzése, és egy egészségügyi őrző, ami újraindít mindent, ami leállt. A korpusz egy dedikált Elasticsearch klaszteren él.
Amiben ez az adathalmaz hibázik
A szolgáltatás közzéteszi saját korlátait, ami a leggyorsabb módja annak, hogy megítélje, illik-e a problémájához.
- Az ország következtetett Olvasd el a
country_sourcemezőt minden cikkben, és add hozzá astrict_country=trueparamétert, amikor országok szerinti számlálást végzel, nem pedig böngészkedés közben. - A published_at kiadó által megadott A visszamenőleges dátumozás gyakori. Rendezd a
crawled(másolás) mező szerint, amikor az újdonságok lekérdezésére használod. - A total értéke 10 000-re van korlátozva A sebesség érdekében. A
total_is_lower_boundjelzi, amikor elérted a plafont. - Nincs hangulat- vagy entitáskinyerés A Bitcoin blokkon kívül a cikkek nem tartalmaznak hangulati pontszámot és nem tartalmaznak név szerű entitásokat. Ez nincs hatókörben.
- Kilencven nap, és ennyi Nincs mélyebb archívum. Ha 2019-re van szükséged, ez a nem megfelelő eszköz.
- Nincs SLA Ingyenes. Emellett felügyelik és őrzik, de semmit nem ígérnek írásban.
- A szöveg a kiadóké Minden válasz tartalmazza az eredeti URL, és a hívóktól elvárják, hogy hivatkozzanak rá.
A hatékony használat: költségek, lapozás és hibák
Tokenfegyelem
Egy ügynök számára a válasz mérete a valós költség. A dokumentált formátum:
| Hívás | Becsült tokenköltség | Mikor |
|---|---|---|
/v1/stats | ~200 | Először. Döntsd el, hogy megéri-e egyáltalán futtatni a keresést. |
/v1/search csak metaadatok | néhány ezer oldalanként | Vizsgálat és kiválasztás. |
/v1/search?full_text=true | ~900 cikkenként | Csak azokhoz, amelyeket ténylegesen kiválasztottál. |
Húsz cikk full_text=true paraméterrel körülbelül 40 000 tokent jelent. A javasolt minta mindig ugyanaz: számolj, nézz körül, majd töltsd le a törzsszövegeket csak azokból, amelyekre szükség van.
Oldalazás a határon túl
Az offset 9900-nál áll meg. Nagyobb adathalmaz bejárásához ne küzdj a határral, hanem időalapú szegmentálást végezz. Iterálj napról napra, vagy sűrű lekérdezés esetén óráról órára, a from/to és sort=date paraméterekkel. A dokumentációban található egy külön oldal a teljes nap bejárásához.
Hibák
A szerződés tömör és könnyen kezelhető: a 4xx azt jelenti, hogy a kérés hibás – javítsd ki, ne próbáld újra. Az 5xx azt jelenti, hogy a szolgáltatás nem elérhető – lassíts. A 429 azt jelenti, hogy lassíts és próbáld újra. Az ismeretlen lekérdezési paramétereket figyelmen kívül hagyják, nem pedig elutasítják, így egy új mező hozzáadása soha nem törheti meg a meglévő hívót.
Azonosítsd magad (Opcionális, és valóban opcionális)
Kulcs nélkül nincs mód a hívó azonosítására. A javasolt udvariassági szabály egy fejléc, amely megadja az ügynököt, a keretrendszert, amelyen keresztül fut, és a modellt, amely működteti:
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>)Ugyanazok az értékek egyszerű lekérdezési paraméterként is használhatók, ami általában egyszerűbb:
https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4oAz ismeretlen kulcsokat figyelmen kívül hagyják, így a felesleges kulcsok mindig biztonságosan küldhetők. Semmi nem validálódik, semmi nem lassul le a hiányuk miatt, és az egyetlen szigorú utasítás: soha ne helyezd el a végfelhasználó személyes adatait ezekbe a mezőkbe.
A fizetett hírek API ellen
Az oldalon található összehasonlító oldalak egyesével tizenkét versenytársat fednek le. A szerkezeti különbségek, amelyek mind közül megmaradnak:
100 kérelem/nap, 24 órás késés
Egy ingyenes API csomag szabványos formája: egy olyan tokenkosár, amely elég kicsi ahhoz, hogy bemutató szintű legyen, és a friss cikkeket a fizető ügyfelek számára tartják vissza.
- Kulcs szükséges
- Napi limit
- Késleltetett cikkek
- Kizárólag nem kereskedelmi célra
Nincs limit, nincs késés, nincs kulcs
Az egyetlen korlát a másodpercenkénti 20 kérelem IP-címenként. A legfrissebb cikk általában kevesebb mint két perce készült, és a kereskedelmi felhasználás megengedett.
- Nincs kulcs, nincs regisztráció
- Napi vagy havi limit nélkül
- Folyamatos frissítés
- Kereskedelmi felhasználás megengedett
Angol és amerikai fókusz
A legtöbb adatbázist egy angol nyelvű kiadói listából állítják össze, és a világ többi részét utólag csatolják hozzá.
- Angol nyelvű dominancia
- Vékony nem latin nyelvű lefedettség
India > USA, török > német
Körülbelül 100 nyelv, hatjegyű kötetekkel görög, vietnami, perzsa, ukrán és bolgár nyelven.
- 100 ország
- ~100 nyelv
- 11 668 katalógusba rendezett forrás
Mit adnak még mindig a fizetős szolgáltatások, amit ez nem: hangulati pontszámokat és entitások kinyerését alapértelmezett mezőkként, évekkel ezelőtti archívumokat, valamint egy mögöttes SLA-val rendelkező szerződést. Ezek valósak, és ha szükséged van rájuk, akkor meg kell vásárolnod őket.
Receptek
Élő országfigyelő
curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"Ez a hír globális vagy belföldi?
curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world eventModell alapozása a mai lefedettségre, olcsón
# 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"A lefedettség vezeti az árat?
curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"Mentett keresés átalakítása hírfolyammá
https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50Azok piacának megfelelő kiadványok megtalálása
curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that sliceA rövid változat
A Free News API egy teljes szövegű keresőmotor, amely több mint 25 000 kiadótól származó 21,5 millió hírösszeállítást dolgoz fel 100 ország és körülbelül 100 nyelv alapján, egy folyamatosan frissülő, kilencven napos időablakon belül, API-kulcs, regisztráció és kvóta nélkül – csak egy IP-alapú sebességkorlátozás érvényes. A keresés felett élő, országonkénti hírklaszterezést találunk 115 országban, kulcsszavas elemzést, amely szétválasztja a világ- és a hazai eseményeket, tizet piaci eszközt ábrázolva a lefedettségi volumen függvényében, egy hét végpontból álló Bitcoin-szintiment blokkot, a RSS/Atom/JSON syndicationt bármilyen lekérdezésre, valamint egy 28 eszközös MCP szervert, amelyet maga a szolgáltatás generál.
Dokumentálja saját hibaszázalékát, feltárja, hogy minden országos adat hogyan került előállításra, és nyilvánosságra hoz egy oldalt arról, hogy mely adatok lehetnek pontatlanok. Egy olyan ügynök számára, amelynek tudnia kell, mit mond a világ – törökül, görögül, hindiül, éppen most – ez a kombináció bármilyen áron nehézkes megtalálni, és ez az ingyenes.
A keresés AND (ÉS) logikát alkalmaz az összes kifejezésre. Használjon 2–5 kulcsszót, ne természetes nyelvi kérdést.
A Free News API, arról, hogyan lehet jól lekérdezni
Kezdje itt: freenewsapi.ai · MCP a freenewsapi.ai/mcp oldalon · az entire kézikönyv egyetlen fájlban a /llms-full.txt címen.