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.

21,5 millió
indexelt cikk
25,000+
kiadó
100
ország
~100
nyelv
90 nap
mozgó ablak
0
API létező kulcs
A szabály: Nincs API kulcs, és nem is lesz. Nincs hozzá paraméter, nincs küldendő fejléc, nincs létrehozandó fiók és nincs kérelem-kvóta — csupán egy IP-alapú, másodpercenként 20 kérelemre korlátozó sebességkorlátozás biztosítja, hogy egy hívó ne tudja leállítani a szolgáltatást a többi felhasználó számára.

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égpontMire válaszol
GET /v1/searchTeljes 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/articleEgy cikk pontosan a(z) URL alapján, a teljes szövegtartalommal együtt.
GET /healthLiveness é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

Kérdezz úgy, mint egy keresőmotor, nem úgy, mint egy chatbot: Ez a leggyakoribb hiba. A keresés AND logikát alkalmaz minden kifejezésre, így írj 2–5 kulcsszót, ne mondatot. Az 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átumMegjegyzések
countryISO 3166-1 alpha-2, nagybetűkkelA kiadó országa. Következtetés, nem deklaráció — lásd country_source és strict_country.
langISO 639-1, kisbetűkkelA dokumentumból észlelve. 99,9%-os lefedettség.
tldpont nélkülA kiadó domain zónája. tld=ua egy tény; country=UA egy következtetés.
hostpontos gépnévAhogy a URL-ben szerepelnek — ha a kiadó használja, akkor www. előtaggal.
datema · tegnap · 24h · 48h · 7h · 30hElőre definiált időintervallum, amelyet a published_at mező alapján értékelünk.
from / toISO dátumokKifejezett ablak, amikor az előre definiált beállítások nem illeszkednek.
strict_countrytrue/falseCsak azokat a cikkeket számoljuk, amelyek országa egy tény, nem pedig következtetés.

Kimenet vezérlése

ParaméterÉrtékekHatás
sortdate · 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.
size1–100Találatok oldalanként.
offset0–9900Oldalazási eltolás.
full_texttrue/falseAz article törzsének belefoglalása. Alapértelmezetten ki van kapcsolva.
highlighttrue/falseA találati részek visszaadása.
fieldsCSVA 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ágCikkek
India2,286,014
Egyesült Államok2,180,797
Törökország1,499,897
Oroszország1,436,556
Olaszország1,057,479
Argentína826,947
Spanyolország812,347
Ukrajna662,041
Brazília551,013
Németország543,132
Franciaország502,846
Görögország460,372
Japán437,209
Vietnám408,934
Mexikó402,320
Dél-Korea362,945
Románia354,229
Egyesült Királyság334,379
Irán291,782
Lengyelország255,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ályInstrumentumokGranularitásForrás
KriptovalutaBitcoin, Ethereum, Solana, XRP, BNB, DogecoinóraBinance
FémekArany (USD/oz)óraBinance
DevizákEUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLNnapEKB
EnergiaNémetországi áramár (EUR/MWh)óraEnergy-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égpontVisszatérési értékek
/v1/btc/summaryLegfrissebb ár, legutóbbi mozgások és a mai sajtóközlemények hangulata.
/v1/btc/priceBTC/USDT gyertyadiagramok időközönként.
/v1/btc/sentimentHírek hangulata időszakokra bontva.
/v1/btc/seriesAz ár és a hangulat egy közös idővonalon.
/v1/btc/correlationKorrelá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/newsKriptovalutával kapcsolatos cikkek hangulati címkéikkel, címké, host, nyelv és keresési kifejezés szerint szűrhetők.
/v1/btc/sourcesMely 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:

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

Ez 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/mcp

Ké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özCé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_keywordsAzok a szavak, amelyekre a hírek most épülnek, történetszámokkal és országok szerinti eloszlással.
find_publishersKeresse meg a kiadókat: név, domain, ország, nyelv, napi cikkszám.
list_countriesMely 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:

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 sorrendLefedettség
leírásJSON-LD → meta → OpenGraph → Twitter kártya → articleBody → bevezető bekezdés98.1%
nyelv<html lang> → JSON-LD inLanguage → og:locale99.9%
országccTLD → JSON-LD addressCountry → nyelv-ország → og:locale79.1%
dátumJSON-LD datePublished → meta → trafilatura → másolás ideje100%

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.

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ásBecsült tokenköltségMikor
/v1/stats~200Először. Döntsd el, hogy megéri-e egyáltalán futtatni a keresést.
/v1/search csak metaadatoknéhány ezer oldalankéntVizsgálat és kiválasztás.
/v1/search?full_text=true~900 cikkenkéntCsak 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-4o

Az 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:

Ingyenes csomagok máshol

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
Free News API

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
Fedezettség máshol

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
Lefedettség itt

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 event

Modell 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=50

Azok 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 slice

A 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.