Haber APIleri genellikle istek başına satılır, bir anahtarın arkasına gizlenir ve ücretsiz katmanda günde yüz çağrı ile sınırlıdır. Free News API bunların hiçbiri değildir: 90 günlük kayar pencerede 21,5 milyon makale, 25.000'den fazla yayıncı, anahtar yok, kayıt yok, kotasız, ticari kullanım izinli. İşte tüm yüzey — arama, istatistikler, trendler, pazarlar, beslemeler ve MCP — ve verilerin nerede yanlış yaptığının dürüst bir hesabı.
Sorunun Yapısı
Bir AI aracısına şu anda dünyada ne yazıldığını sorun ve üç kötü seçeneği vardır. Doğrudan yayıncılardan veri çekerek bu veriyi toplayabilir; bu yöntem kırılgan, yavaş ve hukuki olarak bulanıktır. Ticari bir haber API'sine çağrı yapabilir; bu da bir hesap, bir anahtar, aylık bir fatura ve piyasadaki her ücretsiz katmanda günde yüz istek ve makalelerde yirmi dört saatlik gecikme anlamına gelir. Veya aylar önce duran eğitim verilerinden tahminde bulunabilir.
Free News API, orta seçeneğin fiyatını ve evrak işlerini yeteneğini yitirmeden kaldırır. Yazma anında indeksinde 21.557.044 makale barındıran, 25.000'den fazla yayıncının içeriğini içeren, 90 günlük kayar pencerede tutulan ve sürekli yenilenen bir veri kümesi üzerinde bir GET isteği, kimlik bilgisi gerektirmeden — indeksteki en yeni makale genellikle iki dakikadan daha az eski.
Dört Çekirdek Uç Nokta ve Daha Fazlası
Hizmetin çekirdeğini, hepsi https://freenewsapi.ai altında bulunan, tümü UTF-8 JSON döndüren, Access-Control-Allow-Origin: * ile tarayıcı kodlarının doğrudan çağrı yapmasına olanak tanıyan ve sunucu tarafı zamanını took_ms içinde bildiren dört GET uç noktası oluşturur.
| Uç Nokta | Ne Soruya Yanıt Verir |
|---|---|
GET /v1/search | Filtreli tam metin araması. Zamanınızın %95'ini harcadığınız uç nokta. |
GET /v1/stats | Ülke, dil, TLD, yayıncı ve güne göre ayrılmış her dilim için birleştirilmiş sayılar. |
GET /v1/article | Tam metin içeriğiyle birlikte, tam olarak URL adet makale. |
GET /health | Canlılık durumu ve mevcut belge sayısı. Sıklıkla sorgulanabilecek kadar uygun maliyetli. |
Bu çekirdek yapının etrafında, başka yerlerde kendi başına bir ürün olabilecek dört aile daha bulunur: trendler (ülkelere göre canlı hikaye kümelemesi), pazarlar (kapsama hacmine göre hizalanmış fiyat serileri), kripto duygu durumu (yedi uç noktalı Bitcoin bloğu) ve sendikasyon (aynı arama sorgusunun RSS, Atom veya JSON Besleme formatında sunulması). Bunların tümü aşağıda detaylandırılmıştır.
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"
}
]
}Bu yanıttaki üç alan dikkatinizi hemen çekmelidir, çünkü tüm veri setinin dürüstlüğünü kodlarlar. total_is_lower_bound, eşleşme sayısının 10.000 üst sınırına ulaşıp saymaya durduğunda size bilgi verir. country_source, ülkenin nasıl belirlendiğini gösterir — çünkü herhangi bir haber veri setinde ülke değerlerinin büyük bir kısmı gerçekler değil, çıkarımlardır. crawled_at ise güvenilir bir zaman damgasıdır: yayıncılar published_at alanını sıklıkla geriye dönük olarak ayarlar ancak tarama zamanı, veri hattı tarafından atanır ve yalnızca ileriye doğru hareket eder.
Arama: Öneme Sahip Olan Her Parametre
Tüm parametreler isteğe bağlıdır. Boş bir çağrı, dizindeki en güncel makaleleri döndürür.
Sorgu
- q Başlık (ağırlık 3), açıklama (ağırlık 2) ve makale gövdesiyle eşleştirilir. VE mantığı — her terim mevcut olmalıdır, bu nedenle bir kelime eklemek kapsamı genişletmek yerine daraltır. Maksimum 500 karakter.
opec production cut çalışır. what did OPEC decide about oil ise hiçbir sonuç döndürmez.Filtreler
Filtreler, parametreler arasında VE ve tek bir parametre içinde VEYA mantığıyla birleşir. Yani country=DE,AT&lang=de ifadesi "Almanya veya Avusturya'daki Almanca makaleler" anlamına gelir. Her biri, en fazla elli değere kadar virgülle ayrılmış bir liste kabul eder.
| Filtre | Biçim | Notlar |
|---|---|---|
country | ISO 3166-1 alpha-2, büyük harf | Yayıncı ülkesi. Türetilmiş, beyan edilen değil — country_source ve strict_country değerlerine bakın. |
lang | ISO 639-1, küçük harf | Belgenin kendisinden tespit edilir. %99,9 kapsama. |
tld | nokta olmadan | Yayıncının etki alanı uzantısı. tld=ua bir gerçektir; country=UA ise bir çıkarımdır. |
host | kesin ana bilgisayar adları | URL içinde göründükleri gibi — yayıncı www. kullanıyorsa dahil edin. |
date | bugün · dün · 24 saat · 48 saat · 7 gün · 30 gün | Önceden ayarlanmış dönem, published_at değerine göre değerlendirilir. |
from / to | ISO tarihler | Ön ayarların uymadığı açık pencere. |
strict_country | true/false | Yalnızca ülkenin bir çıkarım değil, kesin bir gerçek olduğu makaleleri say. |
Çıktı kontrolü
| Parametre | Değerler | Etki |
|---|---|---|
sort | date · date_asc · crawled · crawled_asc · relevance | Yeni makaleler için sorgulama yaparken crawled ile sıralayın — yayıncılar yayın zamanlarını geriye doğru ayarlar; tarama zamanı yalnızca ileriye doğru ilerler. |
size | 1–100 | Sayfa başına sonuç sayısı. |
offset | 0–9900 | Sayfalama ofseti. |
full_text | true/false | Makale gövdesini dahil et. Varsayılan olarak kapalıdır. |
highlight | true/false | Eşleşen fragmentleri döndür. |
fields | CSV | Yanıtı gerçekten kullandığınız alanlarla sınırlayın. |
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"Aramadan Önce Sayma
Servisteki en az kullanılan uç nokta /v1/stats'tır. Sıkça sorulan yararlı soru "makaleler nelerdir" değil, "burada hiç bir şey var mı ve nerede" şeklindedir. Bu, bir ajanın bir aramanın çalıştırılıp çalıştırılmayacağına karar verirken yapması gereken ilk çağrı olan, bir sonuç sayfası için birkaç bin token'a karşılık yalnızca yaklaşık iki yüz token maliyetle — sonuçları sayarak bu soruyu yanıtlar.
curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"Ülke, dil, TLD, yayıncı ve gün bazında sayıları döndürür; bunlar mevcut sayfa yerine tüm eşleşen küme üzerinde hesaplanır. Bu, güvenmeden önce kapsama nasıl ölçülmesi gerektiğini de gösterir. Yazıldığı anda filtrelenmemiş anlık görüntü:
En çok ülke
| Ülke | Makaleler |
|---|---|
| Hindistan | 2,286,014 |
| Amerika Birleşik Devletleri | 2,180,797 |
| Türkiye | 1,499,897 |
| Rusya | 1,436,556 |
| İtalya | 1,057,479 |
| Arjantin | 826,947 |
| İspanya | 812,347 |
| Ukrayna | 662,041 |
| Brezilya | 551,013 |
| Almanya | 543,132 |
| Fransa | 502,846 |
| Yunanistan | 460,372 |
| Japonya | 437,209 |
| Vietnam | 408,934 |
| Meksika | 402,320 |
| Güney Kore | 362,945 |
| Romanya | 354,229 |
| Birleşik Krallık | 334,379 |
| İran | 291,782 |
| Polonya | 255,599 |
Öne çıkan diller
İngilizce 5.513.650 · İspanyolca 2.699.457 · Rusça 1.785.796 · Türkçe 1.501.004 · İtalyanca 992.200 · Almanca 733.677 · Fransızca 689.136 · Arapça 664.016 · Portekizce 637.607 · Hintçe 560.840 · Yunanca 466.504 · Japonca 427.085 · Vietnamca 385.719 · Romence 358.766 · Çince 352.720 · Ukraynaca 345.809 · Korece 335.079 · Farsça 268.126 · Lehçe 238.904 · Bulgarca 183.204.
Bu dağılımı bir anlığına dikkatle incelemek değer, çünkü çoğu haber API'nin size sunduğunun tam tersi bir durum söz konusu. Genellikle İngilizce ve ABD öncelikli olan veri kümesi burada böyle değil: Hindistan, Birleşik Devletler'i geride bırakıyor; Türkçe, Almanca'yı; Yunanca, Vietnamca, Farsça ve Bulgarca ise altı haneli bir temsiliyete sahip. Sorunuz İngilizce olmayan bir basın ortamıyla ilgiliyse, bu malzeme olarak farklı bir veri setidir.
Hacim
by_day'deki günlük eğri tam doksan günlük pencereyi kapsar. Son günler günde yaklaşık 400.000 ile 700.000 makale aralığında seyrediyor; RSS katmanı arşiv işleme sürecine eklenmeden önceki dönemlerdeki hacim ise günlük 130.000–230.000 makale civarındaydı. Bu iki rakam da aynı yanıtta görülebilir; asıl mesele de budur — hizmet, pazarlama ortalamasını övmek yerine kendi büyüme eğrisini size gösterir.
Trendler: Basın Şu Anda Gerçekte Ne Üzerine Kafa Yoruyor
Arama, "X hakkında ne yazıldı" sorusuna yanıt verir. Trendler ise farklı ve genellikle daha iyi bir soruyu yanıtlar: "şu anda ne oluyor" — X'e gerek kalmadan.
Bir robot, makaleleri ülkeye göre hikayelere gruplandırır ve bunları güncel tutar. Her beş dakikada bir, tanımlayıcı kelimeler aracılığıyla yeni makaleler bilinen hikayelere eklenir; bu işlemde herhangi bir model çağrısı yapılmaz. Her birkaç saatte bir, bir ülke için dil modelinin başlıkları okuyup hikayeleri sıfırdan adlandırdığı kapsamlı bir işlem gerçekleştirilir. Yazdığımız anda trend katmanı 115 ülkeyi kapsamaktadır ve her biri son birkaç dakika içinde yeniden hesaplanmıştı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": [ … ]
}
]
}Her hikayeyle birlikte iki farklı sayı gelir ve bunlar farklı anlamlara sahiptir. articles (makaleler) ses yüksekliğini; publishers (yayıncılar) ise genişliği temsil eder. 4 kaynaktan gelen 200 makalelik bir hikaye bir haber odasının takıntısını yansıtır. 40 kaynaktan gelen 60 makalelik bir hikaye ise bir olayı işaret eder. Varsayılan sıralama yayıncılara göredir ve min_publishers / min_articles ile barı kendiniz belirleyebilirsiniz.
Hikayeler sabit bir kümeden gelen bir kategori taşır: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.
Pencere okuyucunun tercihidir, robotunki değil
Bu, gerçekten zarif bir tasarım kararına sahiptir. Her makale, yayınlanma zamanıyla birlikte saklanır ve hikayesine eklenir; bu nedenle her pencere — on beş dakika, bir saat, bir gün, belirli bir takvim tarihi — aynı saklanan veri üzerinde bir aralık sorgusu gibidir. Tek bir hesaplama, tüm pencereler için aynı anda hizmet verir. window=15m, window=1h, window=24h, date=2026-09-01 veya açık bir since/until çifti, yeniden hesaplama olmadan aynı indeks üzerinde çalışır.
Anahtar kelimeler: haberlerin üzerine inşa edildiği kelimeler
curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"Her anahtar kelime, onu taşıyan distinct hikaye sayısını, bu hikayelerin içerdiği makale sayısını ve — ilginç olanı — ülke basınından kaç tanesinin onu kullandığını döndürür. Son sayı, küresel bir olay ile yerel bir olay arasındaki farktır. Yetmiş ülkede geçen bir kelime dünya haberidir; bir ülkenin basınında baskın olan bir kelime ise, ne kadar gürültülü olursa olsun yerel bir haberdir.
Hangi ülkeler canlı
curl "https://freenewsapi.ai/v1/trends/countries"Takip edilen her ülkeyi, canlı hikaye sayısını ve yeniden hesaplanmasından kaç dakika önce olduğunu döndürür — Türkiye, Rusya, İran, Yunanistan, Hindistan, İtalya, Ukrayna, Romanya, Arjantin, Almanya ve Brezilya şu anda her biri için binlerce canlı hikaye taşımaktadır ve son on dakika içinde yeniden hesaplanmıştır. /v1/trends/{cc}/{slug} ise tek bir hikayeyi tam makale listesiyle birlikte açar.
Piyasalar vs. Kapsama: Bir Eksen Fiyat, Diğer İlgi
Bu, servisteki en alışılmadık şeydir ve varoluş nedeni, korpusun bunu neredeyse ücretsiz bir şekilde inşa etmesini sağlamasıdır. Bir fiyat serisini, aynı saatlerde dünya tarafından o konu hakkında yazılanların miktarının yanına koyun, tek bir zaman çizelgesinde.
curl "https://freenewsapi.ai/v1/markets"Dört enstrüman izlenmektedir, dört varlık sınıfı boyunca:
| Sınıf | Enstrümanlar | Granül | Kaynak |
|---|---|---|---|
| Kripto | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | saat | Binance |
| Metaller | Altın (USD/oz) | saat | Binance |
| FX | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | gün | ECB |
| Enerji | Almanya elektrik fiyatı (EUR/MWh) | saat | Energy-Charts |
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"Bu tek çağrı, size dolar karşısında Türk lirasını ve aynı dönemdeki Türk medyasının kapsama hacmini saatlik olarak eşleştirilmiş şekilde sunar. Türk medyası, bu veri kümesinin üçüncü büyük dilimini oluşturur; bu nedenle bu eşleştirme gürültü yerine anlamlı bir sonuç üretir.
Ve tam bir Bitcoin duygu durumu bloğu
Bitcoin, kendi yedi uç noktalı ailesine sahip oluyor; çünkü haber tonu ile fiyat hareketlerinin sürekli tartışıldığı, ancak nadiren ölçüldüğü tek enstrümant budur:
| Uç Nokta | Dönüşler |
|---|---|
/v1/btc/summary | Güncel fiyat, son hareketler ve bugünkü haberlerin tonu. |
/v1/btc/price | Aralıklara göre BTC/USDT mum grafikleri. |
/v1/btc/sentiment | Dönem başına haber tonu. |
/v1/btc/series | Fiyat ve tonun tek bir zaman çizelgesi üzerinde eşleştirilmesi. |
/v1/btc/correlation | Tona ve fiyat hareketine zaman kaydırması açısından korelasyon — haberler fiyatı mı öncülüyor, yoksa mı takip ediyor? |
/v1/btc/news | Duygu durumu etiketiyle kripto haberleri; etiket, yayın yeri, dil ve sorguya göre filtrelenebilir. |
/v1/btc/sources | Hangi medya kuruluşları kripto para haberlerini ele alıyor ve her biri nasıl bir eğilim sergiliyor? |
Duygu etiketleri, her beş dakikada bir güncel kripto para makaleleri üzerinde çalışan ve kalibre edilmiş bir coin listesiyle karşılaştıran bir dil modelinden gelir. "Haberler hareketi tetikliyor" iddiasını tekrarlamak yerine test etmek istediyseniz, max_shift parametresiyle /v1/btc/correlation endpoint'i tam da aradığınız şeydir.
Aynı Arama, Bir Akış Olarak
Üç ek endpoint, aynı arama parametrelerini alır ve sonuçları JSON yerine syndication formatlarında sunar:
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=dateBu, kaydedilmiş her aramanın, kod yazmaya veya API anahtarına gerek kalmadan, bir okuyucuya, bir n8n düğümüne, bir Slack entegrasyonuna, bir Zapier tetikleyicisine veya statik bir site oluşturucuya yapıştırabileceğiniz bir akışa dönüştüğü anlamına gelir. Bu küçük özellik, programcı olmayanlar için tüm bir entegrasyon katmanını sessizce ortadan kaldırır.
MCP: Yirmi Sekiz Araç, İki Katman
MCP sunucusu tek bir URL adresinde bulunur, Streamable HTTP'yi (POST üzerinden JSON-RPC 2.0, protokol sürümü 2025-06-18) destekler, toplu işlemlere izin verir ve burada her şeyde olduğu gibi — yetkilendirme adımı ve oturum kimliği içermez.
claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcpİki katmanlı olarak 28 aracı ortaya çıkarır.
Birinci katman: Tek bir çağrıda tüm bir soruyu yanıtlayan altı kısayol
| Araç | İçin |
|---|---|
search_news | "X hakkında ne yazıldı?" — tam metin araması, kısaltılmış sonuç. |
get_trends | "Neler oluyor" — makale listesi yerine gruplandırılmış haberler. |
trend_keywords | Şu anda haberlerin temelini oluşturan kelimeler, haber sayıları ve ülke dağılımı. |
find_publishers | Medya kuruluşlarını arayın: ad, alan adı, ülke, dil, günlük makale sayısı. |
list_countries | Hangi ülkelerde canlı haberler var, kaç tane ve ne kadar güncel. |
market_vs_news | Kapsama hacminin yanında bir fiyat serisi. Var olanları görmek için enstrüman belirtmeden çağırın. |
Katman iki: hizmetin kendisinden üretilen her uç nokta
Kısayolların altında, her ham uç nokta API'nın kabul ettiği tüm parametrelerle kendi başına bir araç olarak açığa çıkarılır — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, tüm news_get_btc_* ailesi, besleme renderlayıcıları ve news_get_health. Bunlar canlı hizmetten üretildiği için API'nın gerçekten kabul ettiklerinden sapamazlar.
Döngüyü tamamlayan iki meta araç vardır: news_list_endpoints var olanların tümünün kataloğunu döndürür ve news_get herhangi bir yolda ham bir GET gerçekleştirir — böylece araç listesinde kapsamadığı bir uç nokta ile karşılaşan bir ajan yine de ona ulaşabilir.
curl "https://freenewsapi.ai/mcp?format=json"Bir GET, el sıkışma yok ve tüm makine tarafından okunabilir kataloğa sahip olursunuz: sunucu, taşıma katmanı, protokol, araç sayısı, her aracın açıklaması ve her uç noktanın parametre listesi.
Makineler Tarafından Okunmak Üzere İnşa Edildi
Belgelendirme API'ya sonradan eklenmiş bir düşünce değil — bunun birinci sınıf bir çıktısıdır. Site 666 statik sayfa yayınlar ve bunlardan birkaçı özellikle bir modelin HTML okumasına gerek kalmaması için mevcuttur:
- /openapi.json Tam OpenAPI şeması.
- /llms.txt Kısa bir yönlendirme dosyası — hizmetin ne olduğu, uç noktalar, iyi sorgulama yöntemleri ve hatalar.
- /llms-full.txt Tüm belgelerin tek bir düz metin dosyası halinde sunulması; yüzlerce kilobaytlık bu dosya, bir ajanın tüm kılavuzu tek bir istekle alabilmesini sağlar.
- /agents Ajan geliştiricileri için doğrudan hedeflenmiş otuz dokuz sayfa: hazır OpenAI fonksiyon tanımları, Anthropic araç kullanımı tanımları, haber alma sistem mesajları, RAG tarifleri, token maliyeti tabloları ve ajan tarifleri.
- /agents/models Her model ailesi için araç çağırma kodları — 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çeriği, metodoloji, indeks şeması ve veri setinin hatalarını belgeleyen Veri kalitesi başlıklı bir sayfa.
- /sources Ülkeye, dile ve alan adı uzantısına göre filtrelenabilen 11.668 yayıncının taranabilir bir kataloğu.
- /compare NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube ve FreeNewsAPI.io ile karşılaştırmalı sayfalar.
168 ülke sayfası, 121 dil sayfası ve 275 TLD sayfası eklenir — her bir veri parçası için gezilebilir bir yüzey, her biri içindekilerin gerçekte ne olduğunu gösterir.
Makaleler Nereden Gelir
İki farklı veri alma yolu aynı index'e besleme yapar ve aralarındaki fark önemlidir.
Arşiv yolu
Her on dakikada bir bir görev, Common Crawl'ın CC-NEWS arşivinde yeni WARC dosyaları olup olmadığını kontrol eder ve daha önce görmediği dosyaları kırk paralel işçi kullanarak işler. Çıkarıcı, her makaleyi ham taramadan alan verileri için belgelenmiş bir hiyerarşik öncelik sırası kullanarak ayıklar — ve bu öncelik sıralamaları varsayılan değerler yerine gerçek verilerle ölçülmüştür:
| Alan | Öncelik Sırası | Kapsama |
|---|---|---|
| description | JSON-LD → meta → OpenGraph → Twitter kartı → articleBody → giriş paragrafı | 98.1% |
| language | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| country | ccTLD → JSON-LD addressCountry → dil-bölge → og:locale | 79.1% |
| date | JSON-LD datePublished → meta → trafilatura → tarama zamanı | 100% |
Bu ülke verisi dürüsttür ve tam da bu yüzden country_source her makalede açığa çıkarılır: kayıtların yaklaşık beşte biri hiç güvenilir bir ülke sinyali taşımaz ve var olan değerlerin yaklaşık üçte biri gerçekler yerine çıkarımdır. API, hangi verinin hangisi olduğunu göstererek kafa karışıklığını önler.
Canlı akış yolu
İkinci bir robot, her beş dakikada bir yayıncı RSS beslemelerini kontrol eder; bu süreç, koşullu isteklerle döngü halindedir. 304 Not Modified yanıtı veren bir besleme neredeyse hiçbir maliyet gerektirmez ve her beslemenin kontrol sıklığı, o kaynağın gerçekten ne sıklıkla içerik yayınladığına göre ayarlanmıştır. Günde beş hikaye yayınlayan bir yayıncı, her on beş dakikada bir zorlanmaz.
Ayrıca, yayıncının beslemeye koyduğu şeyler dışında bir şey almaz: başlık, özet ve besleme taşıyorsa tam metin. Yayıncının sitesine gidip daha fazla içerik çekmez. Bu bilinçli bir sınırdır ve hizmetin yayıncıya yönelik hukuki sayfasında sunduğu taahhütleri verebilmesinin nedenidir.
Onları çevreleyen mekanizma
İki veri alma yolunun etrafında, kaynak keşfi ve senkronizasyonu, alan adı başına ülke belirleme, trend oluşturma ve denetim, anahtar kelime tamamlama, kripto duygu analizi, piyasa çekme işlemleri, taksonomi kataloğu, tutarlılık (doksan günlük pencere, indeks yaşına değil, published_at alanı üzerinde gece çalıştırılan bir sorguyla uygulanır), gün doğrulaması, boş makale tekrar kontrolleri ve duran her şeyi yeniden başlatan bir sağlık koruyucusu olmak üzere on iki robot daha görev yapar. Veri kümesi, özel bir Elasticsearch kümesi üzerinde yaşar.
Bu Veri Kümesinin Yanlış Yaptığı Şeyler
Hizmet, kendi sınırlamalarını yayınlamaktadır; bu da hizmetin sizin sorununuza uygun olup olmadığını yargılamadaki en hızlı yoldur.
- Ülke verisi çıkarımdır Her makalede
country_sourceokuyun ve ülke bazlı sayım yapıyorsanız gezinme sırasındastrict_country=trueparametresini ekleyin. - published_at yayıncı tarafından sağlanır Geri tarihleme yaygındır. Yeni içerikleri kontrol ederken
crawledalanına göre sıralama yapın. - toplam değeri 10.000 ile sınırlıdır Hız için.
total_is_lower_bound, limitin aşıldığını size bildirir. - Duygu analizi veya varlık çıkarımı yok Bitcoin bloğu dışında, makalelerde duygu skoru veya adlandırılmış varlık bilgisi bulunmaz. Bu kapsamın dışında kalan bir özelliktir.
- Doksan gün ve daha fazlası değil Daha derin bir arşiv yok. 2019 yılına ihtiyacınız varsa, bu doğru araç değil.
- SLA yok Ücretsizdir. İzlenmekte ve korunmaktadır ancak yazılı olarak hiçbir şey garanti edilmez.
- Metin yayıncılara aittir Her yanıt orijinal URL'i içerir ve arayanlardan buna bağlantı vermesi beklenir.
İyi Kullanım: Maliyet, Sayfalama ve Hatalar
Token disiplini
Bir ajan için yanıt boyutu gerçek maliyettir. Belirtilen şekli:
| Çağrı | Yaklaşık token maliyeti | Ne zaman |
|---|---|---|
/v1/stats | ~200 | Öncelikle, aramanın çalıştırılmasının değer olup olmadığını belirleyin. |
/v1/search yalnızca meta verileri | sayfa başına birkaç bin | Tarama ve seçim. |
/v1/search?full_text=true | Makale başına ~900 | Sadece gerçekten seçtiğiniz birkaçı için. |
full_text=true ile yirmi makale yaklaşık 40.000 token eder. Önerilen kalıp her zaman aynıdır: say, tara, sonra ihtiyacın olan birkaçının içeriklerini getir.
Tavanın ötesine geçiş
offset 9.900'de durur. Büyük bir küme üzerinde gezinirken tavanla mücadele etme — bunun yerine zaman bazlı dilimleme yap. from/to ve sort=date ile gün gün veya yoğun bir sorgu için saat saat döngü kur. Dokümantasyonda tüm günü gezme konusunda özel bir sayfa bulunur.
Hatalar
Sözleşme basit ve kodlaması kolaydır: 4xx istekte hata olduğunu gösterir — düzelt, yeniden dene. 5xx servisin çalışmadığını gösterir — geri çekil. 429 yavaşla ve yeniden dene. Bilinmeyen sorgu parametreleri reddedilmek yerine yoksayılır, bu nedenle bir alan eklemek mevcut bir istemciyi asla bozamaz.
Kendinizi Tanıtın (İsteğe Bağlı ve Gerçekten İsteğe Bağlı)
Anahtar yoksa bir istemciye ulaşmanın bir yolu yoktur. Önerilen nezaket, aracınızı, üzerinden çalıştığı çerçeveyi ve onu çalıştıran modeli adlandıran bir üst bilgi kullanmaktı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>)Aynı değerler düz sorgu parametreleri olarak da çalışır ki bu genellikle daha kolaydır:
https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4oBilinmeyen anahtarlar yoksayılır, bu nedenle ekstra anahtarlar her zaman göndermek için güvenlidir. Hiçbir şey doğrulanmaz, hiçbir şey atlandığı için kısıtlanmaz ve tek talimat nettir: bu alanlarda son kullanıcı kişisel verilerini asla kullanmayın.
Ücretli Haberler API'lerine Karşı
Sitedeki karşılaştırma sayfaları on bir rakibi tek tek kapsar. Bunların hepsinden sağ kalan yapısal farklılıklar:
Günde 100 istek, 24 saat gecikme
Ücretsiz haber-API planlarının standart yapısı: bir demo için yeterli olacak kadar küçük bir token havuzu ve yeni makalelerin ücretli müşteriler için saklanması.
- Anahtar gerekli
- Günlük limit
- Gecikmeli makaleler
- Sadece ticari olmayan kullanım
Limit yok, gecikme yok, anahtar yok
Sınır sadece IP başına saniyede 20 istektir. En yeni makale genellikle iki dakikadan daha az süre önce yayınlanır ve ticari kullanım izin verilir.
- Anahtar yok, kayıt yok
- Günlük veya aylık limit yok
- Kesintisiz yenileme
- Ticari kullanım izin verilir
Öncelikli İngilizce, öncelikli ABD
Çoğu veri kümesi, İngilizce yayıncı listesinin temel alınması ve dünyanın geri kalanının buna eklenmesiyle oluşturulur.
- İngilizce baskın
- Latin olmayan dillerde zayıf kapsama
Hindistan > ABD, Türkçe > Almanca
Yunanca, Vietnamca, Farsça, Ukraynaca ve Bulgarca gibi dillerde altı haneli hacimlere sahip yaklaşık 100 dil.
- 100 ülke
- ~100 dil
- 11.668 kataloglanmış kaynak
Bu hizmetin henüz sağlayamadığı ancak ücretli hizmetlerin sunduğu şeyler: duygu analizi skorları ve varlık çıkarma gibi standart alanlar, yıllar öncesine uzanan arşivler ve bir SLA (Hizmet Seviyesi Anlaşması) garantisi altında sözleşme. Bunlar gerçek değerlerdir; eğer size bu özellikler gerekiyorsa, bunları satın almalısınız.
Tarifler
Canlı ülke izleyicisi
curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"Bu haber küresel mi yoksa yerel mi?
curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world eventBir modeli bugünkü kapsama ile düşük maliyetle temellendirin
# 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"Kapsama fiyatı mı belirliyor?
curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"Kayıtlı bir aramayı bir besin kaynağına dönüştürün
https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50Pazarın önemli haber kaynaklarını bulun
curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that sliceKısa Versiyon
Free News API, 100 ülkede ve yaklaşık 100 dilde, 25.000'den fazla yayıncıdan gelen 21,5 milyon haber makalesi üzerinde tam metin araması yapar; veriler sürekli yenilenen doksan günlük bir pencere içinde, anahtar gerektirmeden, kayıt olmadan ve IP başına hız sınırı dışında kotasız olarak sunulur. Aramanın üzerinde 115 ülke için canlı ülke bazlı haber kümelemesi, dünya olaylarını yerel olaylardan ayıran anahtar kelime analizi, kapsama hacmine karşı çizilen on dört piyasa enstrümanı, yedi uç noktalı Bitcoin duygu analizi bloğu, herhangi bir sorgu için RSS/Atom/JSON sendikasyonu ve servisten üretilen 28 araçlı MCP sunucusu yer alır.
Kendi hata oranlarını belgeler, her ülke değerinin nasıl elde edildiğini ortaya koyar ve verilerin nerede hata yaptığını anlatan bir sayfa yayınlar. Dünyada neler olduğunu — şu an Türkçe, Yunanca, Hintçe olarak — bilmek isteyen bir ajan için bu kombinasyon her fiyata bulunması zor bir özellikken, bu hizmet ücretsizdir.
Arama tüm terimler için AND (VE) mantığıyla çalışır. Doğal dil soruları yerine 2–5 anahtar kelime kullanın.
Free News API, iyi sorgulama hakkında
İşte başlangıç: freenewsapi.ai · freenewsapi.ai/mcp adresinde MCP · tüm kılavuz tek bir dosya halinde /llms-full.txt adresinde.