İstek ve yanıt
İstek gövdesi tek bir alan taşır: barcodes, örneğin ["ORNEK_BARKOD_1", "ORNEK_BARKOD_2"]. Yanıt buyboxInfo adlı bir dizidir.
| Alan | Açıklama |
|---|---|
| barcode | Sorgulanan barkod |
| buyboxOrder | Sizin buybox sıranız; 1 buybox'ın sizde olduğu anlamına gelir |
| buyboxPrice | Buybox'taki fiyat |
| hasMultipleSeller | Ürünün birden fazla satıcısı var mı |
| secondBuyboxPrice / thirdBuyboxPrice | İkinci ve üçüncü sıradaki fiyatlar (doküman örneğinde yer alır) |
Sonuçları yorumlamak
| Durum | Anlamı | Ne yapılabilir |
|---|---|---|
| buyboxOrder 1, hasMultipleSeller false | Ürünü tek siz satıyorsunuz | Rekabet yok; fiyatı kârlılığa göre belirleyin |
| buyboxOrder 1, hasMultipleSeller true | Rakip var, buybox sizde | Rakip fiyatını izleyin |
| buyboxOrder 2 ve üzeri | Buybox başka satıcıda | Fiyatınızı buyboxPrice ile karşılaştırın |
Sıralama yalnız fiyatla açıklanamayabilir. Doküman buybox'ın nasıl hesaplandığını anlatmaz; fiyatınız buybox fiyatına eşit ya da düşükken sıra değişmiyorsa diğer etkenlere bakın. Konunun satıcı tarafı için Trendyol buybox nedir yazısına bakabilirsiniz.
Örnek: yanıtı fiyat farkına çevirmek
Doküman örneğinde bir barkod için buyboxOrder: 3 ve buyboxPrice: 299.9 döner. Sizin satış fiyatınız 329,90 TL ise buybox fiyatının yaklaşık yüzde 10 üzerindesiniz demektir.
Bu farkı hesaplamak için kendi salePrice değerinizi stok ve fiyat listeleme servisinden okuyun. Fark = (sizin fiyatınız - buyboxPrice) / buyboxPrice formülüyle bulunur. Farkı ürün bazında saklamak, hangi ürünlerde fiyatın, hangilerinde başka bir etkenin belirleyici olduğunu zamanla gösterir.
Limitler ve verimli kullanım
- Bir istekte en fazla 10 barkod sorgulanır. Büyük kataloglarda barkodları 10'luk gruplara bölün.
- Servis sayfası limiti dakikada 1000 istek olarak verir. 14 Eylül 2026'dan beri genel limit tablosu bu servisi Product Integration Write grubuna koyar; yani buybox sorguları ürün yaratma ve güncelleme istekleriyle aynı dakika limitini paylaşır.
- Bütün kataloğu sürekli taramak yerine satışı olan ve satışta kalan ürünlere odaklanın.
- Sonuçları zaman damgasıyla saklayın. Buybox sırası gün içinde değişir; tek bir ölçüm eğilim göstermez.
- Fiyat otomasyonu kuruyorsanız sınır koyun. Aynı barkoda dakikada 30'dan fazla fiyat güncellemesi gönderilemez.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| 400 | 10'dan fazla barkod gönderildi | Gruplara bölün |
| Barkod yanıtta yok | Barkod onaylı ya da satışta değil | Ürün durumunu onaylı ürün listesinden kontrol edin |
| 429 | Yazma grubunun dakika limiti doldu | Buybox sorgularını ürün güncellemeleriyle aynı dakikaya yığmayın |
Buybox verisini fiyat kararına çevirmeden önce maliyet ve komisyonu hesaba katın. Fiyatı buybox için düşürmek ürünü zarara sokabilir; hesap için pazaryeri komisyon hesaplama aracını kullanabilirsiniz.
Sık sorulanlar
Trendyol buybox servisine kaç barkod gönderebilirim?
Bir istekte en fazla 10 barkod gönderilebilir. Daha fazlası için barkodları 10'luk gruplara bölün.
buyboxOrder 1 ne demek?
Buybox'ın sizde olduğu anlamına gelir. 2 ve üzeri değerler buybox'ın başka bir satıcıda olduğunu ve sizin kaçıncı sırada olduğunuzu gösterir.
hasMultipleSeller false ise ne anlamalıyım?
Ürünü yalnız siz satıyorsunuz. Bu durumda buybox sırası rekabet bilgisi taşımaz.
Buybox servisi hangi limite tabi?
Servis sayfası dakikada 1000 istek der. 14 Eylül 2026 limit tablosunda servis Product Integration Write grubundadır ve bu grubun ortak dakika limitini paylaşır.
Buybox servisi rakip satıcının adını verir mi?
Hayır. Yanıt yalnız buybox sıranızı, buybox fiyatını, ikinci ve üçüncü sıradaki fiyatları ve çok satıcılı olup olmadığını döner; satıcı adı yer almaz.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı