Free News API: 21 million maqola, 25 000 nashriyot va 100 davlat ustidan to‘liq matnli qidiruv — umuman kalitsiz

Yangilik APIlari odatda so‘rov bo‘yicha sotiladi, kalit orqali cheklanadi va bepul tarifda kuniga yuz marta chaqiruv bilan chegaralanadi. Free News API shularning hech biri emas: 90 kunlik aylana oynada 21,5 million maqola, 25 000 dan ortiq nashriyotlar, kalitsiz, ro‘yxatdan o‘tish shartsiz, kvota yo‘q, tijorat maqsadlarida foydalanishga ruxsat. Bu yerda butun sirt — qidiruv, statistika, trendlar, bozorlar, oqimlar va MCP — va ma’lumotlar qayerda xato qilishini haqqoniy bayon etamiz.

Muammoning shakli

AI agentidan dunyoda hozir nima haqida yozayotganini so‘rasangiz, uning uchta yomon varianti bor. U bevosita nashriyotlardan skrabbing qilishi mumkin, bu noqaror, sekin va huquqiy jihatdan xira. U tijorat yangilik APIiga murojaat qilishi mumkin, bu esa hisob qaydnomasi, kalit, oylik hisob va bozordagi har bir bepul tarifda kuniga yuz marta so‘rov va maqolalarning yigirma soatga kechikishini anglatadi. Yoki u oylar davomida to‘xtatilgan o‘quv ma’lumotlaridan taxmin qilishi mumkin.

Free News API o‘rtancha variantning narxi va hujjatlarini olib tashlaydi, lekin uning imkoniyatini yo‘qotmaydi. Bir GET so‘rovi, akkreditatsiya shartlari yo‘q, yozuv paytida 21 557 044 ta maqolani o‘z ichiga olgan korpus ustida, yigirmidan ortiq nashriyotlardan, 90 kunlik aylana oynada saqlangan va uzluksiz yangilangan — indeksdagi eng yangi maqola odatda ikki daqiqadan ham eski emas.

Toʻrtta Asosiy Endpoint va Boshqalar

Xizmatning asosini GET ta endpoint tashkil etadi, barchasi https://freenewsapi.ai doirasida joylashgan, barchasi UTF-8 formatidagi JSON maʼlumotlarini qaytaradi va Access-Control-Allow-Origin: * sarlavhasi orqali brauzer kodlarining ularga toʻgʻridan-toʻgʻri murojaat qilishiga imkon beradi, shuningdek, took_ms orqali server tomonidan hisoblangan vaqtni koʻrsatadi.

Shu yadro atrofida yana toʻrtta oila joylashgan boʻlib, ularning har biri boshqa joylarda alohida mahsulot boʻlishi mumkin: trendlar (mamlakatlar boʻyicha jonli voqealar guruhlari), bozorlar (narx ketma-ketliklarini yoritish hajmi bilan muvofiqlashtirilgan), kriptovalyutalarga munosabat (Bitcoin blokcheynining yetti nuqtali koʻrsatkichi) va sindikatlash (bir xil qidiruv natijalari RSS, Atom yoki JSON Feed koʻrinishida). Ularning barchasi quyida batafsil koʻrib chiqiladi.

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

Ushbu javobdagi uchta maydon eʼtiborga loyiq, chunki ular butun maʼlumotlar toʻplamining halollik darajasini aks ettiradi. total_is_lower_bound sizga mos keladigan hujjatlar soni 10 000 chegarasiga yetganini va hisoblash toʻxtatilganini bildiradi. country_source mamlakat qanday aniqlanganligini koʻrsatadi — chunki har qanday yangiliklar maʼlumotlar toʻplamida mamlakat qiymatlarining katta qismi fakt emas, balki taxminiy hisoblanadi. crawled_at ishonchli vaqt muhri hisoblanadi: nashr etuvchilar published_at maydonini muntazam ravishda orqaga surishadi, ammo skanerlash vaqti avtomatlashtirilgan tizim tomonidan belgilanadi va faqat oldinga harakatlanadi.

Qidiruv: Muhim boʻlgan barcha parametrlar

Barcha parametrlar ixtiyoriy. Oddiy soʻrov indekstdagi eng yangi maqolalarni qaytaradi.

Soʻrov

• q Sarlavma (ogʻirligi 3), tavsif (ogʻirligi 2) va maqola matni bilan solishtiriladi. AND logikasi — har bir soʻz mavjud boʻlishi kerak, shuning uchun soʻz qoʻshish natijalar doirasini kengaytirish oʻrniga toraytiradi. Maksimal uzunlik — 500 belgi.

Filtrlar

Filtrlar parametrlar boʻyicha AND va bitta parametr ichida OR mantiqida ishlaydi. Shuning uchun country=DE,AT&lang=de "Germaniya yoki Avstriyadan nemis tilidagi maqolalar" degan maʼnoni anglatadi. Har biri elliktagacha qiymatdan iborat vergul bilan ajratilgan roʻyxatni qabul qiladi.

Chiqishni boshqarish

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"

Qidiruvdan oldin hisoblash

Xizmatdagi eng kam ishlatiladigan nuqtasi /v1/stats. Koʻpincha foydali savol maqolalar nima ekanligi emas, balki "bu yerda umuman hech narsa bormi va ular qayerda?" degan savoldir. Hisoblash narxning atigi bir necha yuz tokenini talab qiladi (sahifa natijalari uchun bir necha ming token talab qilinadi), bu esa agentga qidiruvni ishga tushirish maqsadga muvofiq ekanligini hal qilishda birincha chaqiruv sifatida toʻgʻri yondashuvni taʼminlaydi.

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

U mamlakat, til, TLD, nashriyot va kun boʻyicha hisob-kitoblarni qaytaradi, ular toʻliq mos keluvchi toʻplam asosida hisoblanadi, hozirgi sahifa emas. Bu siz ishonch hosil qilishdan oldin qamrovni oʻlchash usuli hamdir. Hozirgi paytda filtrlanmagan tasvir:

Eng koʻp mamlakatlar

Eng ko'p tarqalgan tillar

Ingliz tili 5,513,650 · Ispan tili 2,699,457 · Rus tili 1,785,796 · Turk tili 1,501,004 · Italiyan tili 992,200 · Nemis tili 733,677 · Fransuz tili 689,136 · Arab tili 664,016 · Portugaliya tili 637,607 · Hind tili 560,840 · Yunon tili 466,504 · Yapon tili 427,085 · Vyetnam tili 385,719 · Ruminiya tili 358,766 · Xitoy tili 352,720 · Ukraina tili 345,809 · Koreys tili 335,079 · Fors tili 268,126 · Polsha tili 238,904 · Bulgar tili 183,204.

Ushbu taqsimotni bir zum o'ylab ko'rishga arziydi, chunki u ko'p hollarda APIlar sizga taqdim etadigan ma'lumotlarga qarama-qarshi keladi. Odatdagi ingliz tilida birinchi, AQSh birinchi bo'lgan korpus bu yerda mavjud emas: Hindiston AQShdan ustun turadi, turk tili nemis tilidan ustun turadi, yunon, vyetnam, fors va bulgar tillari ham olti xonali ko'rsatkichga ega. Agar sizning savolingiz ingliz tili bo'lmagan matbuot haqida bo'lsa, bu material jihatdan farq qiluvchi ma'lumotlar bazasidir.

Hajm

by_day dagi kunlik egri chiziq to'liq to'qson kunlik oralig'ni qamrab oladi. So'nggi kunlarda kuniga taxminan 400,000 dan 700,000 gacha maqola chiqadi; arxivni yuklashdan oldin RSS qatlami qo'shilishidan oldin kunlik hajm 130,000–230,000 atrofida edi. Ikkala ko'rsatkich ham bitta javobda ko'rinadi, bu xizmatning marketing o'rtacha ko'rsatkichlarini emas, balki o'zining o'sish dinamikasini ko'rsatishi maqsadga muvofiqdir.

Trendlar: Matbuot hozirda nima haqida xabar bermoqda

Qidiruv "X haqida nima yozilgan" savoliga javob beradi. Trendlar esa boshqa va ko'pincha yaxshiroq savolga javob beradi: "nima bo'layapti" — X kerak emas.

Avtomatlashtirilgan dastur maqolalarni mamlakatlar bo'yicha hikoyalarga guruhlaydi va ularni yangilab boradi. Har beshta daqiqada yangi maqolalar ularni aniqlash so'zlari orqali ma'lum hikoyalarga biriktiriladi, bu jarayonda model chaqiruvi talab qilinmaydi; har bir necha soatda bir mamlakat to'liq tekshiruvdan o'tadi, bu yerda til modeli sarlavhalarni o'qiydi va hikoyalarni boshidan nomlaydi. Hozirgi vaqtda trend qatlami 115 ta mamlakatni qamrab oladi, har bir mamlakat ma'lumotlari so'nggi bir necha daqiqa ichida qayta hisoblanadi.

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

Har bir hikoya bilan ikkita ko'rsatkich keladi va ular har xil ma'noga ega. articles — bu shovqin darajasi; publishers — bu kenglik. Agar bir hikoya 4 nashriyotdan 200 ta maqola bilan kelsa, bu bir nashriyotxona qiziqishidir. Agar bir hikoya 40 nashriyotdan 60 ta maqola bilan kelsa, bu voqeadir. Standart saralash publishers bo'yicha amalga oshiriladi, va min_publishers / min_articles yordamida o'zingiz chegarani belgilashingiz mumkin.

Hikoyalar quyidagi qat'iy to'plamdan kategoriyani oladi: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

Oyna o'quvchining tanlovi, robotnikisi emas

Bu haqiqatan ham nozik dizayn qarori. Har bir maqola nashr etilgan vaqti bilan birga saqlanadi va o'z hikoyasiga bog'lanadi, shuning uchun har qanday oyna — o'n besh daqiqa, bir soat, bir kun, anqiy kalendari sanasi — shu bir xil saqlangan ma'lumotlar ustidan faqat diapazon so'rovidir. Bir hisob-kitob barcha oynalarni bir vaqtning o'zida xizmat qiladi. window=15m, window=1h, window=24h, date=2026-09-01 yoki aniq since/until juftligi hammasi qayta hisoblashsiz bir xil indeksda ishlaydi.

Kalit so'zlar: yangiliklar qurilgan so'zlar

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

Har bir kalit so'z qancha turli hikoya uni o'z ichiga olishi, shu hikoyalarning nechta maqola saqlashi va — qiziqrog'i — uning qancha milliy matbuot organlari tomonidan ishlatilishi haqida qaytariladi. Oxirgi raqam global voqea bilan mahalliy voqea o'rtasidagi farqdir. Yetmish mamlakat bo'ylab paydo bo'ladigan so'z dunyo voqeasi hisoblanadi; bitta mamlakat matbuotida hukmronlik qiladigan so'z esa, qanchalik baland eshitilishidan qat'iy nazar, mahalliy voqeadir.

Qaysi mamlakatlar jonli rejimda

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

Har bir kuzatilayotgan mamlakatni uning jonli hikoya soni va qancha daqiqa oldin qayta hisoblanganligi bilan qaytaradi — Turkiya, Rossiya, Eron, Gretsiya, Hindiston, Italiya, Ukraina, Ruminiya, Argentina, Germaniya va Braziliya hozirda har birida minglab jonli hikoyalarni o'z ichiga oladi va so'nggi o'n daqiqa ichida qayta hisoblangan. Shuningdek, /v1/trends/{cc}/{slug} bitta hikoyani uning to'liq maqolalar ro'yxati bilan ochadi.

Bozorlar vs. Qamrov: Narx bir o'qda, diqqat boshqasida

Bu xizmatdagi eng g'alati narsa va bu korpus uni deyarli bepul qilib qurish imkonini bergani uchun mavjud. Narx ketma-ketligini shu narsa haqida dunyo qancha yozganini bir xil vaqt oralig'ida, bitta vaqt shkalasida joylashtiring.

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

To'rtta aktiv sinfi bo'ylab o'n to'rtta instrument kuzatiladi:

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

Ushbu bir xil so'rov sizga dollar bo'yicha lira kursini va ushbu davr davomida turk matbuoti tomonidan yoritilgan hajmni soatma-soat moslashtirib taqdim etadi. Turk matbuoti ushbu korpusning uchinchi yirik qismidir, aynan shu sababli ushbu juftlik ma'nosiz shovqin emas, balki ma'no-li natija beradi.

Va to'liq Bitcoin hissiyot bloki

Bitcoin oʻzining yettita nuqtali oilasiga ega boʻladi, chunki bu yagona vosita boʻlib, unda yangiliklar ohangi va narx harakati doimiy ravishda muhokama qilinadi, ammo kam oʻlchanadi:

His-tuyg‘u baholari har besh daqiqada yangi kripto maqolalari ustida ishlaydigan til modelidan olinadi va kalibrlangan tangalar ro‘yxatiga asoslanadi. Agar siz "yangiliklar narx o‘zgarishiga sabab bo‘ladi" degan g‘oyani takrorlash emas, balki tekshirib ko‘rishni xohlagan bo‘lsangiz, /v1/btc/correlation endpointi max_shift parametri bilan eng mos keladi.

Bir xil qidiruv — oqim sifatida

Uchta qo‘shimcha endpoint bir xil qidiruv parametrlarini qabul qiladi va natijalarni JSON formatida emas, balki syndikasiya formatlarida taqdim etadi:

• 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

Bu shuni anglatadiki, saqlangan har qanday qidiruv o‘quv dasturiga, n8n tuguniga, Slack integratsiyasiga, Zapier tetiklovchisiga yoki statik veb-sayt generatoriga joylashtirishingiz mumkin bo‘lgan oqimga aylanadi — kod yoki kalit talab qilinmaydi. Bu kichik xususiyat dasturchi bo‘lmagan foydalanuvchilar uchun butun integratsiya qatlamini sokinlik bilan olib tashlaydi.

MCP: Yigirma sakkiz vosita, ikki qatlam

MCP serveri bitta URL manzilida joylashgan, Streamable HTTP (POST orqali JSON-RPC 2.0, protokoli versiyasi 2025-06-18) dan foydalanadi, paketlash imkoniyatini qo‘llab-quvvatlaydi va — bu yerda boshqa hamma narsa kabi — avtorizatsiya bosqichi va sessiya identifikatoriga ega emas.

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

U ikkita maqsadli qatlamda jami 28 ta vositani ochib beradi.

Birinchi qatlam: butun savolga bitta chaqiruv orqali javob beradigan oltita qisqa yo‘l

Ikkinchi qatlam: barcha nuqtalar (endpoint), xizmatning o'zi tomonidan yaratilgan

Qisqartmalar ostida har bir xom nuqta (endpoint) o'zining vositasi sifatida ochiladi va API qabul qiladigan har bir parametrni o'z ichiga oladi — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, butun news_get_btc_* oilasi, oziqlantiruvchi renderlash vositalari va news_get_health. Ular jonli xizmatdan yaratilganligi sababli, ular API haqiqatan qabul qiladigan narsadan og'ishi mumkin emas.

Ikki meta-vosita halqani yopadi: news_list_endpoints mavjud bo'lgan barcha narsalar katalogini qaytaradi, news_get esa har qanday yo'l bo'yicha xom GET bajaradi — shunday qilib, vositalar ro'yxati qamrab olmaydigan nuqtaga duch kelgan agent unga xizmat ko'rsata oladi.

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

Bitta GET, hech qanday qo'l berish (handshake) shart emas, va siz butun mashina o'qiydigan katalogga ega bo'lasiz: server, transport, protokol, vositalar soni, har bir vosita va uning tavsifi, va har bir nuqta (endpoint) va uning parametrlar ro'yxati.

