GELİŞTİRİCİ KAYNAKLARI

API dokümantasyonu

İçerik güncellemelerini birkaç satırla Arayınca'ya bildirin.

Basit bir API. Yeni keşifler.

Önce alan adınızı doğrulayın, ardından API anahtarınızla gönderim yapın. API anahtarları yönetici işlemlerine erişemez.

1. Alan adınızı doğrulayın

Geliştirici panelinde alan adınızı ekleyin. DNS TXT kaydı veya HTTPS doğrulama dosyası yöntemlerinden birini kullanın. Doğrulama 30 gün geçerlidir; her alt alan adı ayrıca doğrulanır.

Alan adlarımı yönet

2. API anahtarınızı oluşturun

İsteklerde Authorization: Bearer YOUR_API_KEY başlığını gönderin. Tam anahtar yalnız oluşturulurken gösterilir. Anahtarınızı tarayıcıya gömülen koda koymayın; sunucu tarafında kullanın.

API anahtarları

3. Güncelleme bildirin

curl -X POST https://arayinca.com/api/v1/urls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"siteId": 1, "url": "https://ornek.com/yeni-sayfa"}'

Örnekteki siteId ve URL'yi kendi doğrulanmış alanınızla değiştirin. Yanıttaki id ile tarama işini takip edin. 202 yanıtı kuyruğa kabulü belirtir; indeksleme garantisi değildir.

Uç noktalar

Yöntem	Adres	Açıklama
GET	`/api/v1/sites`	Kendi alanlarınız ve doğrulama durumu
POST	`/api/v1/urls`	Tek sayfa gönderimi: siteId, url
POST	`/api/v1/sitemaps`	Sitemap gönderimi: siteId, url
GET	`/api/v1/jobs/:id`	Kendi gönderiminizin durumunu izleme
GET	`/api/search?q=...`	Herkese açık arama: q, type, page, pageSize (1–50), lang (auto / all / tr / en / …)
GET	`/api/search/types`	Arama türleri, kayıt sayıları ve yeniden tarama bekleyen sayfalar

Arama türleri · Beta

type=web varsayılandır. images, news, shopping ve video kendi tür indekslerini arar. Örnek: /api/search?q=teleskop&type=shopping&lang=tr.

Görseller için açıklamalı img, Open Graph veya ImageObject; haberler için NewsArticle ve yayın tarihi; ürünler için Product, Offer, fiyat ve para birimi; videolar için VideoObject veya HTML video verisi kullanılır. Bu veriler sayfa tarandığında alınır; başka arama motorlarından sonuç çekilmez. Güncellemeleri normal URL gönderimiyle bildirebilirsiniz.

Görsel önizlemeleri doğrudan kaynak siteden yüklenir; sunucumuzda görsel dosyası tutulmaz. Videolar kaynak sayfada izlenir. Ürün fiyatı ve stok, son taramada yayıncının beyanıdır. Tür aramalarında yazım düzeltmesi henüz uygulanmaz; metin eşleşmesi, dil filtresi ve site: desteklenir. İlk 1000 aday değerlendirilir; sınıra ulaşıldığında candidateLimitReached döner. Gösterim/tıklama raporları bu sürümde Web aramasına aittir.

Arama dili

lang=auto varsayılandır. Belirgin sorgu dili, varsa tarayıcıda hatırlanan dil tercihleri, ardından Accept-Language değerlendirilir. lang=en yalnız İngilizce, lang=tr yalnız Türkçe; lang=all tüm dillerde sonuç verir. Bölge etiketleri ana dile normalleştirilir.

Yanıttaki language kararın dilini ve kaynağını, availableLanguages aynı sorguyla eşleşen dilleri ve sayıları gösterir. Dil filtresi nedeniyle sonuç bulunamadığında başka dillere sessizce geçilmez.

Sayfa optimizasyonu ve canlı HTML analizi

Doğruladığınız alanın kayıtlı SEO bulgularını inceleyin; bir URL için güncel HTML analizi başlatın. Başlık, açıklama, H1, canonical, mobil viewport, görseller, betikler ve JSON-LD dahil 16 teknik kontrol sunulur. Rapor geçmişi en fazla 30 kayıt ve 90 gündür; JSON olarak indirilebilir.

Analiz robots kurallarına ve ortak tarama kotasına uyar; indeksi değiştirmez. JavaScript çalıştırılmaz. Gösterilen HTML alma süresi ve boyutu, sayfa yüklenme hızı veya Core Web Vitals ölçümü değildir. İndeks güncellemesi için ayrıca URL denetiminden istek gönderin.

Sayfa optimizasyonunu aç

Yanıt ve hata kodları

202 Kuyruğa alındı
400 Geçersiz girdi
401 Kimlik doğrulama gerekli
403 Alan sahipliği veya yetki uygun değil
404 Kayıt bulunamadı
429 İstek veya kuyruk sınırı aşıldı

İlk sürüm sınırları

Gönderimler tam alan adıyla sınırlıdır. Sitemap indeksleri en fazla üç seviye takip edilir. Gönderilen adresler robots.txt kuralları, tarama bütçesi ve içerik uygunluğuna göre işlenir. PDF ve JavaScript render desteği henüz yoktur.