Trendyol veri çekme API'si: ürün, yorum ve arama verisi

Trendyol'un yayınladığı satıcı API'si, satıcıların kendi mağazalarını yönetmesi için tasarlanmıştır: ürün listeleme, stok güncelleme, sipariş işleme gibi işlemler kendi hesabınız üzerinden yapılır. Başka bir satıcının ürün detaylarını okumak, bir rakibin yorumlarını çekmek veya bir anahtar kelime için pazar genelinde arama sıralamasını sorgulamak bu API'nin kapsamında değildir.

Roketfy Data Engine bu boşluğu dolduruyor. Bir alıcının gördüğü aynı herkese açık mağaza sayfalarını — ürün sayfaları, yorum listeleri, soru-cevap başlıkları, kategori ve arama listeleri, satıcı mağazaları — okuyup yapılandırılmış JSON olarak döndürür; bu, sadece kendi mağazanız için değil, Trendyol'daki herhangi bir ürün için geçerlidir. Tek bir satıcı hesabı için sipariş yönetimi değil, pazar genelinde görünürlük gerektiğinde doğru araç budur.

`/v1/trendyol/product-detail` endpoint'ini tam ürün URL'si veya satıcıların SKU olarak bildiği sayısal contentId ile çağırın. Yanıt; ürün özelliklerini, varyantları, güncel puanları, buybox kazananını ve o ürün üzerindeki diğer tüm satıcıları kendi fiyat ve stoklarıyla birlikte içerir — böylece tek istekte bir listenin tüm rekabet tablosunu görebilirsiniz.

Ürünleri sistem içinde zaten contentId ile takip ediyorsanız doğrudan bunu gönderip URL ayrıştırmasından kaçınabilirsiniz. İsteğe bağlı `merchantId` parametresi, birden fazla satıcının bulunduğu bir ürün sayfasını tek bir satıcıya göre daraltmanızı sağlar.

Yorumlar ve sorular sayfalanır: `/v1/trendyol/reviews` ve `/v1/trendyol/questions` endpoint'leri `page` ve `pageSize` parametrelerini kabul eder ve her ikisi de toplu (batch) işleme uygundur. Sayfaları kendiniz döngüye almak yerine `POST /v1/tasks` üzerinden bir batch görevi gönderebilir ve sonucu bekleyebilirsiniz — Data Engine sayfalama ve yeniden deneme işlemlerini sizin için yürütür, sayfa başına maliyet doğrudan çağrıyla aynıdır.

Yorumlarda bilmeye değer ek filtreler var: `orderBy` Trendyol'un kendi yararlılık puanına, en yeniye veya yıldız puanına göre sıralar; `hasMediaFiles` yalnızca fotoğraf veya video içeren yorumları getirir; `tag`, `heightTags` ve `weightTags` ise Trendyol'un ürün başına ürettiği özellik etiketlerine ve beden aralıklarına göre filtreler — bu etiketleri kullanmadan önce ürüne özgü seti görmek için önce sayfa 0'ı çekmeniz gerekir.

`/v1/trendyol/search`, mağazanın gösterdiği sırayla bir arama teriminin sonuçlarını döndürür; sayfa pozisyonu, fiyat, puan, satıcı ve bir satırın organik mi yoksa ücretli bir yerleşim mi olduğu bilgisiyle birlikte — bu, bir anahtar kelime için görünürlük payını zaman içinde takip etmek isteyenler için kullanışlıdır. `/v1/trendyol/category-products`, arama terimi yerine bir kategori sayfası için aynı yapıyı döndürür; `/v1/trendyol/top-rankings` ise belirli bir kategori id'si için Trendyol'un kendi liderlik tablolarına (en çok satan, en çok görüntülenen, en çok favorilenen, en çok değerlendirilen) erişim sağlar.

Üçü de mağazanın kendisiyle aynı sıralama ve filtre parametrelerini kabul eder — marka id'leri, alt kategori id'leri, minimum puan, ücretsiz kargo — böylece bir alıcının göreceği görünümü birebir yeniden oluşturabilir veya geniş bir kategoriyi belirli bir segmente daraltabilirsiniz.

Yukarıdaki tüm endpoint'ler başarılı istek başına 1 kredi maliyetindedir; sayfalanan yorum veya soru isteklerinde her sayfa da aynı şekilde ücretlendirilir. Trendyol tarafında başarısız olan istekler hiçbir zaman ücretlendirilmez — yalnızca veri döndüğünde kredi harcanır. Krediler abonelik yerine tek seferlik paketlerden gelir, böylece ay ay değişen kullanım sizi düzenli bir plana bağlamaz.

Kimlik doğrulama, Roketfy panelinden alınan tek bir Bearer token ile yapılır; bu token hem her REST isteğinde hem de karşılık gelen MCP araçlarında kullanılır — kendi backend'inizden çağırsanız da bir yapay zeka ajanına bağlasanız da aynı kimlik bilgileri geçerlidir.

Evet. Yukarıdaki her endpoint aynı zamanda bir MCP aracı olarak da sunulur — `trendyol_product_detail`, `trendyol_reviews`, `trendyol_search` ve diğerleri — böylece Claude, Cursor veya herhangi bir MCP uyumlu istemci üzerinde çalışan ajanlar, aynı API token'ı ve aynı kredi bakiyesiyle Trendyol verisine bir konuşma içinden doğrudan erişebilir.