Mashinalar tomonidan o'qilish uchun yaratilgan

Hujjatlashtirma API ga qo'shimcha ravishda yopishtirilmagan — u uning birinchi darajali chiqishidir. Sayt 665 ta statik sahifani taqdim etadi va ularning bir qanchasi maxsus shu maqsadda mavjudki, model hech qachon HTML o'qimasligi kerak:

• /openapi.json Toʻliq OpenAPI sxemasi.
• /llms.txt Qisqacha yoʻnalish fayli — xizmat nima ekanligi, nuqtalar (endpointlar), qanday samarali soʻrov yuborish va xatolar haqida.
• /llms-full.txt Butun hujjatlar bitta oddiy matn faylida, uning hajmi yuzlab kilobaytdan oshadi, shunda agent butun qoʻllanmani bir marta yuklab olish orqali oʻzlashtira oladi.
• /agents Agent yaratuvchilari uchun moʻljallangan oʻttiz toʻqqizta sahifa: tayyor OpenAI funksiya taʼriflari, Anthropic vosita ishlatish taʼriflari, yangiliklarni qidirish uchun tizim promptlari, RAG retseptlari, token xarajatlar jadvali va agent retseptlari.
• /agents/models Har bir model oilasi uchun vositadan foydalanish kodi — 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 Korpus ichida nima borligi, metodologiya, indeks sxemasi va toʻplam qayerda xato qilishini hujjatlashtiruvchi Maʼlumotlar sifati sarlavhasidagi sahifa.
• /sources 11 668 nashriyotchi koʻrgazmali katalogi, mamlakat, til va domen zonasi boʻyicha filtrlash mumkin.
• /compare NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube va FreeNewsAPI.io bilan yonma-yon sahifalar.

Bundan tashqari 168 mamlakat sahifasi, 121 til sahifasi va 275 TLD sahifasi mavjud — korpusning har bir qismi uchun bitta ko'rish yuzasi, har biri unda nima borligini ko'rsatadi.

Maqolalar qayerdan olinadi

Ikki kiritish yo'li bir xil indeksga oziq beradi va ular o'rtasidagi farq muhimdir.

Arxiv yo'li

Har o'n daqiqada bir ish Common Crawl'ning CC-NEWS arxivini yangi WARC fayllari uchun tekshiradi va ko'rmagan narsalarini to'rtta parallel ishchi yordamida ishlaydi. Ekstraktor har bir maqolani xom o'rganishdan maydon bo'yicha hujjatlashtirilgan kaskad yordamida ajratib oladi — va kaskadlar faraz qilingan emas, balki haqiqiy ma'lumotlar asosida o'lchangan:

Mamlakat ko‘rsatkichi — bu haqiqiy ma’lumot, shu sababli country_source har bir maqolada ochiq ko‘rsatiladi: yozuvlarning taxminan beshdan bir qismi ishonchli mamlakat belgisiga ega emas va mavjud qiymatlarning atigi uchdan bir qismi fakt emas, balki taxmin qilingan ma’lumotlardir. API qaysi ma’lumot haqiqiy, qaysi biri taxmin ekanligini aytib beradi, soxta ma’lumotlar bilan o‘zini aldamaydi.

Jonli oqim yo‘li

Ikkinchi robot nashriyotchi RSS oqimlarini har besh daqiqada tekshiradi va shartli so‘rovlar bilan navbatma-navbat ishlaydi — 304 Not Modified (O‘zgartirilmagan) javob qaytaradigan oqim deyarli hech qanday resurs talab qilmaydi va har bir oqimning tekshirish oralig‘i uning haqiqatan ham qanchalik tez yangilanishiga moslashtirilgan. Kuniga besh ta maqola e’lon qiluvchi nashr har o‘n besh daqiqada bosim ostida qolmaydi.

