Trendyol API ile toplu ürün güncelleme: entegrasyon bilgileri, güvenlik, adım adım

Muhammet Çay · Yayın 10 Eylül 2026 · Güncelleme 10 Eylül 2026 · 7 dk okuma

Trendyol API ile toplu ürün güncelleme için üç bilgi gerekir: Satıcı ID, API Key ve API Secret. Bunlar satıcı panelinde Hesap Bilgilerim altındaki Entegrasyon Bilgileri sayfasındadır ve yalnızca ana kullanıcı görebilir. Bu bilgilerle bir entegratör ya da ajans, panel şifrenizi hiç bilmeden, tek istekte 1.000 ürünün başlık, açıklama, görsel ve özelliklerini güncelleyebilir. Aşağıda anahtarı nereden alacağınızı, kime nasıl vereceğinizi, güncellemeyi adım adım nasıl yapacağınızı ve işiniz bitince anahtarı nasıl geçersiz kılacağınızı anlattık.

Entegrasyon bilgileri nedir, panel şifresinden farkı ne

Trendyol'un geliştirici dokümanı şunu söyler: Basic Authentication için gereken Satıcı ID, API Key ve API Secret bilgileri, satıcı panelindeki "Hesap Bilgilerim" bölümünün "Entegrasyon Bilgileri" sayfasından alınır. Sayfa yalnızca ana kullanıcı girişiyle açılır; alt kullanıcılar göremez.

Bu üçlü, panel şifrenizden farklı bir kapıdır:

Sonuç: bir içerik ajansına iş yaptıracaksanız panel şifrenizi değil, API bilgilerinizi vermelisiniz. Ama bu anahtar da stok ve fiyat yazabilir. Bu yüzden "kime, ne kadar süre, hangi kanaldan" sorularını sözleşmeye yazın.

Anahtarı güvenli paylaşmanın kuralları

Trendyol dokümanı tek bir güvenlik uyarısı yapar ve bu yeterince açıktır: API anahtar bilgilerinin GitHub, GitLab gibi açık platformlarda paylaşılmaması önemlidir. Biz buna dört kural ekliyoruz:

1. Kapalı kanal. WhatsApp grubu, e-posta gövdesi ve Excel eki açık kanaldır. Tek kullanımlık şifreli not ya da parola yöneticisi paylaşımı kullanın.
2. Süreli iş. İş bitince anahtarı yenileyin. Yeni anahtar eski anahtarı geçersiz kılar.
3. User-Agent kaydı. Trendyol her isteğin başlığında User-Agent ister; biçimi "SatıcıId - EntegratörFirmaAdı" ya da kendi geliştirmenizde "SatıcıId - SelfIntegration" şeklindedir. User-Agent göndermeyen istek 403 alır. Çalıştığınız tarafın kendi adını yazmasını isteyin; sonradan hangi isteğin kimden geldiği belli olur.
4. Önce stage, sonra prod. Doküman, PROD ve STAGE ortamlarında kimlik bilgilerinin farklı olabileceğini söyler. Deneme için stage bilgisi verin; canlıya yalnızca onayladığınız dosya gitsin.

Yanlış ya da eski anahtarla gelen istek 401 ve "ClientApiAuthenticationException" mesajı alır. Bu, anahtarın gerçekten geçersiz olduğunu doğrulamanın en kolay yoludur.

Adım adım: 1.000 ürünü tek istekte güncelleme

Trendyol'un Onaylı Ürün Güncelleme v2 servisi, adı "content-bulk-update" olan tek bir uç noktadır. Aşağıdaki sıra hem kendi mağazanızda hem de bir entegratörle çalışırken aynıdır.

1. Adım: Mevcut içeriği okuyun

Önce neyi değiştireceğinizi bilmeniz gerekir. Onaylı Ürün Filtreleme v2 servisi (GET .../products/approved) her ürün için contentId, başlık, açıklama, görseller, özellikler ve varyantları döndürür. Sayfa başına en fazla 100 kayıt gelir; 10.000 kaydı aşan mağazalarda nextPageToken ile devam edilir. Bu çıktıyı bir tabloya alın. Boş özellik, tek görsel ve kısa açıklama bu tabloda hemen görünür.

2. Adım: Kategori özelliklerini güncel çekin

Kategori Özellik Listesi v2 servisi her kategori için hangi özelliğin zorunlu (required), hangisinin serbest metin kabul ettiğini (allowCustom), hangisinin varyant (varianter) ve hangisinin ayrı ürün kartı açtığını (slicer) verir. Trendyol bu listenin haftada bir yenilenmesini önerir; eski liste ile gönderilen özellik reddedilir.

