Trendyol API anahtarı nasıl alınır? Adım adım rehber

Trendyol API Key ve Secret Key satıcı panelinde Hesap Bilgilerim → Entegrasyon Bilgileri sayfasındadır. Sayfayı göremiyorsanız menü kapalı değildir — hesabınız master user değildir.

Kısa cevap: Trendyol API bilgileri satıcı panelinde Hesap Bilgilerim → Entegrasyon Bilgileri sayfasındadır. Sayfayı göremiyorsanız menü kapalı değildir — hesabınız master user (admin) değildir. Bu tek ayrıntı, “API bilgilerimi bulamıyorum” şikâyetlerinin büyük bölümünü açıklar.

Anahtarı nereden alacaksınız

1. Trendyol satıcı paneline master user hesabıyla giriş yapın.
2. Sağ üstten Hesap Bilgilerim bölümüne girin.
3. Entegrasyon Bilgileri sayfasını açın.
4. Buradaki üç değeri not edin: supplierId (Satıcı ID), API Key ve API Secret Key.

Sayfayı göremiyorsanız

Entegrasyon Bilgileri sayfası yalnızca master user rolündeki hesaba görünür. Alt kullanıcı, muhasebe kullanıcısı veya operasyon kullanıcısıyla giriş yaptıysanız sayfa listede hiç çıkmaz. Yapılacak şey yetki talebi değil, master user hesabıyla giriş yapmaktır.

PROD ve STAGE bilgileri aynı değildir

Trendyol’un canlı (PROD) ve test (STAGE) ortamları ayrı kimlik bilgileri kullanır. Test ortamında çalışan bir anahtar canlıda çalışmaz, tersi de geçerlidir. Entegrasyonu test ortamında geliştirip canlıya alırken kimlik bilgilerini de değiştirmeniz gerekir — yalnızca adresi değiştirmek yetmez.

İlk isteği atmak: iki zorunlu başlık

Trendyol Partner API, basic authentication kullanır. Ancak yalnızca kimlik bilgisi göndermek yetmez: User-Agent başlığı da zorunludur. Bu ayrıntı dokümanda yazılıdır ama çoğu örnekte atlanır ve doğrudan 403 hatasına yol açar.

Authorization başlığı

API Key ve API Secret Key değerleri apiKey:apiSecret biçiminde birleştirilip Base64 ile kodlanır:

Authorization: Basic BASE64(apiKey:apiSecret)

User-Agent başlığı

Biçim, entegrasyonu kimin yazdığına göre değişir:

• Yazılım size aitse: SatıcıId - SelfIntegration — örnek: 4321 - SelfIntegration
• Bir entegratör firma ile çalışıyorsanız: SatıcıId - FirmaAdı — örnek: 1234 - TrendyolSoft
• Firma adı alfanümerik ve en fazla 30 karakter olmalıdır.

Python ile örnek istek

import base64
import requests

SUPPLIER_ID = "1234"
API_KEY     = "..."
API_SECRET  = "..."

token = base64.b64encode(f"{API_KEY}:{API_SECRET}".encode()).decode()

headers = {
    "Authorization": f"Basic {token}",
    "User-Agent": f"{SUPPLIER_ID} - SelfIntegration",
    "Content-Type": "application/json",
}

url = f"https://apigw.trendyol.com/integration/product/sellers/{SUPPLIER_ID}/products"
r = requests.get(url, headers=headers, timeout=30)

print(r.status_code)
print(r.text[:500])

200 dönüyorsa bağlantı kuruldu demektir.

İlk bağlantıda takılırsanız

En sık karşılaşılan üç durum şudur:

• 401 — kimlik bilgileri yanlış ya da ortamları karıştırdınız.
• 403 — neredeyse her zaman eksik User-Agent başlığı.
• 429 — istek sınırını aştınız.

Her kodun ayrıntılı sebepleri, nasıl ayırt edileceği ve çözümleri için Trendyol API hata kodları yazısına bakın.

İstek sınırı: hangi sayıya güveneceksiniz

Burada dikkat edilmesi gereken bir çelişki var. Trendyol’un Authorization sayfası “aynı uç noktaya 10 saniyede en fazla 50 istek” diyor. Ancak Servis Limitleri sayfası, 14 Eylül 2026’dan geçerli olmak üzere farklı bir yapı tanımlıyor: limitler dakika bazında, tekil uç nokta değil servis grubu bazında ve satıcı kademesine göre değişiyor.

Örnek olarak stok ve fiyat yazma grubunun kotası dakikada 350 ile 2.000 istek arasında. Yeni entegrasyon yazıyorsanız planlamayı güncel sayfaya göre yapın; eski sayılara göre kurulmuş bir hız sınırlayıcı sizi yanıltabilir. Ayrıntılar hata kodları yazısında.

Anahtar güvenliği

Trendyol dokümanı bu konuda açık bir uyarı veriyor: API bilgileri GitHub, GitLab gibi açık platformlarda paylaşılmamalıdır. Bu bilgilerle mağazanızda ürün, stok, fiyat ve sipariş işlemlerinin tamamı yapılabilir.

• Anahtarları koda gömmeyin; ortam değişkeni veya .env dosyası kullanın.
• .env dosyasını .gitignore içine ekleyin.
• Ekran görüntüsü veya destek talebi paylaşırken anahtarları maskeleyin.
• Anahtar sızdıysa panelden yenileyin; eski anahtarın geçersiz kıldığından emin olun.

Sırada ne var

Bağlantıyı kurduktan sonra ilk yazacağınız iş genellikle stok ve fiyat senkronizasyonudur. O uç noktanın kalem sınırı, toplu işlem akışı ve sessizce başarısız olan güncellemelerin nasıl yakalanacağı ayrı bir yazıda.

Sipariş tarafına geçtiğinizde dikkat: Trendyol 15 Ekim 2026’da eski sipariş uç noktasını kullanım dışı bırakıyor ve yenisine kayıt sınırı getiriyor. Ayrıntılar sipariş çekme yazısında.

Aynı yazılımı Hepsiburada ve N11’e de bağlayacaksanız, üç pazaryerinin kimlik doğrulama modelleri birbirinden farklıdır — burada öğrendiğiniz Basic auth alışkanlığı diğerlerinde hata üretir. Farkları karşılaştırma yazısında topladık.

Kaynak

Kimlik doğrulama, User-Agent biçimi ve güvenlik uyarısı Trendyol’un Authorization sayfasından; güncel istek sınırları Servis Limitleri sayfasından alınmıştır.

Son kontrol: 6 Ekim 2026. Trendyol arayüzü ve servis sınırları zamanla değişebilir. Bir tutarsızlık fark ederseniz yorum bırakın, sayfayı güncelleyelim.