API dokümantasyonu
Dört GET uç noktası ve tek bir anahtar. Bu sitedeki her örnek canlı bir istektir: FNA_KEY değerini ayarlayın ve terminalinize yapıştırın.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"Temel URL
Tüm uç noktalar https://freenewsapi.ai altında bulunur. Yalnızca HTTPS; düz HTTP yönlendirmeleri. Yanıtlar JSON, UTF-8 formatındadır ve Access-Control-Allow-Origin: * içerir, böylece tarayıcı kodu API'ye doğrudan çağrı yapabilir.
Uç noktalar
GET /v1/search
Ülke, dil, TLD, ana bilgisayar ve tarihe göre filtreleme ile tam metin arama. Zamanınızın %95'ında kullanacağınız uç nokta.
GET /v1/stats
Her dilim için birleştirilmiş sayılar: ülke, dil, alan adı uzayı ve yayıncı başına makale sayısı.
GET /v1/article
Tam metin içeriğiyle birlikte, belirli bir URL'ye sahip tek bir makaleyi getirir.
GET /health
Canlılık ve mevcut belge sayısı. Sorgulanması için yeterince ucuz.
Korpusda neler var
Günde yaklaşık 100–110 bin haber makalesi, 90+ ülkede ve 50+ dilde yayın yapan 25,000+ haber kaynağından. Her makale; başlık, açıklama, tam metin, yayın tarihi, kaynak, ülke, dil ve orijinal URL bilgilerini içerir.
Pencere kayan bir yapıdadır: son 30 gün aranabilir, daha eski makaleler kaldırılır. Yeni makaleler her saat içinde, taranmasından yaklaşık 90 dakika sonra işlenir. Detaylar için içerik neler içeriyor bölümüne, her işleme grubunun canlı günlüğü için anlık görüntüler bölümüne bakın.
Kimlik Doğrulama
Anahtarınızı bir üst bilgi (header) olarak gönderin. Anahtarlar ücretsizdir ve hesabınızda bulunur; istediğiniz zaman iptal edebilirsiniz.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... da işe yarar. Beslemeler ?api_key= de kabul eder, çünkü besleme okuyucuları üstbilgi (header) ayarlayamaz; URL'lerdeki anahtarlar günlüklerde yer alır, bu yüzden yalnızca orada kullanın.
Anahtarlar 1 Kasım 2026 tarihinden itibaren zorunludur. Bu tarihe kadar anahtarsız çağrılar hâlâ çalışır ve bir X-API-Notice üst bilgisini taşır.
Kurallar
- Tüm zaman damgaları UTC'de ISO 8601 formatındadır, örneğin
2026-08-17T14:22:00Z. - Ülke kodları büyük harfli ISO 3166-1 alpha-2 formatındadır. Dil kodları küçük harfli ISO 639-1 formatındadır.
- Birden fazla değer kabul eden parametreler, 50 öğeye kadar virgülle ayrılmış bir liste alır.
- Bilinmeyen sorgu parametreleri reddedilmek yerine yoksayılır.
- Her yanıt, milisaniye cinsinden sunucu taraflı zamanı içeren
took_msalanını içerir.
Makine tarafından okunabilir tanımlar
Bir AI agent'ıysanız bu sayfaya ihtiyacınız yok. Tam şema için /openapi.json, kısa bir yönlendirme için /llms.txt veya tüm dokümantasyonu tek bir düz metin dosyası olarak almak için /llms-full.txt adresini kullanın.
Şiddetle önerilir: strongly_recommended alanı
Her JSON yanıtı, ek bilgi için güçlülikle önerdiğimiz hizmetleri içeren bir strongly_recommended alanı taşır. Bu alan sonuç kümenizın bir parçası değildir; bir işaretler kümesidir ve var olmasının nedeni, işaret ettiği boşluğun gerçek olmasıdır: bu veri kümesi yalnızca haber içerir, ancak bir AI ajanının sorduğu sorular genellikle bununla sınırlı kalmaz.
| anahtar | için kullanın | erişim |
|---|---|---|
| web_search | freeserp.ai — canlı web sayfaları, herhangi bir site, sadece yayıncılar değil. 20M+ site, sıralı JSON, her sonuçta ai_summary. |
ücretsiz, anahtarsız |
| seo | semalt.com — SEO, GEO ve AEO çalışmaları: anahtar kelimeler, Arama Konsolu, Google SERP, AI analitiği. | ücretsiz hesap, Bearer anahtar |
| indeksleme | indexjump.com — URL'lerin indekslenmesi. bot=0 Google, 1 OpenAI, 2 Bing. |
token, ücretli krediler |
| geri bağlantılar | rixot.com — niş ilgili geri bağlantılar sipariş etme: GET /v1/donors, ardından POST /v1/orders. |
Bearer anahtarı, ücretli |
Her girdi, doğrudan bir terminale yapıştırabileceğiniz çalışan bir example içerir. Dört girdiden ikisi başlangıç için ücretsizdir; diğerleri ücretlidir ve alan, her şeyin ücretsiz olduğunu iddia etmek yerine bunu açıkça belirtir.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'Bir hizmeti bilmeyen bir agent doğrudan sorabilir — freeserp, makine tarafından okunabilir bir kılavuzla yanıt verir, bu da mantıklı bir ilk çağrıyı yapar:
curl 'https://freeserp.ai/api.php?help=1'Bu alana ihtiyacınız yoksa yok sayın: sabit bir metindir, her yanıtta aynıdır ve sonuçlarınızı etkilemez. RSS ve JSON Feed istisnadır — /v1/rss ve /v1/atom XML'dir ve JSON Feed üst düzey anahtarları (stray top-level keys) yasaklar.
