Yanıt yapısı
Servis categories adlı bir dizi döner. Her düğümün alt kategorileri subCategories içinde yine aynı yapıda gelir. Ağacı gezerken subCategories'i boş olan düğümleri toplamak, ürün açılabilecek kategorileri verir. Ağaç derin olabilir; gezinti kodunuzu sabit seviye sayısına göre değil, özyinelemeli yazın.
| Alan | Açıklama |
|---|---|
| id | Kategorinin Trendyol'daki kimliği; createProducts'ta categoryId olarak gönderilir |
| parentId | Bir üst kategorinin kimliği |
| name | Kategori adı |
| subCategories | Alt kategoriler; yoksa boş döner |
name filtresiyle arama
Tüm ağacı indirmek yerine name parametresiyle arama yapabilirsiniz. Örneğin name=saat, adında "saat" geçen bütün seviyelerdeki kategorileri döndürür. Dönen sonuç yine ağaç biçimindedir: eşleşen kategori, üst kategorileriyle birlikte gelir.
Bu yüzden arama sonucunu da gezmeniz gerekir. Yalnız üst seviyeyi okursanız gerçekte eşleşen alt kategoriyi kaçırırsınız. Sonuçlardan subCategories'i boş olanları seçip kullanıcıya "Üst > Alt > Yaprak" yoluyla göstermek doğru kategoriyi bulmayı kolaylaştırır.
Hangi yolu seçeceğiniz kullanım sıklığına bağlıdır. Ürün açma ekranında anlık arama yapıyorsanız name filtresi pratiktir. Toplu kategori eşleştirmesi yapıyorsanız tüm ağacı bir kez indirip saklamak, her ürün için ayrı istek atmaktan çok daha az yük oluşturur.
Kategori seçerken kurallar
- Ürün yalnız en alt seviye kategoriyle açılır. Alt kategorisi olan bir ID gönderirseniz ürün aktarımı yapılamaz.
- Ağaç değişebilir. Yeni kategoriler eklenir, bazıları taşınır. Listeyi en az haftada bir yenileyin; eski bir ağaç eksik ya da hatalı veri girişine yol açar.
- Kategori seçildikten sonra o kategorinin özelliklerini çekin. Zorunlu özellikler kategoriye göre değişir.
- Kategori eşleştirmesini ürün adına göre otomatik yapıyorsanız sonucu kullanıcıya onaylatın. Benzer adlı farklı dallar sık görülür.
Sık hatalar ve çözümleri
| Belirti | Neden | Çözüm |
|---|---|---|
| Ürün aktarımında kategori hatası | Üst seviye kategori gönderildi | subCategories'i boş olan kategoriyi seçin |
| Daha önce çalışan kategori artık reddediliyor | Ağaç güncellendi | Ağacı yeniden çekin, eşleştirmeyi güncelleyin |
| Arama beklenen kategoriyi göstermiyor | Yalnız üst seviye okunuyor | Arama sonucundaki ağacı alt seviyelere kadar gezin |
| Yanıt geç geliyor | Tüm ağaç tek yanıtta ve büyük | Sonucu önbelleğe alın, istek zaman aşımını uzun tutun |
Kategori eşleştirme mantığı için kategori eşleştirme rehberi de yol gösterir.
Sık sorulanlar
Trendyol kategori ID'sini nasıl bulurum?
GET /integration/product/product-categories servisini çağırın ya da name parametresiyle arayın. Ürün için alt kategorisi olmayan en alt seviyedeki kategorinin id değerini kullanın.
Kategori listesini ne sıklıkla güncellemeliyim?
Trendyol yeni kategoriler eklenebildiği için listeyi haftalık almanızı önerir. Ürün göndermeden önce güncel ağacı kullanmak hatalı veri girişini önler.
Üst kategoriyle ürün açabilir miyim?
Hayır. Seçtiğiniz kategorinin alt kategorileri varsa bu kategoriyle ürün aktarımı yapılamaz. Yalnız en alt seviye kategori kabul edilir.
Kategori servisi satıcı ID istiyor mu?
Hayır. Yol satıcı ID içermez, ancak istek yine Basic Auth ve User-Agent başlığıyla gönderilmelidir.
Kategori servisinin istek limiti nedir?
Kategori listesi Product Integration Read grubundadır. 14 Eylül 2026'dan beri bu grubun limiti en düşük kademede dakikada 1000 istektir ve ürün listeleme istekleriyle paylaşılır.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı