API Belgeleri
Nudge API
Tüm fiyat istihbaratı verilerinize REST API üzerinden erişin. Her planda dahil, ek ücret yok.
İçindekiler
Tüm istekler HTTPS üzerinden yapılmalıdır. İstek başına maksimum 1.000 kayıt döndürülür.
Base URL: https://api.thenudge.io/v1
Kimlik Doğrulama
API anahtarınızı her istekte Authorization başlığı olarak gönderin. Anahtarınıza Hesap Ayarları bölümünden ulaşabilirsiniz.
Authorization: Bearer YOUR_API_KEY
Ürünler
Ürün kataloğunuzu yönetin.
GET/products
Hesabınızdaki tüm ürünleri listeler.
curl https://api.thenudge.io/v1/products \
-H "Authorization: Bearer YOUR_API_KEY"
POST/products
Yeni bir ürün ekler ve izleme kuyruğuna alır.
{"name":"Nike Air Max 270","sku":"NKE-AM270-42","url":"https://yourstore.com/...","currency":"EUR","your_price":129.99}
Fiyatlar
Rakip fiyat verilerine ve geçmişe erişin.
GET/prices/{product_id}
Bir ürün için tüm rakip fiyatlarını döndürür.
Uyarılar
MAP ihlallerini sorgulayın.
GET/alerts
Son uyarıları listeler. Okunmamışlar önce gelir.
{"alerts":[{"id":"alt_01","type":"map_violation","retailer":"example.de","your_floor":89.99,"listed_price":79.99,"detected_at":"2026-06-16T09:14:22Z"}]}
Öneriler
YZ destekli fiyat önerilerini sorgulayın.
GET/recommendations
Tüm ürünler için önerileri güven skoruna göre döndürür.
{"recommendations":[{"product_id":"prd_01","current_price":129.99,"suggested_price":126.99,"estimated_conversion_uplift":0.09,"confidence":0.87}]}
Hız limiti: Başlangıç planında 60/dk, Büyüme, Ölçek ve Kurumsal planlarda 600/dk.