Free News API: Пълнотекстово търсене върху 21 милиона статии, 25 000 издателя и 100 държави — без никакъв ключ

Новинарските API обикновено се продават на база заявка, задържат се зад ключ и са ограничени до сто заявки на ден за безплатния план. Free News API не е от този тип: 21,5 милиона статии в рамките на последните 90 дни, над 25 000 издателя, без ключ, без регистрация, без лимити, разрешено е търговското използване. Ето цялата функционалност — търсене, статистики, тенденции, пазарни данни, потоци и MCP — и честно описание на грешките в данните.

Формата на проблема

Ако попитате AI агент какви теми се обсъжат по света в момента, той има три лоши опции. Може да скрейпва директно от сайтовете на издателите, което е крехко, бавно и правно неясно. Може да направи заявка към комерсиален новинарски API, което означава акаунт, ключ, месечна такса и — за всеки безплатен план на пазара — сто заявки на ден и статии, забавени с двадесет и четири часа. Или може да предположи въз основа на обучаващи данни, които са остарели преди месеци.

Free News API премахва цената и документацията на средната опция, без да премахва възможностите ѝ. Една GET заявка, без упълномощаване, върху корпус, който към момента на писане съдържа 21 557 044 статии от над двадесет и пет хиляди издателя, поддържани в рамките на последните деветдесет дни и обновявани непрекъснато — най-новата статия в индекса обикновено е на възраст под две минути.

Четири основни крайни точки и още нещо

Основа на услугата са четири GET крайни точки, всички под https://freenewsapi.ai, всички връщащи UTF-8 JSON с Access-Control-Allow-Origin: *, за да могат браузърните скриптове да ги извикват директно, и всички отчитащи време за изпълнение на сървъра в took_ms.

Около това ядро се намират още четири семейства, всяко от които би било самостоятелен продукт в друга среда: trends (кластеризация на актуални истории по държава), markets (редове от цени, съпоставени с обема на отразяване), crypto sentiment (седемкрайни точки за блока на Bitcoin) и syndication (същото търсене, представено като 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"

Това единствено обаждане ви предоставя информация за лирата спрямо долара и обема на отразяването в турската преса за същия период, синхронизирано почасово. Турската преса е третият по големина сегмент в този корпус, което е точно причината това съчетание да генерира смислени данни, а не шум.

И пълен блок за анализ на настроението около биткойна

Биткойнът получава собствено семейство от седем крайни точки, защото това е единственият инструмент, за който тонът на новините и движението на цената се обсъждат непрекъснато, но рядко се измерват количествено:

Етикетите за настроението се генерират от езиков модел, който анализира актуални крипто новини на всеки пет минути спрямо калибриран списък с монети. /v1/btc/correlation с параметър max_shift е точният ендпойнт, който да използвате, ако искате да тествате твърдението „новините причиняват движението“, вместо просто да го повтаряте.

Същото търсене като поток

Три допълнителни ендпойнта приемат идентичните параметри за търсене и връщат резултатите в формати за синдикация, вместо в 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

Това означава, че всяко запазено търсене се превръща в поток, който можете да поставите във четец, възел на n8n, интеграция за Slack, тригер за Zapier или генератор на статични сайтове — без код и без ключ. Това е малка функция, която тихо премахва цял интеграционен слой за потребители без програмен опит.

MCP: Двадесет и осем инструмента, два слоя

Сервърът на MCP се намира на един URL, поддържа Streamable HTTP (JSON-RPC 2.0 чрез POST, версия на протокола 2025-06-18), поддържа батч заявки и — като всичко останало тук — няма стъпка за авторизация и няма идентификатор на сесия.

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

Той предоставя 28 инструмента в два умишлено разделени слоя.

Първи слой: шест бързи команди, които отговарят на цял въпрос с едно обаждане

Слой два: всеки ендпойнт, генериран от самата услуга

Под съкратените пътища всеки сири ендпойнт е изложен като отделен инструмент с всички параметри, които API приема — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, цялото семейство news_get_btc_*, рендерите на фийдове и news_get_health. Те се генерират от работещата услуга, така че не могат да се отклоняват от това, което API всъщност приема.

Два мета-инструмента затварят цикъла: news_list_endpoints връща каталога на всичко, което съществува, а news_get изпълнява суров GET върху всеки път — така че агент, който срещне ендпойнт, който не е покрит от списъка с инструменти, все пак може да го достигне.

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

Един GET, без ръкостискане, и имате цялата машина-четим каталог: сървър, транспорт, протокол, брой инструменти, всеки инструмент с описание и всеки ендпойнт със списък с параметри.

Построен за четене от машини

Документацията не е следобедна добавка към API, а е първокласен нейн продукт. Сайтът предоставя 665 статични страници, а няколко от тях съществуват специално така, че моделът никога да не трябва да чете HTML:

• /openapi.json Пълната схема на OpenAPI.
• /llms.txt Кратък ориентировъчен файл — за какво става въпрос в услугата, крайточките, как да правите запитвания ефективно и какви грешки да очаквате.
• /llms-full.txt Цялата документация в един текстов файл с над сто килобайта, за да може агентът да прочете цялото ръководство с едно изтегляне.
• /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 Какво съдържа корпусът, методологията, схемата на индекса и страница с заглавие Качество на данните, която документира грешките в набора от данни.
• /sources Прегледен каталог с 11 668 издателя, който може да се филтрира по държава, език и домейн зона.
• /compare Страници със сравнение от страна на страна с NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube и FreeNewsAPI.io.

Освен това има 168 страници за държави, 121 страници за езици и 275 страници за TLD — по една преглеждаема повърхност за всяка част от корпуса, показваща какво точно се съдържа в нея.

Откъде идват статиите

Два пътя за поглъщане нахранват един и същ индекс, а разликата между тях е от значение.

Пътят към архива

На всеки десет минути задача проверява архива CC-NEWS на Common Crawl за нови WARC файлове и обработва всичко, което не е виждало досега, използвайки четиридесет паралелни работници. Екстракторът извлича всяка статия от суровия краулинг с документирана каскада за всяко поле — а каскадите бяха измерени спрямо реални данни, а не приети на доверие:

Тази стойност за държава е тази, която е най-честна, и затова country_source е изложен за всяка статия: приблизително една пета от записите нямат изобщо надежден сигнал за държава, а около една трета от съществуващите стойности са изводи, а не факти. API ви показва коя е коя, вместо да прави изкуствени предположения.

Живият път

Вторият робот преглежда източниците RSS на изданието на всеки пет минути, в ротация с условни заявки — източник, който отговаря с 304 Not Modified, струва почти нищо, а интервалът за преглед на всеки източник е настроен според това колко често той публикува. Издание, което публикува пет статии на ден, не се претоварва с заявки на всеки петнадесет минути.

Той също така приема само това, което изданието е поставило във feeds: заглавие, въведение и пълен текст, когато feeds го съдържа. Не влиза в уебсайта на изданието, за да изтегли повече. Това е умишлена граница и това е причината услугата да може да даде обещанията, които дава на своята правна страница за издатели.

И машинерията около тях

Около двата пътя за поглъщане работят още една дузина роботи по разписание: откриване на източници и синхронизация, определяне на държава за всеки домейн, изграждане и одит на тенденции, попълване на ключови думи, крипто настроения, пазарни заявки, каталог с таксономия, задържане (прозорецът от деветдесет дни се осигурява от нощна заявка към published_at, а не от възрастта на индекса), проверка за дни, повторни проверки за празни статии и защитен механизъм за здраве, който рестартира всичко, което е спряло. Корпусът живее на отделен Elasticsearch кластер.

Какви грешки прави този набор от данни

Услугата публикува собствените си ограничения, което е най-бързият начин да прецените дали тя отговаря на проблема ви.

• Държавата е изведена Прочетете country_source за всяка статия и добавете strict_country=true, когато броите по държава, вместо да преглеждате.
• published_at е предоставено от издателя Връщането в миналото е често срещано. Сортирайте по crawled, когато преглеждате за нови съдържания.
• total е ограничено до 10 000 За скорост. total_is_lower_bound ви казва, когато достигнете тавана.
• Няма извличане на настроения или сущности Извън биткойн блока, статиите нямат оценка за настроение и няма именовани сущности. Това не е в обхвата.
• Девдесет дни и не повече Няма по-дълбока архивация. Ако ви трябва информация от 2019 г., това не е подходящият инструмент.
• Без SLA Услугата е безплатна. Тя също така се наблюдава и пази, но нищо не е обещано писмено.
• Текстът е собственост на издателите Всеки отговор включва оригиналния URL, а потребителите се очаква да поставят връзка към него.

Правилно използване: Разходи, пагиниране и грешки

Дисциплина на токените

За агент размерът на отговора е реалният разход. Документираният му формат е:

Двадесет статии с full_text=true са приблизително 40 000 токена. Препоръчителният модел винаги е един и същ: бройте, сканирайте и след това изтегляйте съдържанието само за малкото, от които имате нужда.

Преминаване на лимита при пагиниране

offset спира при 9 900. За да обходите голям набор от данни, не се борете с лимита — вместо това го разделете по време. Цикъл по дни или по часове при натоварени заявки, използвайки from/to и sort=date. Документацията има отделна страница за обхождане на цял ден.

Грешки

Договорът е ясен и лесен за кодиране: 4xx означава, че заявката е грешна — поправете я, без да я повтаряте. 5xx означава, че услугата е недостъпна — намалете честотата. 429 означава, че трябва да забавите темпото и да повторите опита си. Непознатите параметри на заявката се игнорират, вместо да бъдат отхвърлени, така че добавянето на ново поле никога няма да счупи съществуващия клиент.

Идентифицирайте се (по желание и наистина по желание)

Без ключ няма начин да се свържете с клиента. Предложената учтива практика е да използвате заглавка, която посочва вашия агент, фреймуърка, чрез който работи, и модела, който го задвижва:

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>)

Същите стойности работят и като обикновени параметри на заявката, което обикновено е по-лесно:

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

Непознатите ключове се игнорират, така че изпращането на допълнителни ключове винаги е безопасно. Нищо не се валидира, нищо не се ограничава поради липсата му, а единственото ясно правило е: никога не поставяйте лични данни на крайните потребители в тези полета.

Против платените новини API

Страниците за сравнение в сайта покриват единадесет конкурента поотделно. Структурните различия, които оцеляват при всички тях:

Какво все още ви предоставят платените услуги, а това не: оценки за тона и извличане на сущности като стандартни полета, архиви, които датират отпреди години, и договор със задължително изпълнение на ниво 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

Намерете медийните източници, които имат значение на пазара

curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that slice

Кратко резюме

Free News API е пълнотекстово търсене върху 21,5 милиона новинарски статии от над 25 000 издателя в 100 държави и приблизително 100 езика, в подвижен 90-дневен прозорец, непрекъснато обновяван, без ключ, без регистрация и без лимит за квота, освен ограничение на честотата на заявките на база IP. Върху търсенето са разположени живи кластери на истории по държави за 115 държави, анализ на ключови думи, който разграничава световните събития от вътрешните, четиринадесет пазарни инструменти, нанесени спрямо обема на отразяване, блок за биткойн сентимент с седем края, RSS/Atom/JSON синдикация на всяка заявка и 28-инструментален MCP сървър, генериран от самата услуга.

Документира собствените си нива на грешки, показва как е изведен всяка стойност за държава и публикува страница за това, в какво данните могат да бъдат неточни. За агент, който трябва да знае какво се случва по света — на турски, на гръцки, на хинди, точно сега — тази комбинация е трудно достъпна при всяка цена, а тази е безплатна.

Търсенето е с логическо И (AND) за всички термини. Използвайте 2–5 ключови думи, а не въпрос на естествен език.

Free News API, за начините за добро използване на API

Започнете тук: freenewsapi.ai · MCP на freenewsapi.ai/mcp · цялото ръководство като един файл на /llms-full.txt.