Free News API: Претрага по пуном тексту преко 21 милиона чланака, 25.000 издавача и 100 земаља — уопште без кључа

Вести API обично се продају по захтеву, затворене су иза кључа и ограничених су на сто позива дневно на бесплатном нивоу. Free News API није ни једно од тога: 21,5 милиона чланака у оквиру померљивог 90-дневног периода, 25.000+ издавача, без кључа, без регистрације, без квоте, дозвољена комерцијална употреба. Ево целе површине — претрага, статистике, трендови, тржишта, фидови и MCP — и искрен преглед тога где подаци греше.

Облик проблема

Питајте ИИ агента о томе шта се тренутно дешава у свету и он има три лоше опције. Може да скрапи (прикупи податке) директно са сајтова издавача, што је крхко, споро и правно нејасно. Може да позове комерцијалну вести API, што значи налог, кључ, месечни рачун и — на сваком бесплатном нивоу на тржишту — сто захтева дневно и чланке који су каснили двадесет четири сата. Или може да гађа на основу података за обуку који су застарели пре неколико месеци.

Free News API уклања цену и папирологију средње опције, а да не уклапа њену способност. Један GET захтев, без акредитива, преко корпуса који је у тренутку писања садржао 21.557.044 чланка из више од двадесет пет хиљада издавача, задржан у померљивом деведесетодневном прозору и непрекидно освежаван — најновији чланак у индексу је обично стар мање од два минута.

Четири основна крајње тачке, и још нешто

Језгро сервиса чине четири GET крајње тачке, све на адреси https://freenewsapi.ai, све враћају UTF-8 JSON са заглављем Access-Control-Allow-Origin: * како би код у прегледачу могао директно да их позива, и све пријављују време обраде на серверу у пољу took_ms.

Око тог језгра налазе се још четири породице, од којих би свака на другом месту била самосталан производ: трендови (кластеризација живих вести по државама), тржишта (серије цена усклађене са обимом покривености), крипто расположење (седам крајњих тачака блока Биткоина) и синдикација (исти претраживач приказан као RSS, Atom или JSON Feed). Све су оне покривене у наставку.

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

Поља у том одговору која заслужују непосредну пажњу су она која кодирају искреност целог скупа података. total_is_lower_bound вам говори када је број поклопаца достигао свој плафон од 10.000 и престало је са бројањем. country_source показује како је одређена држава — јер у било ком скупу података о вестима велики део вредности држава су закључци, а не чињенице. А crawled_at је поуздани временски печат: издавачи рутински постављају ранији датум за published_at, али време прегледа додељује се у оквиру цеви за обраду и увек иде само унапред.

Претрага: Сва параметар који има значај

Сви параметри су опциони. Гола повезивања враћају најновије чланке у индексу.

Упит

• q Упореди се са насловом (тежина 3), описом (тежина 2) и телом чланка. AND семантика — сваки терм мора бити присутан, тако да додавање речи сужава, а не шири резултате. Максимум 500 карактера.

Филтри

Филтри се комбинују са AND преко параметара и OR унутар једног. Тако country=DE,AT&lang=de чита као "чланци на немачком језику из Немачке или Аустрије". Сваки прихвата листу до педесет вредности одвојених зарезима.

Контрола излаза

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"

Бројање пре претраге

Најмање искоришћена крајња тачка у услузи је /v1/stats. Често је корисно питање не „који су чланци“, већ „има ли уопште нечега овде и где се то налази“. Бројање даје одговор уз разломак трошка — приближно два стотина токена у односу на неколико хиљада за страницу резултата — што је чини исправним првим позивом за агента који одлучује да ли је претрага исплатива за покретање.

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

Враћа бројеве по државама, језицима, TLD-овима, издавачима и данима, израчунате за цео подударни скуп, а не само за тренутну страницу. Такође је тако да измерите покривеност пре него што јој верујете. Нефилтрирани снимак у тренутку писања:

Најбоље земље

Најзаступљенији језици

енглески 5.513.650 · шпански 2.699.457 · руски 1.785.796 · турски 1.501.004 · италијански 992.200 · немачки 733.677 · француски 689.136 · арапски 664.016 · португалски 637.607 · хинди 560.840 · грчки 466.504 · јапански 427.085 · вијетнамски 385.719 · румунски 358.766 · кинески 352.720 · украјински 345.809 · корејски 335.079 · персијски 268.126 · пољски 238.904 · бугарски 183.204.

Ова расподела вреди да је мало дуже погледате, јер је супротна ономе што вам већина вести API нуди. Уобичајени корпус који је првенствено на енглеском и усмерен ка САД-у није оно што ово нуди: Индија је рангирана испред Сједињених Држава, турски језик је чешћи од немачког, а грчки, вијетнамски, персијски и бугарски језик имају представљеност у више од сто хиљада. Ако вас занима штампа на неком другом језику осим енглеског, ово је материјално другачији скуп података.

Обим

Дневна крива у by_day обухвата пун деведесодневни период. Дани у последње време крећу се у распону од приближно 400.000 до 700.000 чланака дневно; раније у том периоду, пре него што је слој RSS додат уз архивско уношење, дневни обим је износио 130.000–230.000. Оба нивоа су видљива у истом одговору, што је и суштина — сервис вам показује сопствени раст, а не цитира просек из маркетинга.

Трендови: Шта штампа заиста тренутно обрађује

Претрага одговара на питање „шта је написано о X-у“. Трендови одговарају на другачије, а често и боље питање: „шта се тренутно догађа“ — без потребе за одређеним X-ом.

Робот групише чланке у приче по земљама и одржава их ажурираним. На сваких пет минута нови чланци се прикључују познатим причама преко препознатљивих речи, без икаквог позива моделу; на сваких неколико сати једна земља пролази кроз пун преглед где језички модел чита наслове и од почетка именује приче. У тренутку писања слој трендова обухвата 115 земаља, свака од њих је прерачуната у последњих неколико минута.

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

Свакој причи прате два броја и они имају различита значења. articles (чланци) означава гласност; publishers (издавачи) означава ширину. Прича са 200 чланака из 4 издавача је опсесија једне новинарске куће. Прича са 60 чланака из 40 издавача је догађај. Подразумевано сортирање је по издавачима, а параметри min_publishers и min_articles вам омогућавају да сами поставите праг.

Свијести носе категорију из фиксног скупа: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

Прозор је избор читаоца, а не робота

Ово је заиста елегантно техничко решење. Сваки чланак се чува са временом објављивања и повезује са својом причом, па било који прозор — петнаест минута, сат дана, одређени календарски датум — представља само упит на опсег према истим сачуваним подацима. Једна прорачунска операција служи свим прозорима одједном. window=15m, window=1h, window=24h, date=2026-09-01 или експлицитни пар since/until раде против истог индекса без поновног рачунања.

Кључне речи: речи на којима је вест изграђена

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

Свака кључна реч се враћа са бројем различитих прича које је носе, бројем чланака које те приче садрже, и — најзанимљивијим податком — колико националних медија је користи. Тај последњи број разликује глобалну од домаће приче. Реч која се појављује у седамдесет земаља је светска прича; реч која доминира у медијима једне земље је домаћа прича, без обзира колико је гласна у том медију.

Које земље су активне

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

Враћа све праћене земље са бројем активних прича и бројем минута од када су поново прорачунате — Турска, Русија, Иран, Грчка, Индија, Италија, Украјина, Румунија, Аргентина, Немачка и Бразил тренутно имају по хиљаде активних прича, поновно прорачунате у последњих десет минута. И /v1/trends/{cc}/{slug} отвара било коју појединачну причу са њеним пуним списком чланака.

Тржишта у односу на покривеност: цена на једној оси, пажња на другој

Ово је најнеобичнија ствар у услузи, а постоји зато што корпус чини његово грађење готово бесплатним. Ставите серију цена поред тога колико је свет писао о томе у истим сатима, на једној временској линији.

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

Праћено је четрнаест инструмената, у четири класе имовине:

curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

Та једна порука вам даје курс лире према долару и обим извештавања турских медија за исти период, поређан сат по сат. Турска штампа чини трећи највећи део овог корпуса, што је управо разлог зашто тај пар произноси нешто смислено, а не шум.

И пун блок расположења за Биткоин

Биткоин добија сопствену породицу од седам крачми, јер је то једини инструмент о коме се стално расправља у погледу тона вести и кретања цене, а ретко се мери:

Oznake sentimenta dolaze od modela za obradu prirodnog jezika koji obrađuje sveže kripto članke svakih pet minuta, u odnosu na kalibrisan spisak kovanica. /v1/btc/correlation sa parametrom max_shift je onaj koji treba da koristite ako ste ikada želeli da testirate tvrdnju da „vesti izazivaju pomeranje“ umesto da je samo ponovite.

Ista pretraga, kao feed

Tri dodatna endpointa prihvataju iste parametre za pretragu i prikazuju rezultate u formatima za distribuciju, umesto u formatu JSON:

• GET /v1/rss — RSS 2.0
• GET /v1/atom — Atom 1.0
• GET /v1/feed.json — JSON Feed 1.1

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

To znači da svaka sačuvana pretraga postaje feed koji možete nalepiti u čitač, n8n čvor, Slack integraciju, Zapier okidač ili generator statičkih sajtova — bez koda i bez ključa. Ovo je mala funkcija koja tiho uklanja ceo sloj integracije za nekodere.

MCP: Devetnaest alata, dva sloja

MCP server se nalazi na jednoj URL, koristi Streamable HTTP (JSON-RPC 2.0 preko POST, verzija protokola 2025-06-18), podržava grupisanje zahteva i — kao i sve ostalo ovde — nema korak za autorizaciju niti ID sesije.

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

Izlaže 28 alata u dva svesna sloja.

Prvi sloj: šest prečica koje odgovaraju na celo pitanje jednim pozivom

Sloj dva: svaka krajnja tačka, generisana direktno iz same usluge

Iza prečica, svaka sirova krajnja tačka izložena je kao zaseban alat sa svim parametrima koje API prihvata — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, cela news_get_btc_* porodica, rendereri feedova i news_get_health. Oni su generisani iz aktivne usluge, pa ne mogu odstupati od onoga što API zapravo prihvata.

Dva meta-alata zatvaraju krug: news_list_endpoints vraća katalog svega što postoji, a news_get izvršava sirovi GET na bilo kojoj putanji — tako da agent koji naiđe na krajnju tačku koju njegov spisak alata ne pokriva, i dalje može da do nje dođe.

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

Jedan GET, bez rukovanja, i imate ceo mašinski čitljiv katalog: server, transport, protokol, broj alata, svaki alat sa svojim opisom i svaku krajnju tačku sa svojim spiskom parametara.

Napravljeno da bude čitljivo od strane mašina

Dokumentacija nije naknadno dodata uz {{6} — ona je prvorazredni ishod samog API. Sajt sadrži 665 statičnih stranica, a nekoliko njih postoji specifično da model nikada ne bi morao da čita HTML:

• /openapi.json Пун OpenAPI schema.
• /llms.txt Кратак оријентациони фајл — шта је сервис, које су му крајње тачке (endpoint-и), како га исправно користити за упите и које су грешке могуће.
• /llms-full.txt Цела документација у једном plain-text фајлу, величине преко сто килобајта, како би агент могао да унесе целу ручицу у једном захтеву.
• /agents Тридесет и девет страница намењених искључиво градитељима агената: готове OpenAI дефиниције функција, Anthropic дефиниције за коришћење алата, системски промптови за преузимање вести, RAG рецепти, табеле трошкова токениза и рецепти за агенате.
• /agents/models Код за позивање алата по породицама модела — 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 Шта се налази у корпусу, методологија, schema индекса и страница под називом Квалитет података која документује грешке у скупу података.
• /sources Прегледан каталог од 11.668 издавача, који се може филтрирати по држави, језику и доменској зони.
• /compare Странице са упоредним приказом у односу на NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube и FreeNewsAPI.io.

Плюс 168 страница земаља, 121 страница језика и 275 страница ТЛД-ова — по једна прегледна површина по сегменту корпуса, свака приказује шта се у њему заиста налази.

Потекло чланака

Два пута за унос хране у исти индекс, а разлика између њих је значајна.

Пут архиве

Сваких десет минута задатак проверава CC-NEWS архиву Common Crawl-a на нове WARC фајлове и обрађује све што није раније видео, користећи четрдесет паралелних радника. Извлачач извлачи сваки чланак из сировог прегледања документованим каскадама по пољу — а каскаде су мерењем проверене на стварним подацима, а не претпостављене:

Овај податак о земљи је најискренији, а из тог разлога је поље country_source доступно за сваки чланак: отприлике једна петаина записа нема поуздан сигнал о земљи, а око трећина вредности које постоје су закључци, а не чињенице. API вам показује које је које, уместо да се прави утисак.

Живи пут

Други робот испитује RSS feeds издавача на сваких пет минута, у ротацији са условљеним захтевима — feed који одговара са 304 Not Modified кошта скоро ништа, а интервал испитивања сваког feed-а прилагођен је томе колико често га издавач стварно објављује. Издавач који објављује пет прича дневно не буде преоптерећен захтевима на сваких петнаест минута.

Такође узима само оно што је издавач ставио у feed: наслов, увод и пун текст када га feed садржи. Не приступа сајту издавача да би преузело више података. То је намерна граница, а разлог је зашто сервис може да да обећања која даје на својој правној страници за издаваче.

И механизам око њих

Око два пута за пријем података налази се десетак других робота на распореду: откривање и синхронизација извора, резолиција земље по домену, изградња и ревизија трендова, попуњавање кључних речи, сензибилитет за крипто, повлачење тржишних података, каталог таксономије, задржавање (прозор од деведесет дана се примењује ноћном упитом на published_at, а не старошћу индекса), верификација дана, поновне провере празних чланака и чувар здравља који покреће све што је стаљено. Корпус се чува на посвећеном Elasticsearch кластеру.

Шта овај скуп података не ради добро

Сервис објављује своја ограничења, што је најбржи начин да процените да ли одговара вашем проблему.

• Земља је закључена Прочитајте country_source за сваки чланак и додајте strict_country=true када бројите по земљама, уместо када прегледасте податке.
• published_at је наведено од стране издавача Враћање у прошлост је уобичајено. Сортирајте по crawled када испитујете шта је ново.
• total је ограничено на 10.000 Због брзине. total_is_lower_bound вам каже када сте достигли плафон.
• Нема издвајања сензибилитета или ентитета Иза блокова Биткоина, чланци немају оцену сензибилитета нити издвојене наименоване ентитете. То није у обиму рада.
• Devedeset dana i ništa više Ne postoji dublja arhiva. Ako vam je potreban sadržaj iz 2019. godine, ovo nije pravi alat.
• Bez SLA Besplatno je. Takođe je praćeno i zaštićeno, ali ništa nije obećano pismeno.
• Tekst pripada izdavačima Svaki odgovor uključuje originalni URL, a pozivači se očekuje da kače link ka njemu.

Dobro korišćenje: Troškovi, paginacija i greške

Disciplina tokena

Za agenta, veličina odgovora je pravi trošak. Dokumentovani oblik:

Četrdeset hiljada tokena za dvadeset članaka sa full_text=true je otprilike. Preporučeni obrazac je uvek isti: prebrojite, skenirajte, a zatim preuzmite sadržaj samo za one koje zaista treba.

Kretanje dalje od granice

offset staje na 9.900. Da biste pregledali veliki skup podataka, ne borite se protiv granice — umesto toga, iseckajte podatke po vremenu. Ponavljajte dan po dan ili sat po sat za zahtevne upite, koristeći from/to i sort=date. Dokumentacija ima posebnu stranicu o pregledu celog dana.

Greške

Ugovor je jasan i jednostavan za implementaciju: 4xx znači da je zahtev pogrešan — ispravite ga, ne pokušavajte ponovo. 5xx znači da je servis nedostupan — povucite se. 429 znači usporite i pokušajte ponovo. Nepoznati parametri upita se ignorišu umesto da se odbiju, tako što dodavanje polja nikada neće narušiti rad postojećih klijenata.

Identifikujte se (opciono, i zaista opciono)

Bez ključa nema načina da se kontaktira klijent. Preporučena korektnost 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 vrednosti rade kao obični parametri upita, što je obično lakše:

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

Nepoznati ključevi se ignorišu, tako da je slanje dodatnih ključeva uvek bezbedno. Ništa se ne validira, ništa se ne ograničava zbog izostavljanja, a jedina čvrsta instrukcija je: nikada ne stavljajte lične podatke krajnjih korisnika u ova polja.

Protiv plaćenih vesti APIs

Stranice za poređenje na sajtu pojedinačno pokrivaju jedanaest konkurenata. Strukturalne razlike koje opstaju kod svih njih:

Шта плаћене услуге и даље пружају, а ово не: оцене сентимента и издвајање ентитета као стандардна поља, архиве које сежу годинама уназад и уговор са SLA-ом иза њега. То су стварне ствари, и ако вам требају, требало би да их купите.

Рецепти

Монитор земље уживо

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

Да ли је прича глобална или домаћа?

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

Уземљите модел данашњом покривеношћу, по ниској цени

# 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"

Да ли покривеност води цену?

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

Претворите сачувани претраживач у фид

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

Pronađite medije koji su značajni 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 slice

Kratka verzija

Free News API je pretraga punog teksta preko 21,5 miliona vesti iz više od 25.000 izdavača u 100 zemalja i na otprilike 100 jezika, u okviru od 90 dana koji se kontinuirano osvežava, bez ključa, bez registracije i bez kvote osim ograničenja brzine po IP adresi. Uz samu pretragu, dostupno je grupisanje vesti po zemljama u realnom vremenu za 115 zemalja, analiza ključnih reči koja razdvaja svetske od domaćih događaja, prikaz dvanaest tržišnih instrumenata u odnosu na obim pokrivenosti, blok od sedam tačaka za analizu sentimenta oko Bitcoina, RSS/Atom/JSON distribucija rezultata za bilo koji upit i MCP server sa 28 alata generisan iz same usluge.

Dokumentuje sopstvene stope grešaka, otkriva kako je izvedena svaka vrednost za pojedinačnu zemlju i objavljuje stranicu sa objašnjenjima o tome gde podaci mogu biti netačni. Za agenta kojem je potrebno da sazna šta se dešava u svetu — na turskom, na grčkom, na hindiju, upravo sada — takva kombinacija je teško dostupna po bilo kojoj ceni, a ova je besplatna.

Pretraga koristi logičko I (AND) za sve pojmove. Koristite 2–5 ključnih reči, a ne pitanje u prirodnom jeziku.

Free News API, vodič za dobro korišćenje upita

Započnite ovde: freenewsapi.ai · MCP na freenewsapi.ai/mcp · ceo priručnik kao jedan fajl na /llms-full.txt.