U faqat nashriyotchi oqimga kiritgan ma’lumotlarni oladi: sarlavha, kirish qismi va agar oqimda bo‘lsa, to‘liq matn. U nashriyotchi veb-saytiga boshqa ma’lumotlarni olish uchun kirmaydi. Bu maqsadli chegara bo‘lib, xizmat o‘zining nashriyotchilarga mo‘ljallangan huquqiy sahifasida beradigan va’dalarini amalga oshirishining asosiy sababi shundir.

Va ularni o‘rab turgan mexanizm

Ikki ta asosiy oqim yo‘lidan tashqari, jadval asosida ishlaydigan yana o‘n ikkita robot mavjud: manbani kashf etish va sinxronlashtirish, domen bo‘yicha mamlakatni aniqlash, trendlarni shakllantirish va tekshirish, kalit so‘zlarni to‘ldirish, kriptovalyuta his-tuyg‘ularini tahlil qilish, bozor ma’lumotlarini olish, taksonomiyaviy katalog, saqlash (to‘qqiz kunlik oynasi published_at maydoni bo‘yicha kechqurun ishlaydigan so‘rov orqali amalga oshiriladi, indeks yoshiga emas), kunni tasdiqlash, bo‘sh maqolalarni qayta tekshirish va to‘xtab qolgan barcha jarayonlarni qayta ishga tushiruvchi sog‘liq nazorati. Korpus maxsus Elasticsearch klasterida joylashgan.

Ushbu ma’lumotlar to‘plamida qanday xatoliklar bor

Xizmat o‘z cheklovlarini e’lon qiladi, bu esa uning sizning muammongizga mos kelishini baholashning eng tez yo‘lidir.

• Mamlakat ma’lumoti taxmin qilingan Har bir maqolada country_source maydonini o‘qing va mamlakat bo‘yicha saralash o‘rniga faqat ko‘rib chiqayotgan bo‘lsangiz, strict_country=true parametrini qo‘shing.
• published_at nashriyotchi tomonidan taqdim etilgan Orqaga qaytarib yozish (backdating) keng tarqalgan. Yangiliklarni tekshirayotganingizda crawled (skanerlangan sana) bo‘yicha saralang.
• total qiymati 10 000 bilan cheklangan Tezlik uchun. total_is_lower_bound maydoni siz chegaraga yetganingizda xabar beradi.
• His-tuyg‘ular va ob’ektlarni ajratib olish yo‘q Bitcoin blokidan tashqaridagi maqolalarda his-tuyg‘u bahosi va nomlangan ob’ektlar mavjud emas. Bu ushbu loyiha doirasiga kirmaydi.
• Ninchi kun va undan ko'p emas Chuqurroq arxiv yo'q. Agar sizga 2019-yil kerak bo'lsa, bu vosita sizga mos kelmaydi.
• SLA yo'q U bepul. U nazorat qilinadi va himoya qilinadi, lekin hech narsa yozma shaklda kafolatlanmaydi.
• Matn nashriyotchilarga tegishli Har bir javob asl URLni o'z ichiga oladi va murojaat qiluvchilardan uni orqaga havola qilish kutiladi.

Undan foydalanish: Narx, sahifalash va xatolar

Token intizomi

Agent uchun javob hajmi haqiqiy xarajatdir. Uning hujjatlashtirilgan shakli:

full_text=true bilan yigirma maqola taxminan 40 000 tokenni tashkil qiladi. Tavsiya etilgan usul doimo bir xil: sonini hisoblang, skanerlang, soʻng kerakli ozgina matnlarni yuklab oling.

Chegaradan oshib ketish

offset 9 900 da toʻxtaydi. Katta hajmdagi toʻplam bilan ishlash uchun chegara bilan kurashmang — vaqt boʻyicha kesing. Kunlik yoki band soʻrovlar uchun soatlik ravishda, from/to va sort=date parametrlari yordamida aylana yurib chiqing. Hujjatlarda butun kunni qamrab olishga bagʻishlangan alohida sahifa mavjud.

Xatolar

