Üç servis, üç amaç
| Servis | Yol | Ne döner | size en fazla |
|---|---|---|---|
| Onaylı ürün | /products/approved | İçerik (content) ve altındaki varyantlar | 100 |
| Onaysız ürün | /products/unapproved | Onay bekleyen ve reddedilen ürünler | 1000 |
| Temel bilgiler | /product/{barcode} | barcode, approved, approvedDate, archived, listingId, contentId | - |
| Onaylı stok ve fiyat | /products/approved/inventory-and-price | Yalnız stok ve fiyat | 100 |
Yalnız stok ve fiyat gerekiyorsa daha hafif olan stok ve fiyat listeleme servisini kullanın.
Onaylı ürün filtreleri
| Parametre | Açıklama |
|---|---|
| barcode / barcodes | Tek barkod ya da en fazla 50 barkod |
| contentId, productMainId, stockCode | Tekil içerik, model kodu ya da stok koduyla arama |
| brandIds | Belirli markaların ürünleri |
| status | archived, blacklisted, locked, onSale, notOnSale |
| startDate, endDate, dateQueryType | Zaman damgası aralığı; VARIANT_CREATED_DATE, VARIANT_MODIFIED_DATE ya da CONTENT_MODIFIED_DATE |
| page, size | Sayfa ve sayfa boyutu (size en fazla 100) |
| nextPageToken | 10.000'den fazla içeriği olan mağazalarda sonraki sayfa |
| orderByDirection | SellerCreatedDate'e göre ASC ya da DESC |
Onaysız ürün servisinde status yalnız rejected ve pendingApproval alır; tarih filtresi CREATED_DATE ya da LAST_MODIFIED_DATE ile çalışır. Reddedilen bir ürünün nedenini düzeltip güncellediğinizde ürün yeniden onay sürecine girer.
Tarih filtresinde dateQueryType seçimi sonucu değiştirir. VARIANT_CREATED_DATE barkodun açıldığı tarihe, VARIANT_MODIFIED_DATE satıcının barkodu son güncellediği tarihe, CONTENT_MODIFIED_DATE ise içerikteki son değişikliğe bakar. Değişen ürünleri yakalamak için çoğunlukla VARIANT_MODIFIED_DATE en uygun seçimdir.
Yanıtı okumak
Onaylı ürün yanıtı totalElements, totalPages, page, size ve nextPageToken ile birlikte content dizisi döner. Her içerikte contentId, productMainId, brand, category, title, description, images, attributes ve variants bulunur.
Her varyant bir barkoddur. Varyantta variantId, barcode, stockCode, onSale, locked, lockReason, archived, blacklisted, hasViolation, vatRate, productUrl, price ve stock bilgileri yer alır. Satışta olmayan bir ürünün nedenini bu bayraklardan anlarsınız: locked ise kilitli, archived ise arşivde, blacklisted ise kara listede, hasViolation ise ihlal kaydı var demektir.
Sayfalama kuralları ve sık hatalar
- page × size en fazla 10.000 olabilir. Örneğin size 100 ile en fazla 100 sayfa okunur.
- 10.000'den fazla içerik varsa ilk istekten dönen nextPageToken ile devam edin.
- Tam katalog taramalarını sık yapmayın; değişenleri tarih filtresi ve VARIANT_MODIFIED_DATE ile çekin.
- Ürünü barkodla bulamıyorsanız onaysız listede olabilir; önce temel bilgi servisine bakın.
- Bu servisler Product Integration Read grubundadır ve dakika limitini batch sorgularıyla paylaşır.
Sık sorulanlar
Trendyol'daki tüm ürünlerimi nasıl çekerim?
Onaylı ürünler servisini size=100 ile sayfa sayfa çağırın. page × size 10.000'i geçemez; daha büyük kataloglarda nextPageToken ile devam edin. Onaysız ürünler ayrı serviste listelenir.
Reddedilen ürünlerin nedenini nereden görürüm?
Onaysız ürün servisini status=rejected ile çağırın. Ret nedenini düzeltip ürünü güncellediğinizde ürün yeniden onay sürecine girer.
Bir barkodun onaylı olup olmadığını nasıl anlarım?
GET .../product/{barcode} servisi approved, approvedDate, archived ve contentId alanlarını döner. Tek ürün kontrolü için en hafif yoldur.
Aynı istekte birden çok barkod sorgulayabilir miyim?
Evet. barcodes parametresiyle onaylı ve onaysız ürün servislerinde en fazla 50 barkod sorgulanabilir.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı