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.

21,5M
indekslenen makale
25,000+
yayıncı
100
ülke
~100
dil
90 gün
kayan pencere
0
API anahtar mevcut
Kural: API anahtarı yok ve olmayacak da. Bunun için bir parametre, gönderilecek bir başlık, oluşturulacak bir hesap veya istek kotası yok; yalnızca saniyede 20 isteklik bir IP bazlı hız sınırı var, böylece bir istemci tüm hizmetin diğer kullanıcılar için kullanılmasını engelleyemez.

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ç NoktaNe Soruya Yanıt Verir
GET /v1/searchFiltreli 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/articleTam metin içeriğiyle birlikte, tam olarak URL adet makale.
GET /healthCanlı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

Bir sohbet robotu gibi değil, bir arama motoru gibi sorgulayın: Bu en yaygın hatadır. Arama tüm terimler arasında VE mantığıyla çalışır, bu nedenle bir cümle yazmak yerine 2–5 anahtar kelime yazın. 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.

FiltreBiçimNotlar
countryISO 3166-1 alpha-2, büyük harfYayıncı ülkesi. Türetilmiş, beyan edilen değil — country_source ve strict_country değerlerine bakın.
langISO 639-1, küçük harfBelgenin kendisinden tespit edilir. %99,9 kapsama.
tldnokta olmadanYayıncının etki alanı uzantısı. tld=ua bir gerçektir; country=UA ise bir çıkarımdır.
hostkesin ana bilgisayar adlarıURL içinde göründükleri gibi — yayıncı www. kullanıyorsa dahil edin.
datebugü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 / toISO tarihlerÖn ayarların uymadığı açık pencere.
strict_countrytrue/falseYalnızca ülkenin bir çıkarım değil, kesin bir gerçek olduğu makaleleri say.

Çıktı kontrolü

ParametreDeğerlerEtki
sortdate · date_asc · crawled · crawled_asc · relevanceYeni 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.
size1–100Sayfa başına sonuç sayısı.
offset0–9900Sayfalama ofseti.
full_texttrue/falseMakale gövdesini dahil et. Varsayılan olarak kapalıdır.
highlighttrue/falseEşleşen fragmentleri döndür.
fieldsCSVYanı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

ÜlkeMakaleler
Hindistan2,286,014
Amerika Birleşik Devletleri2,180,797
Türkiye1,499,897
Rusya1,436,556
İtalya1,057,479
Arjantin826,947
İspanya812,347
Ukrayna662,041
Brezilya551,013
Almanya543,132
Fransa502,846
Yunanistan460,372
Japonya437,209
Vietnam408,934
Meksika402,320
Güney Kore362,945
Romanya354,229
Birleşik Krallık334,379
İran291,782
Polonya255,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ıfEnstrümanlarGranülKaynak
KriptoBitcoin, Ethereum, Solana, XRP, BNB, DogecoinsaatBinance
MetallerAltın (USD/oz)saatBinance
FXEUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLNgünECB
EnerjiAlmanya elektrik fiyatı (EUR/MWh)saatEnergy-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ç NoktaDönüşler
/v1/btc/summaryGüncel fiyat, son hareketler ve bugünkü haberlerin tonu.
/v1/btc/priceAralıklara göre BTC/USDT mum grafikleri.
/v1/btc/sentimentDönem başına haber tonu.
/v1/btc/seriesFiyat ve tonun tek bir zaman çizelgesi üzerinde eşleştirilmesi.
/v1/btc/correlationTona ve fiyat hareketine zaman kaydırması açısından korelasyon — haberler fiyatı mı öncülüyor, yoksa mı takip ediyor?
/v1/btc/newsDuygu durumu etiketiyle kripto haberleri; etiket, yayın yeri, dil ve sorguya göre filtrelenebilir.
/v1/btc/sourcesHangi 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:

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

Bu, 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_publishersMedya kuruluşlarını arayın: ad, alan adı, ülke, dil, günlük makale sayısı.
list_countriesHangi ülkelerde canlı haberler var, kaç tane ve ne kadar güncel.
market_vs_newsKapsama 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:

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
descriptionJSON-LD → meta → OpenGraph → Twitter kartı → articleBody → giriş paragrafı98.1%
language<html lang> → JSON-LD inLanguage → og:locale99.9%
countryccTLD → JSON-LD addressCountry → dil-bölge → og:locale79.1%
dateJSON-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.

İ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 maliyetiNe zaman
/v1/stats~200Öncelikle, aramanın çalıştırılmasının değer olup olmadığını belirleyin.
/v1/search yalnızca meta verilerisayfa başına birkaç binTarama ve seçim.
/v1/search?full_text=trueMakale başına ~900Sadece 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-4o

Bilinmeyen 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:

Diğer platformlardaki ücretsiz planlar

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
Free News API

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
Diğer platformlardaki kapsama

Ö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
Buradaki 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 event

Bir 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=50

Pazarı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 slice

Kı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.