Shartnoma qattiq va kodlash uchun oson: 4xx soʻrov notoʻgʻri ekanligini bildiradi — uni tuzating, qayta urinmang. 5xx xizmat ishlamayotganini bildiradi — orqaga cheking. 429 sekinlashish va qayta urinishni bildiradi. Nomaʼlum soʻrov parametrlari rad etilmasdan, eʼtiborsiz qoldiriladi, shuning uchun yangi maydon qoʻshish mavjud mijozni buzib qoʻymaydi.

Oʻzingizni tanitish (Ixtiyoriy va haqiqatan ham ixtiyoriy)

Kalit boʻlmasa, mijozga murojaat qilishning iloji yoʻq. Tavsiya etilgan hurmat koʻrsatish — agentingiz, u ishlaydigan framework va uni boshqaruvchi model nomini koʻrsatuvchi sarlavha:

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

Xuddi shu qiymatlar oddiy soʻrov parametrlari sifatida ham ishlaydi, bu odatda osonroq:

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

Nomaʼlum kalitlar eʼtiborsiz qoldiriladi, shuning uchun qoʻshimcha kalitlarni yuborish har doim xavfsiz. Hech narsa tekshirilmaydi, hech narsa uni kiritmaslik uchun cheklanmaydi va yagona koʻrsatma qatʼiy: bu maydonlarga foydalanuvchining shaxsiy maʼlumotlarini qoʻymang.

Toʻlovlı yangiliklarga qarshi APIlar

Saytdagi taqqoslash sahifalari oʻn bir raqobatchini alohida koʻrib chiqadi. Ularning barchasida saqlanib qolgan tuzilma farqlari:

Toʻlovli xizmatlar hali ham nima beradi, bu esa nima bermaydi: hissiy baholash ballari va obyektlarni ajratib olish standart maydonlar sifatida, bir necha yil oldingi arxivlar va SLA kafolati bilan shartnoma. Bular haqiqiy imkoniyatlardir, agar sizga ular kerak boʻlsa, ularni sotib olishingiz kerak.

Retseptlar

Jonli davlat monitori

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

Bu xabar globalmi yoki mahallimi?

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

Modelni bugungi kunning qamrovi asosida arzon narxda asoslash

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

Qamrov narxga taʼsir qiladimi?

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

Saqlangan qidiruvni oqimga aylantirish

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

Bozor uchun muhim nashr manbalarini toping

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

Qisqa versiya

Free News API 100 mamlakat va taxminan 100 tilda 25 000 dan ortiq nashriyotchi tomonidan 21,5 million yangilik maqolalari ustidan to'liq matnli qidiruv bo'lib, 90 kunlik dinamik oynada doimiy yangilanib turadi, API kaliti, ro'yxatdan o'tish va IP manziliga asoslangan cheklovdan tashqari hech qanday kvota talab qilinmaydi. Qidiruv ustida 115 mamlakat bo'yicha jonli yangiliklar guruhlashi, jahon va ichki voqealarni ajratib ko'rsatadigan kalit so'zlar tahlili, 14 ta bozor ko'rsatkichlarini qamrov hajmi bilan solishtirish, 7 ta tugunli Bitcoin hissiyot bloki, har qanday so'rov uchun RSS/Atom/JSON syndikatsiyasi va xizmatning o'zidan hosil qilingan 28 ta asbobli MCP serveri joylashgan.

U o'x xatolik darajalarini hujjatlashtiradi, har bir mamlakat qiymati qanday olinganligini ochib beradi va ma'lumot qayerda xato ekanligi haqida sahna e'lon qiladi. Dunyoda nima deyilayotganini bilishni xohlovchi agent (hozirgi kunda turk, yunon yoki hind tillarida) uchun bunday kombinatsiyani har qanday narxda topish qiyin, bu esa bepul.

Qidiruv barcha kalit so'zlar bo'yicha AND (va) mantig'ida amalga oshiriladi. Tabiiy til savolini emas, balki 2–5 ta kalit so'zni ishlating.

Free News API, undan qanday foydalanish haqida

Bu yerdan boshlang: freenewsapi.ai · freenewsapi.ai/mcp da MCP · butun qo'llanma bitta fayl sifatida /llms-full.txt.