Geliştirici API

Kimlik doğrulama

Anahtarlar yönetim panelinden üretilir ve yalnızca bir kez gösterilir. Her isteğe şu başlığı ekle:

Authorization: Bearer eu_xxxxxxxx.gizli-anahtar

Varsayılan sınır dakikada 600 istektir. Aşılırsa 429 döner.

GET /api/v1/search

Tek aramada ürün, işletme ve fırsatları döner. Sorgunun niyeti (alan, şehir, kategori) de çözümlenir.

q (zorunlu, 2–120 karakter)
module: shopping | local | deals
city: ör. İstanbul
limit: 1–50

{
  "query": "iphone 16",
  "intent": { "module": "shopping", "city": null, "category": {"name": "Cep Telefonu"} },
  "products": [{
    "id": 1, "name": "Apple iPhone 16 128 GB", "min_price": 64999, "currency": "TRY",
    "offer_count": 5, "price_drop_pct": 3.2, "url": "https://enuygunlar.com/urun/…", "sample": false
  }],
  "businesses": [], "deals": [], "sponsored": [],
  "generated_at": "2026-10-11T10:00:00+03:00"
}

GET /api/v1/products/{slug}

Ürünün tüm canlı mağaza tekliflerini döner. Her teklifte mağaza, doğrulama durumu, fiyat, kargo, stok, checked_at ve yönlendirme bağlantısı bulunur.

GET /api/v1/businesses/{slug}

İşletme profilini, fiyat listesini ve çalışma saatlerini döner.

Gösterim kuralları

Fiyatı gösterirken kaynağı (mağaza) ve güncelliği (checked_at) belirt.
sponsored listesindeki kayıtları “Sponsorlu” etiketiyle göster.
sample: true kayıtları canlı arayüzde gösterme.
Yönlendirmeleri url alanıyla yap; tıklama istatistiği buna bağlıdır.

Kategoriler