Hepsiburada veri çekme API'si: ürün ve yorum verisi

Hepsiburada, satıcıların kendi mağazalarını yönetmesi için bir satıcı paneli ve entegrasyon API'si sunar; ama bu, başka bir satıcının ürün detayını okumak veya pazar genelinde arama sonuçlarını sorgulamak için tasarlanmamıştır. Roketfy Hepsiburada API'si, bir alıcının gördüğü herkese açık ürün, yorum, soru-cevap ve arama sayfalarını okuyup yapılandırılmış JSON olarak sunar — herhangi bir ürün veya satıcı için, kendi mağaza hesabınız olmadan.

Bu, ürün çekme, yorum çekme veya rakip fiyat izleme gibi ihtiyaçlar için kendi scraper'ınızı yazmak ya da proxy altyapısı kurmak yerine tek bir API entegrasyonuyla çalışmanızı sağlar.

`/v1/hepsiburada/product-detail` endpoint'i, ürün URL'si (…-p-<sku> veya …-pm-<productId> biçiminde) ya da doğrudan SKU ile çağrılır ve özellikler, varyantlar, görseller, puanlar ile ürün üzerindeki her satıcının fiyat ve buybox pozisyonunu döndürür. …-pm-<productId> biçimindeki URL'ler bir varyant değil bir ürünü adlandırdığından, önce ürün sayfası üzerinden SKU'ya çözülmesi gerekir; bu yüzden bu URL biçimi 1 yerine 2 kredi olarak ücretlendirilir.

URL'de bir `magaza` parametresi varsa bu otomatik olarak `merchant` adıyla listelemeyi o satıcıya daraltır; isterseniz bunu doğrudan parametre olarak da geçebilirsiniz.

`/v1/hepsiburada/reviews` ve `/v1/hepsiburada/questions` sayfalanan endpoint'lerdir ve batch işlemeyi destekler — `POST /v1/tasks` ile bir görev başlatıp sonucu beklediğinizde Data Engine tüm sayfaları sizin için toplar. Yorumlar endpoint'i ayrıca `includeSummary` ile Hepsiburada'nın kendi yapay zeka özetini ve filtre facet'lerini, `includeSiblingVariants` ile ürünün diğer renk/beden varyantlarındaki yorumları dahil edip etmeyeceğinizi kontrol etmenizi sağlar.

Satıcı adına veya anahtar kelimeye göre filtrelemek isterseniz `merchants` ve `keywords` parametrelerini kullanın — bu değerler virgülle değil `||` ile ayrılır ve bir ürünün kendi `filters` alanından okunmalıdır, çünkü set ürüne göre değişir.

`/v1/hepsiburada/search` bir arama terimi için, `/v1/hepsiburada/category-products` ise bir kategori sayfası için mağazanın gösterdiği sırayla sonuçları döndürür: fiyat, kampanya fiyatı, satıcı, rozetler ve puan. Hepsiburada'nın kendi sıralama anahtarlarını (recommended, artanfiyat, azalanfiyat, coksatan, yorumsayisi, degerlendirmepuani, indirimurunler, enyeni) doğrudan kullanabilirsiniz.

`brands` ve `filters` parametreleriyle sonuçları marka veya diğer facet'lere göre daraltabilirsiniz; facet değerleri kategoriye göre değiştiğinden önce filtresiz bir çağrı yapıp yanıttaki `filters` bloğunu okumanız önerilir.

Standart bir …-p-<sku> URL'si veya SKU ile yapılan çağrılar 1 kredi, yorumlar ve sorularda her sayfa da 1 kredidir; …-pm-<productId> biçimindeki URL'lerde ek çözümleme adımı nedeniyle maliyet 2 kredidir. Başarısız istekler hiçbir zaman ücretlendirilmez. Krediler tek seferlik paketler halinde satın alınır, abonelik gerekmez.

Evet. Tüm Hepsiburada endpoint'leri aynı zamanda MCP aracı olarak sunulur (`hepsiburada_product_detail`, `hepsiburada_reviews` gibi), böylece Claude veya Cursor gibi MCP destekli ajanlar aynı token ve kredi bakiyesiyle bu verilere doğrudan erişebilir.