Vijesti API obično se prodaju po zahtjevu, skrivene iza ključa i ograničene na stotinak poziva dnevno u besplatnoj razini. Free News API nije ništa od toga: 21,5 milijuna članaka u okviru od 90 dana, više od 25.000 izdavača, bez ključa, bez prijave, bez kvote, dopuštena komercijalna upotreba. Evo cijelog raspona mogućnosti — pretraživanje, statistika, trendovi, tržišta, feedovi i MCP — te iskreni pregled toga gdje podaci griješe.
Oblik problema
Pitate li AI agenta o tome što se trenutno piše u svijetu, on ima tri loše opcije. Može izravno skidati sadržaj s web stranica izdavača, što je krhko, sporo i pravno nejasno. Može pozvati komercijalni API za vijesti, što znači račun, ključ, mjesečni račun i — u svakoj besplatnoj ponudi na tržištu — stotinu zahtjeva dnevno i vijesti kašnjene dvadeset i četiri sata. Ili može nagađati na temelju podataka za obuku koji su zastarjeli prije nekoliko mjeseci.
Free News API uklanja cijenu i birokraciju srednje opcije, a da pritom ne uklanja njezinu sposobnost. Jedan GET zahtjev, bez vjerodajnica, nad korpusom koji u vrijeme pisanja ovog teksta sadrži 21.557.044 članka iz više od dvadeset tisuća izdavača, zadržan u okviru od 90 dana i osvježavan kontinuirano — najnoviji članak u indeksu obično je star manje od dvije minute.
Četiri osnovne točke prijema i još nešto
Jezgro usluge čine četiri GET točke prijema, sve na adresi https://freenewsapi.ai, sve vraćaju UTF-8 JSON s zaglavljem Access-Control-Allow-Origin: * kako bi se kôd u pregledniku mogao izravno obratiti njima, i sve izvještavaju o vremenu izvršavanja na poslužitelju u polju took_ms.
| Točka prijema | Što odgovara |
|---|---|
GET /v1/search | Pretraživanje punog teksta s filtrima. Točka prijema koju ćete koristiti 95 % vremena. |
GET /v1/stats | Agregirani brojevi za bilo koju podjelu — po državi, jeziku, TLD-u, izdavaču i danu. |
GET /v1/article | Jedan članak po točnom URL, uključujući cijeli tekst. |
GET /health | Liveness plus trenutni broj dokumenata. Jeftino dovoljno za redovno ispitivanje. |
Uokolo tog jezgra nalaze se još četiri obitelji, od kojih bi svaka bila zaseban proizvod negdje drugdje: trendovi (grupiranje vijesti u stvarnom vremenu po državama), tržišta (serije cijena usklađene s volumenom pokrivenosti), raspoloženje u kripto svijetu (sedam točaka Bitcoin bloka) i distribucija (isti pretraživač prikazan kao RSS, Atom ili JSON Feed). Sve su navedene u nastavku.
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 polja u tom odgovoru zaslužuju neposrednu pozornost jer kodiraju iskrenost cijelog skupa podataka. total_is_lower_bound vam govori kada je broj podudaranja dosegao svoj gornji limit od 10.000 i prestao brojati. country_source vam govori kako je država određena — jer u bilo kojem skupu podataka o vijestima veliki dio vrijednosti država su inferencije, a ne činjenice. A crawled_at je pouzdano vremensko obilježje: izdavači često unaprijed datiraju published_at, ali vrijeme pregledavanja dodjeljuje se u okviru cijevi obrade podataka i uvijek se pomakne samo naprijed.
Pretraživanje: Svaki parametar koji ima značenje
Svi parametri su opcionalni. Osnovni poziv vraća najnovije članke u indeksu.
Upit
- q Podudara se s naslovom (težina 3), opisom (težina 2) i tijelom članka. AND semantika — svaki pojam mora biti prisutan, tako da dodavanje riječi sužava, a ne proširuje rezultate. Maksimalno 500 znakova.
opec production cut radi. what did OPEC decide about oil vraća ništa.Filteri
Filteri se kombiniraju s AND preko parametara i OR unutar jednog. Tako country=DE,AT&lang=de čita kao "čanci na njemačkom jeziku iz Njemačke ili Austrije". Svaki prihvaća listu vrijednosti odvojenu zarezom do pedeset vrijednosti.
| Filter | Format | Bilješke |
|---|---|---|
country | ISO 3166-1 alpha-2, velika slova | Država izdavača. Izvedeno, a ne izravno navedeno — vidi country_source i strict_country. |
lang | ISO 639-1, mala slova | Otkriveno iz samog dokumenta. Pokrivenost od 99,9 %. |
tld | bez točke | Domena izdavača. tld=ua je činjenica; country=UA je zaključak. |
host | točne nazive poslužitelja | Onako kako se pojavljuju u URL — uključite www. ako ga izdavač koristi. |
date | danas · jučer · 24 h · 48 h · 7 d · 30 d | Unaprijed postavljeno razdoblje, procijenjeno prema published_at. |
from / to | ISO datumi | Eksplicitni prozor kada unaprijed postavljene vrijednosti ne odgovaraju. |
strict_country | true/false | Broj samo članke čija je zemlja činjenica, a ne zaključak. |
Kontrola izlaza
| Parametar | Vrijednosti | Učinak |
|---|---|---|
sort | date · date_asc · crawled · crawled_asc · relevance | Sortirajte prema crawled prilikom dohvaćanja novih članaka — izdavači navode datum objave unatrag; vrijeme dohvaćanja se uvijek pomakne naprijed. |
size | 1–100 | Rezultata po stranici. |
offset | 0–9900 | Pomak za straniciranje. |
full_text | true/false | Uključuje tijelo članka. Isključeno prema zadanim postavkama. |
highlight | true/false | Vraća podudarne isječke. |
fields | CSV | Ograničite odgovor na polja koja stvarno koristite. |
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"Brojanje prije pretraživanja
Najmanje iskorištena krajnja točka u usluzi je /v1/stats. Često je korisno pitanje ne „koji su to članci“, već „postoje li ovdje uopće i gdje se nalaze“. Brojanje odgovora na to troši samo razlomak troška — otprilike dvije stotine tokena naspram nekoliko tisuća za stranicu rezultata — što ga čini ispravnim prvim pozivom za agenta koji odlučuje isplati li se pretraživanje pokrenuti.
curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"Vraća brojeve po državi, jeziku, TLD-u, izdavaču i danu, izračunate za cijeli sklop podudaranja, a ne samo za trenutnu stranicu. Također je tako da izmjerite pokrivenost prije nego što joj vjerujete. Nefiltrirani snimak u vrijeme pisanja:
Najbolje države
| Država | Članci |
|---|---|
| Indija | 2,286,014 |
| Sjedinjene Američke Države | 2,180,797 |
| Turska | 1,499,897 |
| Rusija | 1,436,556 |
| Italija | 1,057,479 |
| Argentina | 826,947 |
| Španjolska | 812,347 |
| Ukrajina | 662,041 |
| Brazil | 551,013 |
| Njemačka | 543,132 |
| Francuska | 502,846 |
| Grčka | 460,372 |
| Japan | 437,209 |
| Vijetnam | 408,934 |
| Meksiko | 402,320 |
| Južna Koreja | 362,945 |
| Rumunjska | 354,229 |
| Ujedinjeno Kraljevstvo | 334,379 |
| Iran | 291,782 |
| Poljska | 255,599 |
Najčešći jezici
Engleski 5.513.650 · Španjolski 2.699.457 · Ruski 1.785.796 · Turski 1.501.004 · Talijanski 992.200 · Njemački 733.677 · Francuski 689.136 · Arapski 664.016 · Portugalski 637.607 · Hindi 560.840 · Grčki 466.504 · Japanski 427.085 · Vijetnamski 385.719 · Rumunjski 358.766 · Kineski 352.720 · Ukrajinski 345.809 · Korejski 335.079 · Perzijski 268.126 · Poljski 238.904 · Bugarski 183.204.
Takva raspodjela zaslužuje da joj posvetite kratku pažnju jer je upravo suprotna onome što vam većina vijesti API nudi. Uobičajeni korpus koji je usmjeren prvenstveno na engleski jezik i SAD nije ono što ovdje imate: Indija nadmašuje Sjedinjene Države, turski nadmašuje njemački, a grčki, vijetnamski, perzijski i bugarski imaju šesteroznamenkastu zastupljenost. Ako vas zanima tiskani medij koji nije na engleskom, radi se o materijalno drugačijem skupu podataka.
Opseg
Dnevna krivulja u by_day pokriva cijeli prozor od devedeset dana. Nedavni dani kreću se u rasponu od otprilike 400.000 do 700.000 članaka dnevno; ranije u tom razdoblju, prije nego što je uz ingestiju arhive dodan sloj RSS, dnevni opseg iznosio je 130.000–230.000. Obje se brojke vide u istom odgovoru, a upravo je to poanta — servis vam pokazuje vlastiti rast, a ne navodi prosjek iz marketinških materijala.
Trendovi: Što mediji zapravo izvještavaju upravo sada
Pretraga odgovara na pitanje "što je napisano o X-u". Trendovi odgovaraju na drugačije i često bolje pitanje: "što se događa" — bez potrebe za X-om.
Robot grupira članke u priče po državama i održava ih ažuriranima. Svakih pet minuta novi se članci povezuju s poznatim pričama pomoću prepoznatljivih riječi, bez ikakvog poziva modelu; svakih nekoliko sati jedna država prolazi kroz cjelovitu obradu u kojoj je jezični model čitao naslove i od početka imenovao priče. U trenutku pisanja sloj trendova pokriva 115 država, od kojih je svaka ponovno izračunata u posljednjih nekoliko minuta.
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": [ … ]
}
]
}Svakoj priči pridružuju se dvije brojke koje imaju različita značenja. articles označava glasnoću; publishers označava širinu. Priča s 200 članaka iz 4 izdavača predstavlja opsesiju jedne novinarske kuće. Priča s 60 članaka iz 40 izdavača predstavlja događaj. Zadani način sortiranja je prema broju izdavača, a min_publishers / min_articles omogućuju vam da sami postavite prag.
Priče nose kategoriju iz fiksnog skupa: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.
Prozor je izbor čitatelja, a ne robota
Riječ je o zaista elegantnom dizajnerskom rješenju. Svaki članak pohranjuje se s vremenom objavljivanja i povezuje s pripadajućom pričom, pa je bilo koji vremenski okvir — petnaest minuta, sat, dan, određeni kalendarski datum — samo upit na raspon unutar istih pohranjenih podataka. Jedna obrada služi svim okvirima istovremeno. window=15m, window=1h, window=24h, date=2026-09-01 ili eksplicitni par since/until rade protiv istog indeksa bez potrebe za ponovnom obradom.
Ključne riječi: riječi na kojima je vijest utemeljena
curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"Svaka ključna riječ vraća se s podacima o broju različitih priča koje je nose, broju članaka koje te priče sadrže te — ono najzanimljivije — broju nacionalnih tiskovnih kuća koje je koriste. Taj posljednji broj čini razliku između globalnog i domaćeg događaja. Riječ koja se pojavljuje u sedamdesetak zemalja svjetska je vijest; riječ koja dominira tiskom jedne zemlje domaća je vijest, bez obzira na to koliko je glasna u tom kontekstu.
Koje su zemlje u stvarnom vremenu
curl "https://freenewsapi.ai/v1/trends/countries"Vraća sve praćene zemlje s brojem vijesti u stvarnom vremenu i brojem minuta od zadnje ponovne obrade — Turska, Rusija, Iran, Grčka, Indija, Italija, Ukrajina, Rumunjska, Argentina, Njemačka i Brazil trenutno svaka ima tisuće vijesti u stvarnom vremenu, ponovno obrađenih u posljednjih deset minuta. A /v1/trends/{cc}/{slug} otvara bilo koju pojedinačnu vijest s potpunim popisom članaka.
Tržišta naspram pokrivenosti: cijena na jednoj, a pažnja na drugoj osi
Ovo je najneobičnija značajka usluge, a postoji zato što korpus čini njezinu izradu gotovo besplatnom. Postavite seriju cijena uz to koliko je svijet pisao o tom događaju u istim satima, na jednoj vremenskoj osi.
curl "https://freenewsapi.ai/v1/markets"Praćenje četrnaest instrumenata, kroz četiri klase imovine:
| Klasa | Instrumenti | Vremenska razlučivost | Izvor |
|---|---|---|---|
| Kriptovalute | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | sat | Binance |
| Metali | Zlato (USD/oz) | sat | Binance |
| Valute | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | dan | EBC |
| Energija | Njemačka cijena električne energije (EUR/MWh) | sat | Energy-Charts |
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"Taj jedan poziv daje vam podatke o tečaju lire prema dolaru i opsegu medijskih naslova u turskoj tiskovnoj agenciji za isti razdoblje, poravnate sat po sat. Turska tiskovna agencija čini treći najveći dio ovog korpusa, što je upravo razlog zašto taj par daje smislene rezultate, a ne šum.
I cjeloviti blok sentimenta za Bitcoin
Bitcoin dobiva vlastitu obitelj s sedam krajnjih točaka jer je to jedini instrument o kojem se stalno raspravlja u pogledu odnosa tona vijesti i kretanja cijene, a taj se odnos rijetko mjeri:
| Krajnja točka | Povratne informacije |
|---|---|
/v1/btc/summary | Trenutna cijena, nedavna kretanja i ton današnjeg izvještavanja. |
/v1/btc/price | BTC/USDT svijeće prema intervalu. |
/v1/btc/sentiment | Ton vijesti po razdoblju. |
/v1/btc/series | Cijena i ton poravnati na jednoj vremenskoj osi. |
/v1/btc/correlation | Korelacija između tona i kretanja cijene prema vremenskom pomaku — vode li vijesti cijenu ili je prate? |
/v1/btc/news | Kripto članci s oznakom sentimenta, filtririvi prema oznaci, domaćinu, jeziku i upitu. |
/v1/btc/sources | Koji mediji pokrivaju kripto područje i kako se svaki od njih pozicionira. |
Oznake sentimenta dolaze od jezičnog modela koji obrađuje svježe kripto članke svakih pet minuta, u odnosu na kalibrirani popis valuta. /v1/btc/correlation s parametrom max_shift je onaj koji trebate koristiti ako ste ikada željeli testirati tvrdnju "vijesti uzrokuju pomak" umjesto da je samo ponovite.
Ista pretraga, kao feed
Tri dodatna endpointa koriste iste parametre pretrage i prikazuju rezultate u formatima za distribuciju, umjesto u 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 znači da svaka spremljena pretraga postaje feed koji možete zalijepiti u čitač, čvor u n8n, integraciju za Slack, okidač u Zapieru ili generator statičkih web stranica — bez koda i bez ključa. To je mala značajka koja tiho uklanja cijeli sloj integracije za nekodere.
MCP: Dvadeset osam alata, dva sloja
MCP poslužitelj nalazi se na jednoj URL, koristi Streamable HTTP (JSON-RPC 2.0 preko POST-a, verzija protokola 2025-06-18), podržava grupiranje zahtjeva i — poput svega ostalog ovdje — nema korak autorizacije niti ID sesije.
claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcpIzlaže 28 alata u dva namjerna sloja.
Prvi sloj: šest prečaca koji odgovaraju na cijelo pitanje u jednom pozivu
| Alat | Za |
|---|---|
search_news | "Što je napisano o X" — pretraga punog teksta, skraćeni rezultat. |
get_trends | "Što se događa" — grupirane priče umjesto popisa članaka. |
trend_keywords | Riječi na kojima se trenutno grade vijesti, s brojevima priča i raspodjelom po zemljama. |
find_publishers | Pronađite izdavače: ime, domena, zemlja, jezik, broj članaka dnevno. |
list_countries | Koje zemlje imaju aktivne priče, koliko ih ima i koliko su svježe. |
market_vs_news | Cjenovni niz uz opseg pokrivenosti. Pozovite bez instrumenta da vidite što postoji. |
Sloj dva: svaka krajnja točka generirana iz samog servisa
Izravno ispod prečaca, svaka sirova krajnja točka izložena je kao zaseban alat s svakim parametrom koji API prihvaća — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, cijela obitelj news_get_btc_*, rendereri feedova i news_get_health. Oni su generirani iz aktivnog servisa, stoga se ne mogu razlikovati od onoga što API stvarno prihvaća.
Dva meta-alata zatvaraju krug: news_list_endpoints vraća katalog svega što postoji, a news_get izvodi sirovi GET na bilo kojoj stazi — tako da agent koji naiđe na krajnju točku koju njegov popis alata ne pokriva, i dalje može do nje doći.
curl "https://freenewsapi.ai/mcp?format=json"Jedan GET, bez rukovanja, i imate cijeli stroj čitljiv katalog: poslužitelj, transport, protokol, broj alata, svaki alat s opisom i svaku krajnju točku s popisom parametara.
Izgrađeno da ga čitaju strojevi
Dokumentacija nije naknadno dodani dodatak na API — ona je njezin output prve klase. Stranica objavljuje 665 statičkih stranica, a nekoliko njih postoji upravo tako da model nikada ne mora čitati HTML:
- /openapi.json Potpuni shemski opis OpenAPI.
- /llms.txt Kratka orijentacijska datoteka — što je usluga, koji su krajnje točke, kako se ispravno izvršavati upite i koje su greške moguće.
- /llms-full.txt Cijela dokumentacija kao jedna obična tekstualna datoteka, veličine preko stotinu kilobajta, kako bi agent mogao učitati cijeli priručnik u jednom zahtjevu.
- /agents Trideset i devet stranaka izravno namijenjenih tvorcima agenata: gotove definicije funkcija OpenAI, definicije alata Anthropic, sustavni uputi za pretraživanje vijesti, recepti za RAG, tablice troškova tokena i recepti za agente.
- /agents/models Kod za pozivanje alata po obitelji modela — 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 Što se nalazi u korpusu, metodologija, shema indeksa i stranica pod naslovom Kvaliteta podataka koja dokumentira gdje skup podataka griješi.
- /sources Pregledni katalog od 11.668 izdavača, koji se može filtrirati po državi, jeziku i domenskoj zoni.
- /compare Stranice usporedbe s NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube i FreeNewsAPI.io.
Plus 168 stranica po zemljama, 121 stranica po jezicima i 275 stranica po TLD-ovima — jedna pregledna površina po segmentu korpusa, na kojoj je vidljivo što se u njemu zapravo nalazi.
Podrijetlo članaka
Dva puta prikupljanja podataka napajaju isti indeks, a razlika između njih je značajna.
Put arhive
Svakih deset minuta posao provjerava Common Crawlovu CC-NEWS arhivu za nove WARC datoteke i obrađuje sve koje nije prethodno vidio, koristeći četrdeset paralelnih radnika. Ekstraktor izdvaja svaki članak iz sirovog pregleda uz dokumentiranu hijerarhiju izvora za svako polje — a ti su izvori izmjereni na stvarnim podacima, a ne pretpostavljeni:
| Polje | Hijerarhija izvora | Pokrivenost |
|---|---|---|
| opis | JSON-LD → meta → OpenGraph → Twitter kartica → articleBody → uvodni odlomak | 98.1% |
| jezik | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| zemlja | ccTLD → JSON-LD addressCountry → jezik-regija → og:locale | 79.1% |
| datum | JSON-LD datePublished → meta → trafilatura → vrijeme pregleda | 100% |
Onaj podatak o državi je onaj iskreni, a upravo je zato polje country_source izloženo na svakom članku: otprilike petina zapisa nema pouzdan signal o državi, a oko trećina vrijednosti koje postoje su zaključci, a ne činjenice. API vam govori što je što, umjesto da se pravi.
Izravni put
Drugi robot dohvaća feedove izdavača RSS svakih pet minuta, u rotaciji s uvjetnim zahtjevima — feed koji odgovara s 304 Not Modified košta gotovo ništa, a interval dohvaćanja svakog feeda prilagođen je tome koliko često taj izdavač zapravo objavljuje. Izdanak koji objavljuje pet priča dnevno ne podliježe dohvaćanju svakih petnaest minuta.
Također uzima samo ono što je izdavač stavio u feed: naslov, uvod i cijeli tekst kada ga feed sadrži. Ne ulazi na web stranicu izdavača kako bi dohvaćao dodatne informacije. To je namjerna granica i upravo je to razlog zašto usluga može dati obećanja koja daje na svojoj pravnoj stranici za izdavače.
I mehanizam oko njih
Okolo dva puta dohvaćanja nalazi se još desetak robotâ s rasporedima: otkrivanje izvora i sinkronizacija, određivanje države po domeni, izgradnja trendova i revizija, nadopuna ključnih riječi, kriptosentiment, dohvaćanje tržišta, katalog taksonomije, zadržavanje (prozor od devedeset dana provodi se noćnim upitom na published_at, a ne dobi indeksa), provjera dana, ponovne provrake praznih članaka i čuvar zdravlja koji pokreće ispočetka sve što je stalo. Korpus se nalazi na posvećenom Elasticsearch klasteru.
Što ovaj skup podataka čini pogrešno
Usluga objavljuje svoja ograničenja, što je najbrži način da procijenite odgovara li vašem problemu.
- Država je zaključena Pročitajte
country_sourcena svakom članku i dodajtestrict_country=truekada brojite po državama, a ne kada pregledavate. - published_at je dostavljen od strane izdavača Datiranje unatrag je česta pojava. Sortirajte po
crawledkada dohvaćate što je novo. - total je ograničen na 10.000 Zbrzinu.
total_is_lower_boundvam govori kada ste dosegli strop. - Nema ekstrakcije sentimenta ili entiteta Izvan Bitcoin bloka, članci nemaju ocjenu sentimenta niti imenovane entitete. To nije u opsegu.
- Devedeset dana i ništa više Ne postoji dublja arhiva. Ako vam treba sadržaj iz 2019., ovo nije pravi alat.
- Bez SLA Besplatno je. Također je nadzirano i zaštićeno, ali ništa nije zajamčeno pismeno.
- Tekst pripada izdavačima Svaki odgovor uključuje izvorni URL, a korisnici se očekuje da ga povezuju natrag.
Učinkovito korištenje: Troškovi, paginacija i pogreške
Disciplina tokena
Za agenta, veličina odgovora je stvarni trošak. Dokumentirani oblik:
| Poziv | Okvirni trošak tokena | Kada |
|---|---|---|
/v1/stats | ~200 | Prvo. Odlučite isplati li se pretraga uopće pokrenuti. |
/v1/search samo metapodaci | nekoliko tisuća po stranici | Skenirajte i odaberite. |
/v1/search?full_text=true | ~900 po članku | Samo za onih nekoliko koje ste stvarno odabrali. |
Dvadeset članaka s full_text=true iznosi otprilike 40.000 tokena. Preporučeni obrazac uvijek je isti: izbrojite, skenirajte, a zatim preuzmite sadržaj samo za one koje trebate.
Pregledavanje iznad gornje granice
offset staje na 9.900. Za pregledavanje velikog skupa podataka ne pokušavajte savladati tu granicu — umjesto toga podijelite podatke prema vremenu. Ponavljajte postupak dan po dan, ili sat po sat za zahtjevne upite, koristeći parametre from/to i sort=date. Dokumentacija sadrži posebnu stranicu o pregledavanju cijelog dana.
Greške
Ugovor je jasan i jednostavan za implementaciju: 4xx znači da je zahtjev pogrešan — popravite ga, nemojte ponavljati. 5xx znači da je usluga nedostupna — usporite. 429 znači usporiti i ponoviti pokušaj. Nepoznati parametri upita ignoriraju se umjesto da budu odbačeni, tako da dodavanje novog polja nikada neće prekinuti rad postojećeg klijenta.
Identificirajte se (opcionalno, i doista opcionalno)
Bez ključa nema načina da se klijent identificira. Predložena ljubaznost je zaglavlje koje navodi vaš agent, okvir kroz koji radi i model koji ga pokreće:
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>)Iste vrijednosti mogu se koristiti i kao obični parametri upita, što je obično jednostavnije:
https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4oNepoznati ključevi se ignoriraju, tako da je slanje dodatnih ključeva uvijek sigurno. Ništa se ne validira, ništa se ne ograničava zbog njegovog izostavljanja, a jedina čvrsta uputa glasi: nikada ne stavljajte osobne podatke krajnjih korisnika u ova polja.
Protiv plaćenih vijesti APIs
Usporedne stranice na web-mjestu pojedinačno obrađuju jedanaest konkurenata. Strukturalne razlike koje opstaju kod svih njih:
100 zahtjeva dnevno, odgoda od 24 sata
Standardni oblik besplatne API razine: token bucket dovoljno mali za demo, s novim člancima koji se zadržavaju za plaćene korisnike.
- Potreban ključ
- Dnevni limit
- Odgodeni članci
- Samo za nekomercijalnu upotrebu
Bez limita, bez odgode, bez ključa
Jedino ograničenje je 20 zahtjeva u sekundi po IP adresi. Najnoviji članak obično je stariji od manje od dvije minute, a komercijalna upotreba je dopuštena.
- Bez ključa, bez prijave
- Bez dnevnog ili mjesečnog limita
- Kontinuirano osvježavanje
- Dopuštena komercijalna upotreba
Prvenstveno na engleskom, prvenstveno za SAD
Većina korpusa izgrađena je na popisu engleskih izdavača uz dodatak ostalog svijeta.
- Dominacija engleskog jezika
- Ograničen obuhvat ne-latinica
Indija > SAD, turski > njemački
Oko 100 jezika s obujmom od šest znamenki u grčkom, vijetnamskom, perzijskom, ukrajinskom i bugarskom.
- 100 zemalja
- ~100 jezika
- 11.668 katalogiziranih izvora
Što plaćene usluge i dalje nude, a ovo ne: ocjene sentimenta i ekstrakcija entiteta kao standardna polja, arhive koje sežu godinama unatrag te ugovor s jamstvom razine usluge (SLA) iza toga. To su stvarne prednosti i ako vam trebaju, kupite ih.
Recepti
Nadzor zemalja u stvarnom vremenu
curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"Je li priča globalna ili domaća?
curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world eventPovežite model s današnjim obuhvatom po niskoj cijeni
# 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"Vođi li obuhvat cijenu?
curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"Pretvorite spremljeni upit u feed
https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50Pronađite medije koji su ključni na tržištu
curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that sliceSažetak
Free News API je pretraživanje punog teksta preko 21,5 milijuna novinskih članaka iz više od 25 000 izdavača u 100 zemalja i otprilike 100 jezika, u okviru od 90 dana koji se neprestano osvježava, bez ključa, bez prijave i bez kvote osim ograničenja stope po IP adresi. Uz pretraživanje nalaze se živci klasterizacije vijesti po zemljama u 115 zemalja, analiza ključnih riječi koja razdvaja svjetske događaje od domaćih, četrnaest tržišnih instrumenata prikazanih u odnosu na volumen pokrivenosti, blok za analizu sentimenta Bitcoina s sedam krajnjih točaka, RSS/Atom/JSON distribucija za bilo koji upit i poslužitelj MCP s 28 alata generiran iz same usluge.
Dokumentira vlastite stope pogrešaka, otkriva kako je izvedena svaka vrijednost za zemlju i objavljuje stranicu o tome gdje podaci griješe. Za agenta kojem je potrebno znati što svijet govori — na turskom, na grčkom, na hindiju, upravo sada — ta je kombinacija teško dostupna po bilo kojoj cijeni, a ova je besplatna.
Pretraživanje koristi logički operator AND za sve pojmove. Koristite 2–5 ključnih riječi, a ne pitanje u prirodnom jeziku.
Free News API, o tome kako dobro postaviti upit
Započnite ovdje: freenewsapi.ai · MCP na freenewsapi.ai/mcp · cijeli priručnik kao jedan datoteka na /llms-full.txt.