Üç marka servisi
| Servis | Yöntem ve yol | Parametre | Not |
|---|---|---|---|
| Marka listesi | GET /integration/product/brands | page, size | Sayfa sayfa tüm markalar |
| Marka arama | GET /integration/product/brands/by-name | name | Büyük-küçük harfe duyarlı |
| Marka yaratma | POST /integration/product/sellers/{sellerId}/brands | form-data: name, images | 1 ile 3 görsel |
Liste ve arama servisleri satıcı ID içermez. Marka yaratma ise satıcıya bağlıdır ve Product Integration Write grubundadır.
Marka listesini kullanmak
Marka listesi çok büyüktür ve page parametresiyle sayfalanır. Doküman bir sayfada en az 1000 marka alınabildiğini belirtir. Tüm listeyi indirip yerelde aramak mümkündür ama gereksiz yere çok istek üretir.
Önemli bir ayrıntı: liste servisi isim filtresi almaz. name parametresi gönderseniz bile dikkate alınmaz ve ilk sayfanın alakasız markaları döner. İsimle arama için mutlaka by-name servisini kullanın.
İsimle aramanın kuralı: harf duyarlılığı
by-name servisi adı birebir ve büyük-küçük harfe duyarlı eşler. Kullanıcı "maisto" yazdığında kayıt "Maisto" ise sonuç gelmeyebilir. Bu yüzden aramayı birkaç biçimde denemek işe yarar:
- Kullanıcının yazdığı biçim,
- Tamamı büyük harf,
- Her kelimenin ilk harfi büyük,
- Tamamı küçük harf.
Türkçe karakterlerde dönüşümü Türkçe kurallarıyla yapın. Aksi hâlde "i" ve "ı" harfleri yanlış çevrilir ve eşleşme kaçar. Bulunan markayı kullanıcıya listeden seçtirmek, yanlış brandId gönderimini önler.
Marka yaratma
Listede olmayan bir marka için yaratma isteği gönderilebilir. İstekte JSON gövde yoktur. Marka adı name alanında form-data metin olarak, marka görselleri images alanında form-data dosya olarak gönderilir. En az 1, en fazla 3 görsel eklenir.
Yaratma isteği markanın hemen kullanılabileceği anlamına gelmez. Markayı ürün gönderiminde kullanmadan önce by-name aramasıyla görünür olduğunu doğrulayın. Marka yaratma Product Integration Write limitine sayılır; yanıt beklenirken aynı markayı tekrar tekrar göndermeyin.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Arama sonuç döndürmüyor | Harf biçimi kayıttan farklı | Farklı harf biçimleriyle tekrar arayın |
| Liste aramada alakasız markalar | Liste servisine name gönderildi | by-name servisini kullanın |
| Ürün marka hatasıyla reddedildi | brandId listede yok ya da yanlış | Markayı listeden seçin; yoksa marka yaratma talebi açın |
| Marka yaratma 400 | JSON gövde gönderildi ya da görsel yok | form-data ile name ve 1-3 görsel gönderin |
Sık sorulanlar
Trendyol brandId nasıl bulunur?
GET /integration/product/brands/by-name?name=MarkaAdi ile arayın. Arama büyük-küçük harfe duyarlıdır; sonuç gelmezse farklı harf biçimlerini deneyin.
Marka listesi servisinde isimle filtre var mı?
Hayır. Liste servisi yalnız page ve size alır. İsimle arama için ayrı by-name servisi kullanılır.
Markam Trendyol'da yoksa ne yapmalıyım?
Marka yaratma servisine form-data ile marka adını ve 1-3 marka görselini gönderin. Marka listede görünmeden ürünü o markayla açmayın.
Marka servisleri istek limitine dahil mi?
Evet. Liste ve arama Product Integration Read, marka yaratma Product Integration Write grubundadır.
Aynı markayı her ürün için yeniden aramalı mıyım?
Hayır. Bulduğunuz brandId değerini saklayıp aynı markalı ürünlerde tekrar kullanın. Bu, gereksiz istekleri ve limit aşımını önler.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı