API

URL indeksleme API'si

Tek uç nokta, tek anahtar. Google ve Bing gönderimlerini CMS'inizden, otomasyonlarınızdan veya kendi panelinizden yapın. Panel ile aynı kredi kuralları ve limitler geçerlidir.

Ücretsiz hesap aç API anahtarı oluştur

Başlarken

Ücretsiz hesap açın ve kredi yükleyin.
Panelde API sayfasından anahtarınızı oluşturun (ai_live_…). Anahtar yalnızca bir kez gösterilir.
İsteklerinizde X-Api-Key başlığıyla gönderin. Tüm yanıtlar JSON'dur.

Gönderim uç noktası

POST https://anindaindex.com/v1/index

Başlık: X-Api-Key: ai_live_…
engine: "google" veya "bing"
instant: Yalnızca Google. true ise Anında mod (10 kredi/URL)
name: İsteğe bağlı proje adı (en fazla 80 karakter)
urls: URL dizisi, en fazla 200 adet
Sınır: Anahtar başına saniyede 1, dakikada 60 istek. Dakikada 10, saatte 20 gönderim; 24 saatte 2.000 URL. Anında modda iş başına en fazla 50 URL.
Idempotency-Key: İsteğe bağlı başlık (8–100 karakter). Aynı anahtarla tekrar gönderilen istek yeni iş açmaz, ilk yanıtı döner. Aynı URL listesi 10 dakika içinde tekrar gönderilirse HTTP 409 döner.

Google örneği

curl -X POST https://anindaindex.com/v1/index \
  -H "X-Api-Key: ai_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "engine": "google",
    "instant": false,
    "name": "kampanya-1",
    "urls": ["https://ornek.com/sayfa-1", "https://ornek.com/sayfa-2"]
  }'

Bing örneği

curl -X POST https://anindaindex.com/v1/index \
  -H "X-Api-Key: ai_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"engine": "bing", "urls": ["https://ornek.com/sayfa-1"]}'

Başarılı yanıt

{ "ok": true, "projectId": "31a4aa54-2ed9-4092-ae93-c2ddb7930f9e", "creditsUsed": 2 }

Çift gönderime karşı (önerilir): aynı anahtarla tekrar gönderilen aynı istek yeni iş açmaz, ilk yanıtı "idempotentReplay": true ile döner; anahtar farklı bir istekle kullanılırsa 409 döner

curl -X POST https://anindaindex.com/v1/index \
  -H "X-Api-Key: ai_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kampanya-1-2026-09-21" \
  -d '{"engine": "google", "urls": ["https://ornek.com/sayfa-1"]}'

Hata yanıtı

{ "ok": false, "error": "Yetersiz kredi" }

HTTP	Anlamı
400	Geçersiz istek, geçersiz URL veya yetersiz kredi
401	API anahtarı eksik veya geçersiz
403	Hesap devre dışı
404	Proje bulunamadı (yalnızca kendi projelerinizi sorgulayabilirsiniz)
409	Aynı URL listesi son 10 dakikada gönderildi veya Idempotency-Key farklı bir istekle yeniden kullanıldı
429	İstek veya gönderim sınırı aşıldı; `Retry-After` başlığındaki saniye kadar bekleyin
503	Günlük sistem kapasitesi doldu

Durum ve bakiye

Proje durumu: queued (kuyrukta), submitting (gönderiliyor), submitted (gönderildi), processed (işlendi), failed (hata, kredi iade edildi).

curl https://anindaindex.com/v1/projects/PROJE_ID -H "X-Api-Key: ai_live_xxxxxxxxxxxxxxxxxxxxxxxx"

Durum yanıtı

{
  "ok": true,
  "project": {
    "id": "31a4aa54-2ed9-4092-ae93-c2ddb7930f9e",
    "name": "kampanya-1",
    "engine": "google",
    "mode": "fast",
    "urlCount": 2,
    "creditsUsed": 2,
    "status": "processed",
    "error": null,
    "createdAt": "2026-09-21T20:38:29.742Z",
    "processedAt": "2026-09-21T20:52:00.000Z"
  }
}

Bakiye

curl https://anindaindex.com/v1/balance -H "X-Api-Key: ai_live_xxxxxxxxxxxxxxxxxxxxxxxx"