3. Adım: Neyin değişebileceğini bilin

Onaylı üründe şu alanlar güncellenir: başlık, açıklama, görseller ve özellikler. Şunlar güncellenemez: barcode, productMainId, brandId, categoryId ve varyant ya da slicer görevi gören özellik değerleri. Kritik kural: herhangi bir özelliği değiştirecekseniz o ürünün tüm özelliklerini eksiksiz göndermeniz gerekir; kısmi gönderim özelliklerde çalışmaz. Başlık ve açıklama için kısmi gönderim çalışır.

4. Adım: Alan sınırlarına göre içeriği hazırlayın

Ürün Yaratma v2 dokümanındaki sınırlar güncellemede de geçerlidir: başlık en fazla 100 karakter, açıklama en fazla 30.000 karakter HTML, görsel barkod başına en fazla 8 adet, 1200x1800 piksel, 96 dpi ve https adresli. Görselleriniz kendi sunucunuzda ya da bir CDN'de https ile erişilebilir olmalıdır; Trendyol dosya almaz, adres alır.

5. Adım: İsteği gönderin

POST https://apigw.trendyol.com/integration/product/sellers/{sellerId}/products/content-bulk-update

Gövde, "items" dizisi içinde her ürün için contentId ve değişecek alanları taşır. Tek istekte en fazla 1.000 ürün gönderilir. Yanıt tek bir alandır: batchRequestId. Bu kimliği saklayın; olmadan sonuç sorgulanamaz.

Kısa bir örnek:

json { "items": [ { "contentId": 123456, "title": "SepetZone 3'lü Kumanda Tutucu Duvar Askısı, Vidasız, Siyah", "description": "<p>Üç kumandayı televizyon yanında tek noktada toplar.</p><ul><li>Ölçü: 12 x 8 x 4 cm</li><li>Kutu içeriği: 1 tutucu, 2 çift taraflı bant</li></ul>", "images": [ { "url": "https://ornek.com/kumanda-tutucu-1.jpg" }, { "url": "https://ornek.com/kumanda-tutucu-2.jpg" } ] } ] }

Bu örnekte özellik gönderilmedi; bu yüzden mevcut özellikler korunur. Özellik eklenecekse "attributes" dizisi tüm özelliklerle birlikte gönderilir.

6. Adım: Sonucu batch kaydından doğrulayın

GET .../products/batch-requests/{batchRequestId}

Yanıtta status (COMPLETED ya da devam ediyor), itemCount, failedItemCount ve failureReasons alanları gelir. failedItemCount sıfır değilse failureReasons her ürün için nedeni söyler: eksik zorunlu özellik, geçersiz görsel adresi, karakter sınırı aşımı gibi. Düzeltip yalnızca hatalı ürünleri yeniden gönderin.

Bir uyarı: Trendyol dokümanına göre başarılı aktarım ürünü onay sürecine sokar ve onayı bekleyen ürün yayına çıkmaz. Toplu güncellemeyi bu yüzden kampanya haftasına değil, sakin bir güne planlayın. Önce 20 ürünle deneyin.

Oran limitleri ve tarihler

Trendyol, 14 Eylül 2026'dan itibaren ürün servislerinde mağazanın ürün limitine göre kademeli oran limiti uygular. Servis Limitleri sayfasına göre ürün yazma servislerinin (yaratma, güncelleme, silme) toplamı kademeye göre dakikada 200 ile 600 istek arasındadır; okuma servisleri dakikada 1.000 ile 2.000 arası. Authorization sayfasında ayrıca uç nokta başına 10 saniyede 50 istek sınırı ve aşımda 429 "too.many.requests" yanıtı yazılıdır.

Pratik sonuç: 1.000 ürünü tek istekte gönderdiğiniz için limit sizi zorlamaz. Limit, her ürün için ayrı istek atan kötü yazılmış araçları zorlar.

İkinci tarih: Trendyol changelog'una göre Ürün V1 servisleri 15 Eylül 2026'da kapanır. Entegratörünüz hâlâ V1 uç noktası kullanıyorsa güncellemeleriniz o gün durur. "Hangi sürümü kullanıyorsunuz" diye sormak sizin hakkınızdır.

İş bitince: anahtarı nasıl geçersiz kılarsınız

Burada dürüst olmak gerekir. Trendyol'un geliştirici dokümanı anahtarın nereden alınacağını, nasıl kullanılacağını ve nerede paylaşılmayacağını yazar; anahtarı yenileme adımını yazmaz. Bu yüzden sırayı şöyle öneriyoruz:

1. Ana kullanıcı ile panele girin, Hesap Bilgilerim > Entegrasyon Bilgileri sayfasını açın.
2. Sayfada anahtar yenileme ya da yeniden oluşturma seçeneği görüyorsanız kullanın. Yeni anahtar üretildiği anda eski anahtarla gelen istekler 401 alır.
3. Seçenek yoksa Satıcı Destek üzerinden "API Secret sıfırlama" talebi açın ve nedenini yazın: entegratör değişikliği ya da iş sonu.
4. Yenileme sonrası kendi kullandığınız entegrasyonları (fatura programı, pazaryeri yönetim aracı) yeni anahtarla güncelleyin; onlar da eski anahtarla 401 alacaktır.
5. Bir hafta sonra User-Agent kayıtlarınızı kontrol edin. Eski entegratörün adıyla istek geliyorsa anahtar hâlâ eski demektir.

Anahtarı yenilemek, çalıştığınız tarafa güvensizlik değildir. Süreli erişim, iyi çalışan ilişkilerin standart kapanışıdır.

Entegratör mü, kendi yazılımınız mı

İki yol var ve ikisi de aynı üç bilgiyle çalışır. Hazır entegratör kullanıyorsanız (fatura programı, pazaryeri yönetim aracı) User-Agent'ta o firmanın adı gider ve Trendyol o firmayı Partner Programı kapsamında tanır. Kendi yazılımınızı yazıyorsanız User-Agent "SatıcıId - SelfIntegration" olur.

Hazır araç hızlıdır ama içeriği çoğu zaman tek tek düzenletir; toplu içerik güncellemesi için Excel içe aktarımına ya da API'ye yine döneriz. Kendi yazılımınız ya da bir ajansın yazılımı ise yukarıdaki altı adımı doğrudan uygular. Karar ölçütü basittir: 50 ürünün altındaysanız panel yeter; 200 ürünün üstündeyseniz toplu güncelleme olmadan içerik hiçbir zaman tamamlanmaz.

Sık karşılaşılan hatalar ve anlamları

Bu tablo, ajansınızın gönderdiği raporu okumanız için de yeterlidir. Rapor failureReasons içermiyorsa rapor değildir.

Neden panel yerine API

Kendi Hepsiburada mağazamızda 806 ürünün %70'i tek fotoğraflıydı ve kategori özellikleri %0 doluydu. Bu ölçekte panelden tek tek düzenleme haftalar alır. Toplu güncelleme ile 667 üründe galeriyi ortalama 2,8 kareden 7,8 kareye çıkardık, 542 üründe özellikleri doldurduk. Aynı hafta görüntülenmeden satışa dönüş %2,47'ye çıktı; önceki haftaya göre %81 artış. Aynı işi Trendyol'da yapmak için gereken tek şey yukarıdaki üç bilgi ve doğru sırayla atılmış altı adımdır.

Kontrol listesi

Bir entegratöre ya da ajansa API bilgisi vermeden önce:

1. Bilgiyi ana kullanıcı ile Hesap Bilgilerim > Entegrasyon Bilgileri sayfasından siz aldınız; panel şifresi paylaşılmadı.
2. Paylaşım kapalı kanaldan yapıldı; e-posta gövdesi ve grup mesajı kullanılmadı.
3. Karşı taraf User-Agent'ta kendi adını kullanacağını yazılı taahhüt etti.
4. İlk deneme stage ortamında ya da 20 ürünle yapılacak.
5. Karşı taraf V2 uç noktalarını kullanıyor (15 Eylül 2026 V1 kapanışı).
6. Neyin değişeceği yazılı: başlık, açıklama, görsel, özellik; stok ve fiyat kapsam dışı.
7. Her batch için batchRequestId ve failureReasons raporu size teslim edilecek.
8. Görseller https adreste, 1200x1800, en fazla 8 adet.
9. İş bitiş tarihi belli; o tarihte anahtar yenilenecek.
10. Kendi entegrasyonlarınızın listesi hazır; anahtar yenilenince onlar da güncellenecek.

API bilgisi vermeden önce skorunuzu görün

VitrinSkoru tam olarak bu yöntemle çalışır: Entegrasyon Bilgileri'nden aldığınız üç bilgiyle mağazanızı okur, her ürünün başlık, açıklama, görsel ve özellik doluluğunu puanlar ve eksikleri 48 saatte doldurur. Panel şifreniz bizde olmaz; iş bitince anahtarı yenilemenizi biz hatırlatırız. 100 ürüne kadar 4.900 ₺, 500 ürüne kadar 9.900 ₺; ilk 10 mağazaya yarı fiyat. Aylık 990 ₺ "bekçi" hizmeti yeni ürünleri de aynı standartta tutar. Önce ücretsiz skorunuzu alın: vitrinskoru.com/#skor.