Hepsiburada API: ürün, fiyat ve satıcı tekliflerini JSON olarak okuyun
Hepsiburada'nın geliştirici programı mağaza sahiplerine açıktır ve size kendi kataloğunuzu verir. Pazarın tamamını okumak, yani bir ürünü kimlerin kaça sattığını görmek istiyorsanız bu API onu yapar: mağaza hesabı istemez, altı ucun tamamı tek anahtarla çalışır, fiyat TL cinsinden sayı olarak gelir.
Uçlar
| endpoint | Ne döndürür | Zorunlu |
|---|---|---|
| search | Anahtar kelimeyle arama. Her satırda sku, başlık, marka, fiyat, indirim, puan ve yorum sayısı; fiyat ve marka filtreleri ile sıralama desteklenir. | query |
| product/detail | Tek ürünün tamamı: başlık, marka, fiyat, indirim, görseller, özellikler ve kampanya bilgisi. `url` ya da HB kodu (`sku`) ile çağrılır. | hepsi opsiyonel |
| product/offers | Asıl soruyu cevaplayan uç: buybox dahil o ürünü satan her mağaza, fiyatıyla ve satıcı bilgisiyle yan yana. | hepsi opsiyonel |
| product/reviews | Sayfalı müşteri yorumları, istediğiniz sırada. `sort=newest` en yeniden başlar. | hepsi opsiyonel |
| category | Kategori sayfasını yoluyla gezin. `category` değeri '<slug>-c-<id>' biçimindedir, örneğin 'laptop-notebook-c-98'. | category |
| seller | Mağaza profili ve o mağazanın ürün kataloğu, mağaza kısa adıyla. | seller |
Her çağrı kredi ile ücretlendirilir. Başarısız ve engellenen çağrılar ücretsizdir.
Çalışan örnek
Aramadan bir sku alın, sonra o ürünün bütün satıcı tekliflerini tek çağrıda okuyun. Pazaryerinde fiyat takibi aslında budur: tek bir fiyat değil, aynı ürünün kaç mağazada kaça satıldığı.
curl -X POST https://api.reefapi.com/hepsiburada/v1/product/offers \
-H "x-api-key: ANAHTARINIZ" \
-H "content-type: application/json" \
-d '{"sku": "HBCV00001ABCDE"}'{
"ok": true,
"data": {
"offers": [
{
"seller": "...",
"price": 18499.0,
"is_buybox": true
}
]
},
"meta": { "record_count": 12, "cache_hit": false, "mode": "live" }
}Hepsiburada için scraping yazmak yerine
Hepsiburada sayfalarını kendiniz çekmek ilk gün işe yarar. İkinci ayda iki şey oluyor: site kart yapısını değiştirdiğinde ayrıştırıcınız hata vermeden boş liste döndürür, bot koruması devreye girdiğinde de isteğiniz sessizce engellenir. İkisi de sizin tarafınızda 'ürün bulunamadı' gibi görünür, oysa veri oradadır.
Bu API'de bakım bizim tarafımızda: site şema değiştirince motoru biz düzeltiriz, engelleme olduğunda açık bir hata kodu döner ve o çağrıdan ücret alınmaz.
Tek seferlik ve bir daha koşmayacak bir iş için kendi scriptiniz hâlâ daha ucuz, bunu dürüstçe söylüyoruz. Düzenli çalışan bir fiyat takibi kuruyorsanız maliyet kodda değil, fark edilmeyen kırılmalarda birikiyor.
Sınırlar ve dürüst notlar
- Mağaza hesabı gerekmez, ama bu Hepsiburada'nın resmi API'si değildir ve onunla bir ortaklığımız yoktur.
- Kategori ucu slug ve id'yi birlikte ister ('<slug>-c-<id>'); yalnız id ile çağrı yapılmaz, çünkü kaynak yolu öyle yayımlıyor.
- Mağaza yayımlamıyorsa stok ve kampanya alanları null gelir; biz tahmin üretmiyoruz.
- Her çağrı canlıdır, önbelleğe alınmış yanıt almazsınız.