Free News API: 21 milyon məqalə, 25.000 nəşriyyat və 100 ölkə üzrə tam mətn axtarışı — heç bir açar olmadan

Xəbər APIləri adətən sorğu əsasında satılır, açar arxasında gizlədilir və pulsuz səviyyədə gündə yüz çağırışla məhdudlaşdırılır. Free News API bunların heç biri deyil: 90 günlük hərəkətli pəncərədə 21,5 milyon məqalə, 25.000-dən çox nəşriyyat, açar yoxdur, qeydiyyat yoxdur, kvota yoxdur, ticari istifadəyə icazə verilir. Bütün səthi — axtarış, statistikalar, tendensiyalar, bazarlar, axınlar və MCP — və məlumatın nələri səhv etdiyinin dürüst hesabatı.

Problemın mahiyyəti

AI agentindən soruşun ki, dünyada hazırda nə yazılır və onun üç pis variantı var. O, birbaşa nəşriyyatlardan məlumat toplaya bilər ki, bu da zəif, yavaş və hüquqi cəhətdən bulanıqdır. O, kommersiya xəbər APIinə müraciət edə bilər ki, bu da hesab, açar, aylıq ödəniş və bazarın bütün pulsuz səviyyələrində gündə yüz sorğu və məqalələrdə yirmi dörd saat gecikmə deməkdir. Və ya o, aylar əvvəl bitmiş təlim məlumatlarından təxmini nəticə çıxara bilər.

Free News API orta variantın qiymətini və sənədləşməsini aradan qaldırır, lakin onun imkanlarını saxlayır. Bir GET sorğusu, şəxsiyyət vəsiqəsi olmadan, o vaxt yazı yazan zaman 21.557.044 məqalə ehtiva edən və iyirmi beş mindən çox nəşriyyatdan olan korpus üzərində, hərəkətli doxsan günlük pəncərədə saxlanılan və daim yenilənən — indeksdəki ən yeni məqalə adətən iki dəqiqədən köhnə deyil.

Dörd əsas endpoint və daha çox

Xidmətin əsasını dörd GET endpointi təşkil edir, hamısı https://freenewsapi.ai ünvanında yerləşir, hamısı UTF-8 JSON qaytarır və Access-Control-Allow-Origin: * başlığı ilə brauzer kodlarının birbaşa onlara müraciət etməsinə imkan verir, həmçinin server tərəfindən took_ms sahəsində vaxtı bildirir.

Bu ətrafda dörd daha ailə var, hər biri başqa yerdə özünəməxsus məhsul olardı: trendlər (ölkə üzrə canlı hekayə klasterləşdirilməsi), bazarlar (qiymət seriyalarının əhatə həcmi ilə uyğunlaşdırılması), kripto duyğuları (yedi nöqtəli Bitcoin bloku) və sindikasiya (ağır sorğunun RSS, Atom və ya JSON Axını kimi təqdim edilməsi). Onların hamısı aşağıda ətraflı nəzərdən keçirilir.

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

Cavabda üç sahə dərhal diqqətə layiqdir, çünki onlar bütün verilənlər bazasının dürüstlüyünü kodlayır. total_is_lower_bound uyğunluq sayının 10.000 həddinə çatdığını və saymağı dayandırdığını göstərir. country_source ölkənin necə müəyyən edildiyini bildirir — çünki hər hansı bir xəbər verilənlər bazasında ölkə dəyərlərinin böyük bir hissəsi faktlar deyil, çıxarılan nəticələrdir. crawled_at isə etibarlı vaxt damğasıdır: nəşrçilər published_at sahəsini adətən geri tarixləndirirlər, lakin axtarış vaxtı pipeline tərəfindən təyin edilir və yalnız irəli hərəkət edir.

Axtarış: Əhəmiyyətli olan hər bir parametr

Bütün parametrlər seçimlidir. Sadə bir çağırış indeksdəki ən yeni məqalələri qaytarır.

Sorğu

• q Başlıq (ağırlıq 3), təsvir (ağırlıq 2) və məqalə mətni ilə uyğunlaşdırılır. AND məntiqi — hər bir termin mövcud olmalıdır, buna görə də söz əlavə etmək genişləndirmək əvəzinə daraldır. Maksimum 500 simvol.

Filtrlər

Filtrlər parametrlər arasında AND və bir parametr daxilində OR ilə birləşir. Beləliklə, country=DE,AT&lang=de "Almaniya və ya Avstriyadan alman dilində məqalələr" mənasını verir. Hər biri əlli dəyərə qədər vergüllə ayrılmış siyahı qəbul edir.

Çıxış nəzarəti

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"

Axtarışdan əvvəl sayma

Xidmətdə ən az istifadə olunan endpoint /v1/stats-dir. Tez-tez faydalı sual "məqalələr hansılardır" deyil, "bura heç nə var, və harada?" olub. Sayma bu suala cavab verməklə daha az xərclə təmin edir — təxminən iki yüz token, nəticələr səhifəsi üçün bir neçə min tokenə qarşı — bu da aqentin axtarışın aparılmasının əlverişli olub-olmadığını qərarlaşdırması üçün doğru ilk çağırışdır.

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

O, ölkə, dil, TLD, nəşriyyat və gün üzrə sayları qaytarır, bütün uyğun gələn dəst üzrə hesablanaraq, cari səhifə deyil. Bu, etibar etməzdən əvvəl örtüyü ölçmək üçün necədir. Filtrlənməmiş anlıq yazma zamanı:

Əsas ölkələr

Əsas dillər

İngilis 5.513.650 · İspan 2.699.457 · Rus 1.785.796 · Türk 1.501.004 · İtalyan 992.200 · Alman 733.677 · Fransa 689.136 · Ərəb 664.016 · Portuqal 637.607 · Hind 560.840 · Yunan 466.504 · Yapon 427.085 · Vyetnam 385.719 · Rumın 358.766 · Çin 352.720 · Ukrayna 345.809 · Koreya 335.079 · Fars 268.126 · Polşa 238.904 · Bolqar 183.204.

Bu paylanma bir anlıq diqqətlə baxmağa layiqdir, çünki bu, çoxlu xəbər APIlərinin sizə verdiyinin əksidir. Adətən ingilis dilində, ABŞ-ın üstünlük təşkil etdiyi korpus belə deyil: Hindistan ABŞ-ı geridə qoyur, türk dili alman dilindən üstündür, yunan, vyetnam, fars və bolqar dilləri altı rəqəmli təmsilçiliyə malikdir. Əgər sualınız ingilis dili olmayan mətbuat haqqındadırsa, bu, material cəhətdən fərqli bir məlumat bazasıdır.

Həcm

by_day-dakı gündəlik əyri doqquz günlük pəncərəni əhatə edir. Son günlər təxminən gündə 400.000 ilə 700.000 məqalə aralığında oturur; pəncərənin əvvəlində, arxiv udulması ilə birlikdə RSS təbəqəsi əlavə edilməzdən əvvəl gündəlik həcm 130.000–230.000 arasında idi. Hər iki rəqəm eyni cavabda görünür, bu da məqsəddir — xidmət marketinq orta qiymətini göstərmək əvəzinə öz artımını göstərir.

Trendlər: Mətbuatın hazırda nələri əhatə etdiyi

Axtarış "X haqqında nə yazıldığı" sualına cavab verir. Trendlər fərqli və tez-tez daha yaxşı bir suala cavab verir: "nə baş verir" — X tələb olunmur.

Robot məqalələri ölkələrə görə hekayələrə qruplaşdırır və onları yeniləyir. Hər beş dəqiqədə yeni məqalələr tanıdıcı sözlərinə görə məlum hekayələrə əlavə olunur, model çağırışı olmadan; hər bir neçə saatda bir ölkə tam keçid keçir, burada dil modeli başlıqları oxuyur və hekayələri sıfırdan adlandırır. Yazma anında trend təbəqəsi 115 ölkəni əhatə edir, hər biri son bir neçə dəqiqə ərzində yenidən hesablanmışdır.

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

Hər hekayə ilə iki say gəlir və onlar fərqli məna daşıyır. articles səs-küyü, publishers isə genişliyi göstərir. 4 nəşrdən 200 məqalə olan bir hekayə bir xəbər otağının obsesiya-sıdır. 40 nəşrdən 60 məqalə olan bir hekayə hadisədir. Default sıralama nəşrlərə görədir və min_publishers / min_articles sizə sərhədi özünüz qoymağa imkan verir.

Hekayələr müəyyən bir siyahıdan seçilən kateqoriya daşıyır: siyasət, biznes, bazarlar, texnologiya, idman, sağlamlıq, elmlər, mədəniyyət, cinayət, münaqişə, hava, cəmiyyət.

Pəncərə oxucunun seçimidir, robotun deyil

Bu, həqiqətən zərif bir dizayn qərarıdır. Hər bir məqalə nəşr vaxtı ilə birlikdə saxlanılır və hekayəyə bağlanır, buna görə də istənilən pəncərə — on beş dəqiqə, bir saat, bir gün, konkret təqvim tarixi — eyni saxlanılan məlumatlar üzərində sadəcə bir aralıq sorğusudur. Bir hesablama bütün pəncərələri eyni anda xidmət edir. window=15m, window=1h, window=24h, date=2026-09-01 və ya açıq since/until cütləri yenidən hesablama olmadan eyni indeks üzərində işləyir.

Açar sözlər: xəbərin əsasını təşkil edən sözlər

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

Hər bir açar söz neçə fərqli hekayənin onu daşıdığını, bu hekayələrin neçə məqalə ehtiva etdiyini və — maraqlı olan odur ki — neçə milli mətbuatın ondan istifadə etdiyini göstərir. Son rəqəm qlobal hadisə ilə yerli hadisə arasındakı fərqi müəyyən edir. Yetmiş ölkədə görünən bir söz dünya hekayəsidir; bir ölkənin mətbuatında dominant olan söz isə orda nə qədər yüksək səslə olsa belə, yerli hekayədir.

Hansı ölkələr canlı rejimdədir

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

İzlənən hər bir ölkəni canlı hekayə sayı və son dəfə nə qədər vaxt əvvəl yeniləndiyi ilə birlikdə qaytarır — Türkiyə, Rusiya, İran, Yunanıstan, Hindistan, İtaliya, Ukrayna, Rumıniya, Argentina, Almaniya və Braziliya hazırda hər biri minlərlə canlı hekayə daşıyır və son on dəqiqə ərzində yenilənib. Həmçinin /v1/trends/{cc}/{slug} hər hansı bir tək hekayəni tam məqalə siyahısı ilə açır.

Bazarlar vs. Əhatə dairəsi: Qiymət bir oxda, diqqət digərində

Bu, xidmətdə ən qeyri-adi məsələdir və korpusun bunu demək olar ki, pulsuz inşa etməyə imkan verməsi səbəbindən mövcuddur. Qiymət seriyasını həmin saatlarda dünya tərəfindən həmin mövzu haqqında nə qədər yazıldığını göstərən məlumatlarla birlikdə bir cərgədə yerləşdirin.

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

Dörd aktiv sinfi əhatə edən on dörd alət izlənir:

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

Bu tək sorğu sizə dollarla nisbətdə lirəni və eyni dövr ərzində Türkiyə mətbuatındakı əhatə həcmini saat-bysaat uyğunlaşdırılmış şəkildə verir. Türkiyə mətbuatı bu korpusun üçüncü böyük hissəsini təşkil edir və məhz buna görə də bu cüt mənalı nəticə verir, səs-küy yox.

Və tam Bitcoin əhval-ruhiyyəsi bloku

Bitcoin-in öz yeddi nöqtəli ailəsi var, çünki bu, xəbər tonu və qiymət hərəkətlərinin daim müzakirə edildiyi, lakin nadir hallarda ölçülən yeganə vasitədir:

Hissat etiketləri, hər beş dəqiqədə təzə kripto məqalələri üzərində işləyən və kalibrlənmiş coin siyahısına əsaslanan dil modelindən alınır. Əgər siz "xəbər hərəkəti yaradır" iddiasını təkrarlamaq əvəzinə test etmək istəmisinizsə, /v1/btc/correlation endpoint-ini max_shift parametri ilə istifadə etməlisiniz.

Ayni axtarış, lakin axın formatında

Daha üç endpoint eyni axtarış parametrlərini qəbul edir və nəticələri JSON formatında deyil, syndikasiya formatlarında təqdim edir:

• 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 o deməkdir ki, saxlanmış hər hansı axtarış, heç bir kod yazmağa və API açarına ehtiyac olmadan, oxuyucu proqramlara, n8n düyünlərinə, Slack inteqrasiyalarına, Zapier tetikleyicilərinə və ya statik sayt generatorlarına yapışdırıla bilən bir axına çevrilir. Bu, proqramçı olmayanlar üçün inteqrasiya təbəqəsini səssizcə aradan qaldıran kiçik bir xüsusiyyətdir.

MCP: İyirmi səkkiz alət, iki təbəqə

MCP serveri bir URL ünvanında yerləşir, Streamable HTTP (POST üzərindən JSON-RPC 2.0, protokol versiyası 2025-06-18) dilini dəstəkləyir, partlama (batching) funksionallığına malikdir və burada olan hər şey kimi — icazə addımına və sessiya ID-sinə ehtiyacı yoxdur.

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

O, iki təbəqədə 28 alət təqdim edir.

Birinci təbəqə: Bir çağırışla bütün suala cavab verən altı qısa yol

Qat iki: hər bir endpoint, xidmət tərəfindən özü yaradılır

Qısaltmaların altında, hər bir xam endpoint API qəbul etdiyi bütün parametrlərlə fərdi bir alət kimi açılır — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, bütün news_get_btc_* ailəsi, ləzzət vericilər (feed renderers) və news_get_health. Bunlar canlı xidmətdən yaradıldığı üçün API-nın həqiqətən qəbul etdiyi şeydən kənara çıxa bilməzlər.

Dövrəni tamamlayan iki meta-alət var: news_list_endpoints mövcud olanların kataloqunu qaytarır, news_get isə hər hansı bir yolda xam GET həyata keçirir — beləliklə, alət siyahısında olmayan bir endpointlə qarşılaşan agent yenə də ona çatmağa qadir olur.

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

Bir GET, heç bir əl sıxma prosesi yoxdur və siz bütün maşın oxuna bilən kataloqa sahib olursunuz: server, nəqliyyat, protokol, alət sayı, hər bir alət və onun təsviri, hər bir endpoint və onun parametrlər siyahısı.

Maşınlar tərəfindən oxunmaq üçün hazırlanıb

Sənədləşdirmə API-ya sonradan yapışdırılmış bir fikir deyil — onun birinci dərəcəli çıxışıdır. Sayt 665 statik səhifə təqdim edir və onların bir neçəsi xüsusi olaraq bir modelin HTML oxumasına ehtiyac qalmaması üçün mövcuddur:

• /openapi.json Tam OpenAPI sxeması.
• /llms.txt Qısa istiqamətləndirmə faylı — xidmətin nə olduğu, endpointlər, necə düzgün sorğu etmək və xətalar haqqında.
• /llms-full.txt Bütün sənədləşmənin bir sadə mətn faylı kimi, yüzlərlə kilobayt həcmində, beləliklə agent bütün təlimatı bir dəfə yükləməklə udula bilər.
• /agents Agent qurucuları üçün nəzərdə tutulmuş otuz doqquz səhifə: hazır OpenAI funksiya tərifləri, Anthropic alət istifadəsi tərifləri, xəbər əldəetməsi üçün sistem promptları, RAG reseptləri, token xərc cədvəlləri və agent reseptləri.
• /agents/models Hər model ailəsi üçün alət çağırışı kodu — 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 Korpusun içində nə olduğu, metodologiya, indeks sxeması və verilənlər bazasının nələri səhv etdiyini sənədləşdirən Verilənlər keyfiyyəti adlı səhifə.
• /sources 11.668 nəşriyyatçının brauzer kataloqu, ölkə, dil və domen zonası üzrə filtrlənə bilən.
• /compare NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube və FreeNewsAPI.io ilə yanaşı səhifələr.

Həmçinin 168 ölkə səhifəsi, 121 dil səhifəsi və 275 TLD səhifəsi mövcuddur — korpusun hər bir hissəsi üçün ayrı bir səhifə mövcuddur və hər birində həmin hissədə nənin olduğunu göstərir.

Məqələlər haradan gəlir

Eyni indeksi qidalandıran iki qəbul yolu var və onların arasındakı fərq önəmlidir.

Arxiv yolu

Hər on dəqiqədə bir iş Common Crawl'ın CC-NEWS arxivində yeni WARC fayllarını yoxlayır və daha əvvəl görmədiyi faylları işləyir. Bu proses dörddə bir paralel işçi ilə həyata keçirilir. Mətn çıxarıcı hər bir məqaləni xammal kimi toplanmış məlumatlardan xaric edir və sahələr üzrə sənədləşdirilmiş kaskad metodundan istifadə edir — və bu kaskadlar fərziyyəyə əsaslanmadan, real məlumatlar üzərində ölçülmüşdür:

Bu ölkə göstəricisi etibarlıdır və məhz buna görə country_source hər bir məqalədə açıq şəkildə göstərilir: qeydlərin təxminən beşdə biri üçün etibarlı ölkə siqnalı yoxdur və mövcud qiymətlərin təxminən üçdə biri faktlar deyil, fərziyyələrdir. API sizə hansının hansı olduğunu göstərir, yəni saxtakarlıq etmir.

Canlı axın yolu

İkinci robot hər beş dəqiqədə bir nəşrçi RSS axınlarını yoxlayır və şərti sorğularla növbələşir — 304 Not Modified cavabı verən axınlar demək olar ki, heç bir xərc tələb etmir və hər axının yoxlama intervalı onun həqiqətən nə qədər tez-tez məlumat yayması ilə tənzimlənir. Gündə beş məqalə dərc edən nəşr yerinin hər on beş dəqiqədə bir yük altına düşməsinə ehtiyac yoxdur.

O, nəşrçinin axında yerləşdirdiyi məlumatları da götürür: başlığı, giriş hissəsini və axın onu daşıdıqda tam mətni. O, daha çox məlumat əldə etmək üçün nəşrçinin saytına daxil olmur. Bu, məqsədli bir sərhəddir və məhz buna görə xidmət öz nəşrçi üzrü hüquqi səhifəsində vəd etdiyi sözleri verə bilir.

Və onları əhatə edən mexanizm

İki qəbul yolunun ətrafında cədvəllərə əsaslanan on daha çox robot fəaliyyət göstərir: mənbənin aşkarlanması və sinxronizasiyası, domen başına ölkə müəyyenləşdirilməsi, trendlərin qurulması və audit, açar söz geri doldurma, kriptovalyuta duyğuları, bazar məlumatları, taksonomiya kataloqu, saxlama (doqquz günlük pəncərə published_at üzrə gecə sorğusu ilə tətbiq olunur, indeks yaşı ilə deyil), gün təsdiqi, boş məqalələrin yenidən yoxlanması və dayanan hər şeyi yenidən başladan sağlamlıq nəzarətçisi. Korpus xüsusi Elasticsearch klasterində yerləşir.

Bu Məlumat Bazasının Səhvləri

Xidmət öz məhdudiyyətlərini dərc edir ki, bu da onun sizin problemə uyğun olub-olmadığını qiymətləndirməyin ən sürətli yoludur.

• Ölkə fərziyyə əsasında müəyyən edilir Hər məqalədə country_source-u oxuyun və ölkəyə görə sayma aparırsınızsa, strict_country=true əlavə edin.
• published_at nəşrçi tərəfindən təmin edilir Geri tarixləmə geniş yayılıb. Yeni məlumatları yoxlayarkən crawled üzrə sıralayın.
• total 10 000-ə qədər məhdudlaşdırılır Sürət üçün. total_is_lower_bound sizə həddə çatdığınızı bildirir.
• Duyğu və varlıq çıxarılması yoxdur Bitcoin bloku xaricində məqalələrdə duyğu balı və adlı varlıqlar yoxdur. Bu, hədəf çərçivəsində deyil.
• Doqquz gün və daha çox Daha dərin arxiv yoxdur. Əgər sizə 2019-cu il lazımdırsa, bu, yanlış vasitədir.
• SLA yoxdur Pulsuzdur. O, həm də nəzarət altında və qorunur, lakin heç bir söz yazılı şəkildə verilmir.
• Mətn nəşrçilərə aiddir Hər cavab orijinal URL mənbəyini ehtiva edir və istifadəçilərdən bu mənbəyə istinad etməsi gözlənilir.

Düzgün istifadə: Xərc, səhifələmə və xətalar

Token intizamı

Agent üçün cavab ölçüsü əsl xərctir. Onun sənədləşdirilmiş forması:

full_text=true ilə iyirmi məqalə təxminən 40.000 token təşkil edir. Tövsiyə olunan nümunə həmişə eynidir: say, skana et, sonra yalnız lazım olanların bədənini yüklə.

Tavanı keçən səhifələmə

offset 9.900-də dayanır. Böyük dəstəni gəzmək üçün tavana qarşı mübarizə aparmaq əvəzinə, zamanla bölün. from/to və sort=date ilə günü-günə və ya məşq sorğusunda saat-saat döngə qurun. Sənədləşdirmədə bütün günü gəzmək üçün ayrılmış səhifə var.

Xətalar

Müqavilə aydın və kodlaşdırmağa asandır: 4xx sorğunun yanlış olduğunu göstərir — düzəldin, təkrar cəhd etməyin. 5xx xidmətin işləmədiyini göstərir — geri çəkilin. 429 yavaşlayın və təkrar cəhd edin. Naməlum sorğu parametrləri rədd edilmək əvəzinə nəzərə alınmır, buna görə sahə əlavə etmək mövcud çağırıcını heç vaxt pozmur.

Özünüzü Tanıtın (İstəyə Bağlı və Həqiqətən İstəyə Bağlı)

Açar olmadan çağırıcıya çatmaq mümkün deyil. Tövsiyə olunan mədəniyyət agentinizi, işlədiyi çərçivəni və onu idarə edən modeli adlandıran başlıqdır:

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

Eyni dəyərlər sadə sorğu parametrləri kimi işləyir ki, bu da adətən daha asandır:

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

Naməlum açarlar nəzərə alınmır, buna görə əlavə açarları göndərmək həmişə təhlükəsizdir. Heç nə yoxlanmır, heç nə onu buraxmağa görə throttling edilmir və yeganə təlimat qatıdır: bu sahələrdə son istifadəçinin şəxsi məlumatlarını heç vaxt yerləşdirməyin.

Ödənişli Xəbərlərə API qarşı

Saytdakı müqayisə səhifələri on rəqib fərdi şəkildə əhatə edir. Onların hamısından sağ çıxan struktur fərqlər:

Bu xidmətin hələ də ödənişli xidmətlərin verdiyi lakin bu xidmətin vermədiyi şeylər: standart sahələr kimi duyğu balı və varlıq çıxarılması, illər geriyə gedən arxivlər və SLA ilə təmin edilmiş müqavilə. Bunlar realdır və sizə lazımdırsa, onları almalısınız.

Reseptlər

Canlı ölkə monitoru

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

Bu xəbər qlobaldır, yoxsa daxili?

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

Modeli bu günün örtüyü ilə ucuz baza verin

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

Örtük qiyməti idarə edir?

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

Yadda saxlanmış axtarışı ləngitməyə çevirin

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

Bazarın vacib olduğu mənbələri tapın

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

Qısa versiya

Free News API, 100 ölkədə və təxminən 100 dildə 25.000-dən çox nəşriyyatdan 21,5 milyondan çox xəbər məqaləsi üzərində tam mətn axtarışıdır. Məlumatlar doqquz günlük pəncərədə, ardıcıl olaraq yenilənir, açar tələb olunmur, qeydiyyat yoxdur və IP başına limitdən başqa kvota yoxdur. Axtarışın üzərində 115 ölkə üzrə canlı xəbər klasterləşdirilməsi, dünya hadisələrini daxili hadisələrdən ayıran açar söz təhlili, 14 bazar vasitəsinin əhatə həcmi ilə əlaqələndirilməsi, yedi endpointli Bitcoin əhval-əhval blokunun analizi, RSS/Atom/JSON formatında istənilən sorğu üçün sindikasiya və xidmət tərəfindən yaradılan 28 alətlik MCP serveri yerləşir.

O, öz xəta faizlərini sənədləşdirir, hər bir ölkə dəyərinin necə əldə edildiyini göstərir və məlumatların harada səhv etdiyini izah edən səhifəni dərc edir. Dünyanın nə dediyini bilməli olan bir agent üçün — bu an Türkcədə, yunanca və ya hindcədə — bu cür kombinasiyanı hər hansı qiymətə tapmaq çətindir, bu isə pulsuzdur.

Axtarış bütün terminlər üzrə AND (VƏ) prinsipinə əsaslanır. Təbii dil sualı deyil, 2–5 açar söz istifadə edin.

Free News API, onunla necə düzgün işləmək barədə

Buradan başlayın: freenewsapi.ai · freenewsapi.ai/mcp üzərində MCP · bütün təlimat bir fayl olaraq /llms-full.txt.