Geliştirici API

News Tanıtım API Dökümanı

Onaylı haber sitelerini güncel fiyat ve metrikleriyle JSON olarak çekin; kendi panelinize, fiyat listenize veya otomasyonunuza entegre edin.

API erişimi nasıl alınır?

API erişimi kişiye özel bir API anahtarı (token) ile sağlanır. Anahtarınızı talep etmek için bizimle iletişime geçin; tanımlandıktan sonra aşağıdaki uç noktayı kullanabilirsiniz.

Uç Nokta

GET https://newstanitim.com/api/urunler

Onaylı tüm tanıtım yazısı (site) ürünlerini döndürür. Yalnızca GET metodu desteklenir. Yanıt application/json; charset=UTF-8 formatındadır ve CORS açıktır.

Yetkilendirme

API anahtarınızı her isteğe Authorization başlığıyla gönderin:

Authorization: Bearer API_ANAHTARINIZ

Alternatif olarak Authorization: API-Key API_ANAHTARINIZ biçimi de kabul edilir. Geçersiz veya eksik anahtarda 403 döner.

Örnek İstekler

cURL
curl -X GET "https://newstanitim.com/api/urunler" \
  -H "Authorization: Bearer API_ANAHTARINIZ"
PHP
$ch = curl_init("https://newstanitim.com/api/urunler");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer API_ANAHTARINIZ"],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($yanit["data"] as $site) {
    echo $site["domain"] . " - " . $site["pricing"]["amount"] . " TRY\n";
}
JavaScript (fetch)
const res = await fetch("https://newstanitim.com/api/urunler", {
  headers: { "Authorization": "Bearer API_ANAHTARINIZ" }
});
const veri = await res.json();
console.log(veri.total_count, veri.data);

Örnek Yanıt (200)

{
  "status": "success",
  "total_count": 124,
  "updated_at": "2026-06-13T11:00:00Z",
  "data": [
    {
      "id": 152,
      "domain": "ornekhaber.com",
      "url": "https://ornekhaber.com",
      "metrics": {
        "google_index": "unknown",
        "moz_da": 42,
        "moz_pa": 38,
        "ahrefs_dr": "unknown",
        "ahrefs_rank": "unknown",
        "site_age": 9
      },
      "attributes": {
        "google_news": "1",
        "link_type": "dofollow",
        "max_outbound_links": "unknown",
        "category": "unknown"
      },
      "pricing": {
        "amount": 750,
        "currency": "TRY"
      },
      "delivery": {
        "estimated_time": "2 İş Günü",
        "status": "active"
      }
    }
  ]
}

Alan Açıklamaları

Alan Tip Açıklama
status string İstek durumu: "success" veya "error".
total_count integer Dönen site sayısı.
updated_at string Yanıtın üretildiği UTC zaman damgası (ISO 8601).
data[].id integer Ürün (site) ID.
data[].domain string Sitenin alan adı.
data[].url string Sitenin tam adresi (https).
data[].metrics.moz_da integer Moz Domain Authority.
data[].metrics.moz_pa integer Moz Page Authority.
data[].metrics.site_age integer Site yaşı (yıl).
data[].attributes.google_news string Google News kaydı: "1" var, "0" yok.
data[].attributes.link_type string Link tipi: "dofollow" veya "nofollow".
data[].pricing.amount number Yayın ücreti.
data[].pricing.currency string Para birimi (TRY).
data[].delivery.estimated_time string Tahmini yayın süresi.
data[].delivery.status string Yayın durumu (active).

"unknown" değerli alanlar ileride doldurulmak üzere şema uyumluluğu için yer tutar.

Hata Kodları

HTTP message Neden
403 Erişim Reddedildi. API anahtarı eksik, hatalı veya pasif.
405 Hatalı api isteği... GET dışında bir HTTP metodu kullanıldı.
··
— sipariş verdi
— · —