Amazon ile satıcı, bağlı kuruluş veya reklamveren olarak entegrasyon yaparken karşılaşacağınız kritik bir karar var: Hangi API gerçekten ihtiyaçlarınızı karşılar? Amazon, kullanım senaryolarına göre dört farklı API sunuyor.
Eski Marketplace Web Services (MWS) kullanımdan kaldırılırken, tüm modern Amazon entegrasyonlarının Selling Partner API, Product Advertising API, Amazon Advertising API ve Vendor Central API gibi özel API’ler arasından seçim yapması gerekir. Bu kılavuz, hangi API’ye ihtiyacınız olduğunu belirlemekten kimlik doğrulama yöntemlerini anlamaya kadar ekosistemi adım adım size gösterir ve entegrasyon stratejiniz için bilinçli kararlar almanıza yardımcı olur.
Kullanım durumunuzu anlamak ilk adımdır. Amazon’un API’leri genelinde yaygın uygulamalara geçelim ve temel kavramları keşfedelim.
Amazon API’leri Nerelerde Uygulanır?
Amazon’un API ekosistemi, her biri farklı kullanım durumları ve iş modellerine sahip birden çok topluluğa hizmet eder.
Amazon Satıcıları ve Çok Kanallı Operatörler
Profesyonel satıcılar, envanteri FBA (Fulfillment by Amazon) ve FBM (Fulfillment by Merchant) üzerinden yönetmek için Selling Partner API’ye güvenir; ayrıca fiyatlandırma stratejilerini otomatikleştirir, raporlar üretir, siparişleri ve iadeleri programlı olarak işler veya Amazon’u ERP sistemleri, muhasebe yazılımları ve envanter yönetim platformlarıyla entegre etmek için kullanır.
Affiliate Pazarlamacıları ve İçerik Üreticileri
Affiliate pazarlamacılar ve içerik üreticileri, Amazon Ürün Reklamcılığı API’sını kullanarak ürün bilgilerini, incelemeleri, fiyatları ve bulunabilirlik verilerini web sitelerinde göstermek için çekerler. Ürün karşılaştırma araçları, inceleme derleyicileri veya niş ürün blogları oluşturmada, API doğrudan satış yapmadan Amazon Associates komisyon yapılarına sahip para kazanmayı mümkün kılar.
Reklam Ajansları ve PPC Uzmanları
Ölçekli Amazon reklam kampanyalarını yöneten ajanslar, sponsorlu ürünler, markalar ve görüntülü reklamları programatik olarak oluşturmak, güncellemek, duraklatmak ve optimize etmek için Amazon Advertising API’yi kullanır. API, gerçek zamanlı kampanya performans metrikleri, teklif otomasyonu yetenekleri ve manuel optimizasyonun başaramayacağı atıf verileri sağlar.
SaaS Platformu Geliştiricileri
Amazon satıcıları için SaaS çözümleri geliştiren geliştiriciler SP-API’yi entegrasyonlarına dahil ederek yönetim panelleri, yeniden fiyatlandırma araçları, otomatik listeleme araçları, analiz platformları ve sektöre özgü uygulamalar oluştururlar. Bir örnek, rakip fiyatlarını izleyen ve karlılık marjını korurken fiyatlarınızı otomatik olarak ayarlayan bir yeniden fiyatlandırma SaaS’idir.
Satıcılar ve Dropship’ler
Amazon Satıcıları ve özel satıcı platformları, tedarik zincirini yönetmek, kataloğa göre toplanan satış verilerine erişim sağlamak ve tedarik sistemleriyle entegrasyon kurmak için özel satıcı API’lerini kullanır. Dropshipper’lar genellikle Product Advertising API ile SP-API’yi birleştirerek ürün akışlarını ve siparişleri otomatik olarak yönetir.
Amazon’un API Ekosistemini Anlamak
31 Mart 2024, Amazon eski MWS uç noktalarını devre dışı bıraktı; bu da artık her ciddi satıcı aracının sipariş, envanter ve ödeme verilerini güvenilir şekilde çekmeye devam etmek için modern Selling Partner API (SP-API) üzerinde çalışması gerektiği anlamına geliyor.
Bugün Amazon tek bir birleşik API sunmuyor; bunun yerine farklı iş akışları için optimize edilmiş özel API’ler sunuyor. Hangi API’nin ne yaptığını anlamadan önce bir API seçmelisiniz.
Dört Ana Amazon API’si
Bu tablo, SP-API, Product Advertising, Amazon Advertising ve Vendor Central API’lerinin amaçları, en uygun kullanım senaryoları, birincil kullanıcılar ve kimlik doğrulama modelleri bakımından farklarını özetler; tercihiniz için net bir ilk filtre sunar.
| API | Amaç | En Uygun Olduğu Alanlar | Ana Kullanıcılar | Kimlik Doğrulama |
|---|---|---|---|---|
| Satış Ortağı API (SP-API) | Sipariş, stok, listeleme ve finansal verilerin yönetimi | Operasyonları Otomatikleştiren Satıcılar ve Tedarikçiler | Profesyonel satıcılar, tedarikçiler ve geliştiriciler | OAuth 2.0 + LwA (Amazon ile Giriş) |
| Product Advertising API | Ortaklık siteleri için ürün verilerini elde etme | Harici sitelerde Amazon ürünlerini görüntüleme | Satış ortakları, içerik üreticileri, inceleme siteleri | API Anahtarı + OAuth 2.0 |
| Amazon Advertising API | Kampanya yönetimi ve reklam performansı | Sponsorlu reklamları programlı olarak yönetme | Reklam Ajansları, Satıcılar, Marka Yöneticileri | OAuth 2.0 + LwA |
| Vendor Central API (Vendor’a Özel) | Satıcıya özel tedarik zinciri ve raporlama | Tedarik Zinciri ve Satın Alma | Sadece Amazon bayileri için | AWS kimlik bilgileri veya OAuth |
Her API, ayrı kimlik doğrulama, hız sınırları ve fiyatlandırma yapıları ile bağımsız olarak çalışır. Doğru olanı seçmek, tamamen başarmaya çalıştığınız şeye bağlıdır.
Hızlı Karar Verme Çerçevesi
Gerçekten hangi Amazon API’sine ihtiyacınız olduğunu bilmiyorsanız, belgelere dalmadan önce bu kısa çerçeveyi kullanın. En yaygın hedefleri doğru API’ye eşler; yanlış olanı entegre etmek için zaman kaybetmezsiniz.
Bir Amazon API seçimi, tek ve somut bir hedefe bağlandığında çok daha kolay hale gelir. Yığınızdaki büyümeyle birlikte birden çok API’yi tek bir çözüme entegre edebilirsiniz; ancak bu çerçeve her entegrasyonu yalnızca teknolojiyi amaç uğruna kullanmaktan bağımsız, net bir amaca odaklı tutar. Sonraki bölümlerde her API’yi yetenekler, sınırlamalar ve nasıl başlayacağını ayrıntılı olarak inceleyeceğiz.
Satış Ortağı API (SP-API): Modern Satıcının Omurgası
The Vendor Central API tedarik zinciri yönetimi yetenekleri, satın alma siparişleri, faturalar, gönderi takibi ve envanter yönetimini kapsar. SP-API’den farklı kimlik doğrulama yöntemleri kullanan, Amazon Tedarikçileri için özel olarak tasarlanmıştır.
SP-API Nedir?
The Selling Partner API REST tabanlı bir API olup Amazon satıcılarına iş verilerine programatik erişim sağlar. Siparişler, gönderimler, envanter düzeyleri, ürün listelemeleri, finansal işlemler, iadeler ve ayrıntılı raporlama konularını kapsar. Dünyada 1 milyonun üzerinde satıcı SP-API’yi işlerini otomatikleştirmek ve ölçeklendirmek için kullanıyor.
SP-API ile Ne Yapabilirsiniz?
- Envanter ve liste yönetimi. Ürün listelemelerini programlı olarak ekleyin, güncelleyin veya silin; birden çok SKU ve pazaryerinde stoğu yönetin ve büyük kataloglar için toplu güncellemeler yapın; tümünü manuel olarak düzenlemek yerine Satıcı Merkezi.
- Sipariş ve Kargo İşleme. Siparişleri gerçek zamanlı olarak alın, sevkıyatları onaylayın, takip numaralarını güncelleyin, iptal ve iadeleri yönetin ve paketleme fişleri oluşturarak siparişlerin Amazon’dan doğrudan fulfillment merkezine akmasını sağlayın.
- Fiyatlandırma Otomasyonu. Envanter seviyelerine, satış hızına, rakip faaliyetlerine veya piyasa eğilimlerine göre fiyatları otomatik olarak ayarlayın; gerçek zamanlı olarak binlerce SKU’yu optimize edebilen yeniden fiyatlandırma mantığını kullanın.
- Finansal veriler ve raporlama. Satış performansı, trafik, envanterin yaşı, yeniden stok önerileri ve finansal olaylar hakkında ayrıntılı raporları manuel CSV indirmeden alın ve kendi panellerinizde güncel analizler yapın.
- İadeler, geri ödemeler ve harici entegrasyonlar. İade iş akışını otomatikleştirin (iade ayrıntıları, etiketler, geri ödemeler) ve Amazon ile ERP, CRM, muhasebe ve sevkiyat sistemlerini senkronize edin; operasyonel veriler araçlar arasında manuel veri girişi olmadan hareket eder.
Hızlı Başlangıç: İlk SP-API Çağrınız (Python)
İşte son siparişlerinizi almak için basit bir örnek:
SP-API İşlem Başına Hız Sınırlamaları
Farklı SP-API işlemleri farklı hız sınırlarına sahiptir. Bilmeniz gerekenler şu:
| İşlem | İstek Hızı Sınırı | Burst | Kullanım Durumu | Etki |
|---|---|---|---|---|
| GetOrder | 0,5 istek/saniye | 1 | Tek bir siparişin detaylarını alın | Gerçek zamanlı sipariş sorguları için en uygun |
| ListOrders | 0,5 istek/saniye | 1 | Sipariş grubunu getir | Günlük sipariş senkronizasyonu için kullanın. |
| GetInventorySummaries | 2 istek/saniye | 10 | Envanter Seviyelerini Kontrol Edin | SKU’lar genelinde stoğu izleyin |
| UpdateInventory | 2 istek/saniye | 5 | Stok miktarlarını ayarlayın | Toplu güncellemeler önerilir |
| GetListingOffersBatch | 0.1 istek/saniye | 1 | Fiyatlandırma ve Teklifleri Görüntüleyin | En kısıtlayıcı işlem |
| PutProduct | 10 istek/saniye | 10 | Liste Oluşturma/Güncelleme | Toplu listeleme işlemleri |
| CreateInboundShipment | 2 istek/saniye | 10 | FBA sevkiyat oluşturma | Gelen lojistiğini yönetin |
Ana sonuç: GetListingOffersBatch en kısıtlayıcıdır (0.1 istek/saniye); bu nedenle fiyat kontrolleri için dikkatli sınırlama gerekir. Mümkün olduğunda toplu işlemleri kullanın.
SP-API Sınırlamaları ve Önemli Hususlar
Satış Ortağı API son derece güçlü olsa da, yığınınıza entegre etmeden önce dikkate almanız gereken birkaç pratik kısıtlama vardır.
| Kapsam | Bilmeniz Gerekenler | Sizin İçin Ne Anlama Geliyor |
|---|---|---|
| Kayıt Gereksinimleri | SP-API’ye erişim için etkin bir Profesyonel satış planına sahip bir Profesyonel satıcı hesabınız olmalıdır. | Aylık plan için bütçe ayırın ve oluşturmaya veya test etmeye başlamadan önce hesap durumunuzu onaylayın. |
| İstek Sınırı | SP-API, işlem başına istek sınırlarını uygular; bu sınırları aştığınızda kısıtlama yanıtları (HTTP 429) alınır. | İstek kuyruğu kurun, mümkün olduğunca toplu işlemler yapın ve yük altında hataları önlemek için üssel geri çekilmeyi kullanın. |
| Bölgesel kısıtlamalar | Kimlik bilgileriniz bireysel pazaryerlerine bağlıdır (ör. amazon.com ile amazon.co.uk). | Çok bölge kurulumları için her pazaryeri için ayrı kimlik bilgileri ve yönlendirme mantığı gerekir. |
| Sandbox Ortamı | Amazon, üretim dışı testler için bir sandbox uç noktası sağlar. | Gerçek siparişler veya hesap verileri riske girmeden, başlangıç geliştirme ve regresyon testleri için sandbox’ı kullanın. |
İlk günden bu sınırları aklınızda tutarak entegrasyonunuzu tasarlarsanız, SP-API uygulamanız Amazon işiniz büyüdükçe çok daha stabil, ölçeklenebilir ve bakımı kolay olur.
Ürün Reklam API’si: Satış Ortaklığı Pazarlamacısının Aracı
Product Advertising API, bağlı kuruluşların Amazon ürün verilerini harici sitelerde görüntülemek için çekmesine olanak tanır. Özellikle programlı olarak ürün bilgileri, incelemeler, fiyatlar ve stok durumunu almak isteyen Amazon Associates için tasarlanmıştır.
Product Advertising API Nedir?
The Product Advertising API, Amazon’un ürün kataloğuna yalnızca okunabilir erişim sağlar. Anahtar kelimelerle ürün arayabilir, başlık, açıklama, görseller, fiyatlandırma, stok durumu ve müşteri yorumları dahil ayrıntılı ürün bilgilerini elde edebilirsiniz. Önemli olan, elde edilen tüm verinin bir web sitesinde gösterilmesidir; API toplu veri kazıma veya çevrimdışı analiz için tasarlanmamıştır.
Product Advertising API ile Neler Yapabilirsiniz?
- Ürün Araması. Anahtar kelimelerle Amazon kataloğunu sorgulayın ve kullanıcıların arama yaptığı kelimelere göre güncellenen ana bilgilerle eşleşen ürünleri elde edin; bu, kullanıcıların arama sorgularına göre dinamik ürün blokları için idealdir.
- Zengin ürün ayrıntılarını elde edin. Belirli ürünler için başlık, açıklama, görseller, marka, puanlar, inceleme sayısı, fiyatlandırma ve ASIN dahil tam meta verisini alın; böylece ayrıntılı ürün kartları ve karşılaştırma tabloları oluşturabilirsiniz.
- Müşteri yorumlarını alın. Yorum metni, puanlar, tarihler ve inceleyen isimlerini elde edin; bu verileri sitenizdeki inceleme widget’ları, referans bölümleri veya bağımsız inceleme toplama sayfaları için kullanın.
- Mevcutluk ve Fiyatlandırmayı Kontrol Edin. Yakın gerçek zamanlı fiyat ve stok durumuna erişin; bu, karşılaştırma sitelerinin bir ürünün şu anda mevcut olup olmadığını veya geçici olarak stoklarda olmadığını gösterebilmesi için kritik öneme sahiptir.
- Kapsamlı alışveriş deneyimleri oluşturun. Sepetlerle mini alışveriş akışları oluşturun, aynı ürün için birden çok satıcıdan teklifler toplayın ve kullanıcıları izleme bağlantılarıyla Amazon’a yönlendirerek bağlı kuruluş komisyonlarının doğru atanmasını sağlayın.
Hızlı Başlangıç: Node.js ile Ürün Araması
İşte ürünleri aramak için basit bir örnek:
de>const axios = require("axios");
const partnerId = "YOUR_PARTNER_TAG";
const apiKey = "YOUR_API_KEY";
const apiHost = "webservices.amazon.com";
async function searchProducts(keyword) {
const endpoint = "/paapi5/searchitems";
const payload = {
Keywords: keyword,
PartnerTag: partnerId,
PartnerType: "Associates",
SearchIndex: "All",
Resources: [
"Images.Primary.Medium",
"ItemInfo.Title",
"Offers.Listings.Price",
"CustomerReviews.Count",
"CustomerReviews.StarRating"
]
};
try {
const response = await axios.post(
`https://${apiHost}${endpoint}`,
payload,
{
headers: {
"Content-Type": "application/json",
"X-API-Key": apiKey
}
}
);
const products = response.data.SearchResult.Items;
console.log(`Found ${products.length} products for "${keyword}"`);
products.forEach((item) => {
console.log(`- ${item.ItemInfo.Title.DisplayValue}`);
console.log(
` Price: $${item.Offers.Listings[0].Price.DisplayPrice}`
);
console.log(
` Rating: ${item.CustomerReviews.StarRating.DisplayValue}★`
);
});
} catch (error) {
console.error(
`Error: ${error.response.status} - ${error.response.data.Errors[0].Message}`
);
}
}
searchProducts("best gaming headphones");
Product Advertising API Sınırlamaları ve Önemli Hususlar
Product Advertising API etrafında geliştirmenize başlamadan önce, bağlı ortaklık entegrasyonunuzun beklenmedik engellerle karşılaşmaması için bu kısıtlamaları anladığınızdan emin olun.
| Kapsam | Bilmeniz Gerekenler | Sizin İçin Ne Anlama Geliyor |
|---|---|---|
| Amazon Ortaklık Onayı | En az 30 gün onaylı ve belirli sayıda nitelikli satış gerçekleştirmiş aktif bir Amazon Associates hesabına ihtiyacınız var. | Bu API’ye tamamen yeni bir site için güvenemezsiniz; geliştirme öncesinde trafik elde etmek ve ilk dönüşümleri sağlamak için zaman planlayın. |
| Salt okunur erişim | API yalnızca katalog verilerini döndürür; listelemeleri oluşturamaz, güncelleştiremez veya silemez. | Ürün verileri ve bağlantılar için kullanın; Amazon tarafındaki envanter veya teklifler için değil. |
| Kullanım sınırları | Günlük istek kotası uygulanır (24 saatlik dönemde 100.000 istek). Başarılı bağlılar için daha yüksek katmanlar mevcuttur. | Ürün verilerini önbelleğe al, çağrıları toplu olarak yap ve yoğun günlerde sıkı limitlere takılmaman için istek hacmini izle. |
| Görüntüleme Gereksinimleri | Veri, uygun atıf ile kamu bir web sitesinde gösterilmeli ve makul ölçüde güncel tutulmalıdır. | (API’yı yalnızca çevrimdışı analiz için kullanmayın veya verileri uyumsuz kanallara veya kapalı araçlara yeniden yayımlamayın.) |
| Coğrafi Kısıtlamalar | Erişim belirli bölgesel Ortaklık programlarına ve desteklenen ülkelere bağlıdır. | Birden çok bölgeyi hedefliyorsanız, bölge başına ayrı Associate hesapları ve yapılandırmalar gerekebilir. |
Entegrasyonu tasarlarken bu kuralları aklınızda tutun; Product Advertising API, bağlı kuruluş trafiğiniz büyüdükçe istikrarlı, uyumlu ve ölçeklenebilir kalacaktır.
Amazon Advertising API: Kampanya Yöneticisinin Seçimi
Amazon Reklam API’si, sponsorlu ürün, marka ve görüntülü reklam kampanyalarının programatik olarak yönetilmesini sağlar. Büyük ölçekli reklam yönetimi yapan ajanslar, satıcılar ve platformlar için tasarlanmıştır.
Amazon Reklam API Nedir?
The Amazon Advertising API Reklam hesaplarınıza programatik erişim sağlar. Kampanyalar oluşturup yönetin, teklifleri ve bütçeleri ayarlayın, ayrıntılı performans metriklerini elde edin ve reklam harcamasını otomatik olarak optimize edin. Advertising Console’da manuel kampanya yönetiminin aksine, API gerçek performans verilerine dayalı olarak anlık optimizasyon sağlar.
Amazon Reklam API ile Ne Yapabilirsiniz?
- Kampanya yönetimi. Yeni kampanyalar oluşturun, performansı düşenleri durdurun, koşullar iyileştiğinde yeniden başlatın ve hedefleme, bütçeler ve zamanlamaları otomatik olarak ayarlayın.
- Teklif optimizasyonu. Gösterimler, tıklamalar, dönüşümler veya ACoS gibi metriklere göre teklifler otomatik olarak ayarlanır; yüksek performanslı anahtar kelimeler daha çok bütçe alır, düşük performanslılar ise küçültülür.
- Performans Raporlama. Kampanya, reklam grubu ve anahtar kelime düzeyinde gösterim, tıklama, harcama, dönüşüm ve gelir verilerini içeren ayrıntılı raporlar elde edin; özel panolar ve uyarılar için güçlendirin.
- Çoklu hesap yönetimi. Tek bir sistemden birçok marka veya müşteri için kampanyaları yönetin, küresel optimizasyon kuralları uygulayın ve hesaplar arasında raporlamayı standartlaştırın.
- Atıf İçgörüleri. Atıf verilerini kullanarak Amazon dışı trafik kaynaklarını (arama, sosyal medya, e-posta) elde edilen Amazon satışlarıyla ilişkilendirin ve tam dönüşüm hunisi ROI’sını anlayın.
Hızlı Başlangıç: Kampanya Performansını Getir (Python)
import requests
from datetime import datetime, timedelta
access_token = "YOUR_OAUTH_TOKEN"
profile_id = "YOUR_PROFILE_ID"
headers = {
"Authorization": f"Bearer {access_token}",
"Content-Type": "application/json",
"Amazon-Advertising-API-ClientId": "YOUR_CLIENT_ID"
}
# Get campaign metrics from last 7 days
end_date = datetime.today().strftime("%Y%m%d")
start_date = (datetime.today() - timedelta(days=7)).strftime("%Y%m%d")
payload = {
"reportDate": end_date,
"metrics": "impressions,clicks,costPerClick,spend,sales,asin",
"filters": [
{
"field": "campaignStatus",
"operator": "IN",
"values": [ "ENABLED" ]
}
]
}
url = "https://advertising-api.amazon.com/v2/reports"
response = requests.post(
url,
headers=headers,
json=payload,
params={"profileId": profile_id}
)
if response.status_code == 202:
report_id = response.json()["reportId"]
print(f"Report generated: {report_id}")
# Poll for results...
else:
print(f"Error: {response.status_code}");
Amazon Advertising API Sınırlamaları ve Önemli Hususlar
Diğer Amazon API’leri gibi Reklam API’nin de kampanya araçlarınızda dikkate almanız gereken kendi erişim kuralları ve teknik kısıtlamaları vardır.
| Kapsam | Bilmeniz Gerekenler | Sizin İçin Ne Anlama Geliyor |
|---|---|---|
| Reklam Hesabı Gerekli | En az bir onaylı kampanyası olan aktif bir Amazon Advertising hesabı gerekir. | Kampanyaları önce konsolda kurup doğrulayın, ardından otomasyon için API’yi üzerine ekleyin. |
| İstek Sınırı | API istekleri saniyede 10 istekle sınırlıdır. Sınırı aştığınızda HTTP 429 yanıtları alınır. | Raporlama ve optimizasyon görevlerinin hız sınırlamasına takılmaması için toplu işlem, geri çekme ve zamanlama uygulayın. |
| Bölgesel Ayrım | Kimlik bilgileri ve varlıklar belirli bir pazaryerine bağlıdır (ör. US vs. EU). | Bölgesel raporlama veya yönetim, her bölgenin kimlik bilgileri ve varlıklarını ayrı ayrı ele almayı gerektirir. |
| Sınırlı tarih aralığı | API genellikle son 60 gün için performans verisi sağlar. Daha eski veriler için Amazon’un Raporlar işlevinin kullanılması gerekir. | Yerel geri sayım penceresinin ötesinde uzun vadeli trend analizleri için verilerinizi kendi saklama alanınızda tutun. |
Bu kısıtları baştan planlayarak, harcama, trafik ve yönetilen hesap sayısı arttıkça bile güvenilir kalan bir reklam otomasyonu mimarisi kurabilirsiniz.
Vendor Central API ve Diğer Özelleştirilmiş API’ler
Eğer bir Amazon Vendor’ı (Satıcı değil) iseniz entegrasyonunuz önemli ölçüde farklı gereksinimlere sahip olur. Amazon Vendor’ları, Amazon’un envanteri doğrudan sizden satın aldığı farklı bir iş modeliyle çalışır.
Vendor Central API
The Vendor Central API tedarik zinciri yönetimi yetenekleri, satın alma siparişleri, faturalar, gönderi takibi ve envanter yönetimini kapsar. SP-API’den farklı kimlik doğrulama yöntemleri kullanan, Amazon Tedarikçileri için özel olarak tasarlanmıştır.
Ana Yetkinlikler
- Amazon’dan gelen satın alma emirlerini görüntüleyin ve yönetin
- Kargo durumu ve teslimat bilgilerini izleyin
- Katalog düzeyinde finansal raporları alın
- Fatura gönderimlerini yönetin ve ödeme takibini yapın
- Envanter performans metriklerini izleyin
Vendor API erişimi, Amazon Satıcı İş Yöneticinizden davet ister. Erişim SP-API gibi kendi kendine hizmet değildir — kimlik bilgilerini ayarlamak için Satıcı İş Yöneticinizle çalışmanız gerekir.
Kimlik Doğrulama Yöntemleri ve Başlangıç
Tüm Amazon API’leri kimlik doğrulama gerektirir, ancak kullandığınız API’ye bağlı olarak yöntemler değişir.
SP-API: OAuth 2.0 + Amazon ile Giriş
SP-API güvenli yetkilendirme için OAuth 2.0 ile Amazon ile Giriş (LwA) kombinasyonunu kullanır.
Nasıl Çalışır
- Uygulamanız satıcıyı Amazon’un yetkilendirme sayfasına yönlendirir
- Satıcı oturum açar ve uygulamanıza izin verir
- Amazon bir yetkilendirme kodu döndürür
- Uygulamanız kodu bir erişim belirteciyle değiş tokuş eder
- Tüm API isteklerinde token’ı kullanın
Başlarken
Ziyaret edin https://developer.amazonservices.com/register ve şu adımları izleyin:
- Bir satıcı hesabı oluşturun (Profesyonel plan gerekli)
- Satıcı Merkezi’nde geliştirici olarak kaydolun
- AWS’te bir IAM rolü oluşturun
- Uygulamanızı kaydedin ve LwA kimlik bilgilerinizi alın
- Uygulamanızda OAuth akışını uygulayın
Product Advertising API: API Anahtarı
Product Advertising API, daha basit bir API anahtarı kimlik doğrulama yöntemi kullanır.
Başlarken
- Aktif ve onaylı bir Amazon Associates hesabınız olduğundan emin olun
- İlk onayınızın üzerinden 30 günden fazla geçmiş olmalıdır.
- En az 3 komisyon elde edildi
- Ziyaret Edin https://affiliate-program.amazon.com/
- Araçlar → Product Advertising API sayfasına gidin
- API anahtarınızı kopyalayın
- Anahtarınızla istek göndermeye başlayın
Amazon Reklam API: OAuth 2.0
Amazon Advertising API de kimlik doğrulama için OAuth 2.0 kullanır.
Başlarken
- Kayıt için https://advertising.amazon.com/
- Reklam konsolu ayarlarına gidin
- API erişim kimlik bilgilerini bulun
- OAuth 2.0’ı seçin ve yetkilendirme akışını izleyin
- API istekleri için geri dönen token’ları kullanın.
Pratikte, üç API de aynı temel fikri takip eder: Uygulamanız asla Amazon ile anonim biçimde iletişim kurmaz. OAuth token kullanın ya da API anahtarı kullanın; önce kimlik doğrulamanızı yapın, ardından yetkilendirildiğiniz uç noktalara çağrı yapın. Bu temel kurulduğunda, düşük seviyeli kimlik doğrulama ayrıntılarıyla uğraşmak yerine özellikleri oluşturmaya odaklanabilirsiniz.
Amazon API Fiyatlandırması ve Maliyetleri (2025-2026)
“31 Ocak 2026 tarihinden itibaren, SP-API ile entegre olan tüm üçüncü taraf geliştiricilere yıllık abonelik ücreti olarak 1400 USD uygulanacaktır.”
Selling Partner API Fiyatlandırması
Bu abonelik, Çözüm Sağlayıcı Portalı’na erişim, destek ve canlı SP‑API kullanımı için erişim sağlar; faturalandırma, mevcut hesaplar için belirtilen başlangıç tarihine veya geliştiricinin ilk üretim çağrısına göre başlar.
30 Nisan 2026’dan itibaren, Amazon GET çağrı hacmine dayalı aylık bir ücret uygulayacak; dört kullanım katmanı (Basic, Pro, Plus, Enterprise) ve ücretsiz bir Basic katmanı mevcut. Geliştiriciler ücretleri beklenen tutarlarda bir ücret önizleme aracında görebilir ve gereksiz çağrıları azaltıp ücretleri düşürmek için altı aylık bildirim süresi ile çağrı optimizasyonu rehberliği alacaklar.
| Katman | Aylık GET Çağrıları Dahil | Aylık Ücret | Aşım Ücreti |
|---|---|---|---|
| Temel | 2,5 milyon | $0 | 1.000 çağrı başına 0,40$ |
| Profesyonel | 25 milyon | $1,000 | 1.000 çağrı başına 0,40$ |
| Artı | 250 milyon | $10,000 | 1.000 çağrı başına 0,40$ |
| Kurumsal | Özel | Özel | Amazon ile iletişime geçin |
Önemli Noktalar
- Tüm geliştiriciler için varsayılan katman Temel
- PUT, PATCH, POST istekleri ölçülmemiştir (sınırsız, ancak hız sınırları uygulanır)
- Sadece GET istekleri aylık kotanıza dahil olur.
- Kademenizin dahil ettiği çağrı sayısını aştığınızda ek ücretler uygulanır
Hata Yönetimi ve Sorun Giderme Kılavuzu
İyi tasarlanmış entegrasyonlar bile hatalarla karşılaşır. Amazon API hatalarını nasıl ele alacağınız şöyle:
HTTP Durum Kodları ve Çözümler
| Durum Kodu | Hata Türü | Anlamı | Çözüm |
|---|---|---|---|
| 400 | Geçersiz İstek | Kötü biçimlendirilmiş istek (geçersiz JSON, gerekli alanlar eksik) | İsteğiniz yükünü kontrol edin; API belgeleriyle doğrulayın |
| 401 | Yetkisiz | Geçersiz veya süresi dolmuş kimlik doğrulama belirteci | OAuth token’ınızı yenileyin; kimlik bilgilerinizi doğrulayın |
| 403 | Yasak | Bu işlem için izniniz yok | Uygulamanızın gerekli kapsamlara sahip olduğundan emin olun; satıcı hesabı durumunu kontrol edin |
| 404 | Not Found | Kaynak mevcut değil (sipariş/ASIN bulunamadı) | Kaynak Kimliğinin doğru olduğundan emin olun; mevcut olup olmadığını kontrol edin |
| 429 | Çok Fazla İstek | İstek limiti aşıldı | Üssel geri çekilme uygulayın; katman limitlerinizi kontrol edin; yükseltmeyi düşünün |
| 500 | Dahili Sunucu Hatası | Amazon sunucularında bir hata oluştu | 30 sn sonra yeniden dene; Amazon Servis Sağlığı’nı kontrol et; sorun sürerse destek ile iletişime geç. |
| 503 | Hizmet Kullanılamıyor | Amazon hizmeti şu anda geçici olarak kullanılamıyor | 5–10 dakika bekleyin; durum sayfasını kontrol edin; geri çekilme ile yeniden deneyin |
Uygulamada, çoğu sorun birkaç temel desene indirgenir: hatalı giriş (400’ler), eksik veya geçersiz kimlik doğrulama (401/403), hız sınırları (429) veya Amazon tarafında geçici platform sorunları (500/503). Hata yönetimini merkezi hale getirir, yanıtları kaydeder ve tutarlı yeniden deneme ile geri çekme kuralları uygularsanız, bu kodları üretim acil durumları yerine öngörülebilir sinyallere çevirebilirsiniz.
Amazon API’leri İçin Hızlı Optimizasyon İpuçları
Doğru Amazon API’sini seçtikten sonra, birkaç basit optimizasyon tekniği çağrı hacmini önemli ölçüde azaltabilir, yanıt sürelerini hızlandırabilir ve entegrasyonun maliyet ile hız sınırları içinde kalmasını sağlayabilir.
- İhtiyacınız Olanı Sadece İsteyin. Tüm siparişler veya ürünler için tam yükleri çekmek yerine alan filtreleri ve dar kapsamlar kullanın.
- Akıllı önbellekleme ekleyin. Saatler boyu stabil veriyi, dakikalar içinde değişen verileri önbelleğe alın ve gösterge panelleri ile raporlardaki tekrarlayan çağrıları azaltın.
- Olası olduğunda toplu çağrı kullanın. Tek seferde çoklu ID’leri tek istekle kabul eden toplu uç noktalarını tercih edin.
- Hız sınırlamalarını zarifçe yönetin. HTTP 429 yanıtında, hemen yeniden denemek yerine gecikileri artırarak geri çekilin.
- Kullanımınıza Dikkat Edin. Çağrı hacmini, gecikmeyi ve hata oranını izleyin; katı limitlere veya ek ücret dilimlerine yaklaşmadan önce uyarılar kurun.
- Olaylar üzerinden tetikleyin. Mevcut olduğunda, “her dakika kontrol et” desenlerini webhooks/bildirimlerle değiştirin ve gereksiz API trafiğini azaltın.
Amazon API’leri Hakkında Sık Sorulan Sorular
Aşağıda Amazon API’leriyle ilgili en sık sorulan bazı sorular bulunmaktadır:
Birden fazla Amazon API’sini birlikte kullanabilir miyim?
En Kolay Entegre Edilebilen API Hangisi?
Amazon API’leri ücretli mi?
İstek sınırlarını aştığınızda ne olur?
API kullanımımı ölçeklendirebilir miyim?
SP-API için Profesyonel bir satıcı hesabına ihtiyacınız var mı?
Product Advertising API’yi sadece veri kazıma veya dahili araçlar için mi kullanabilirim?
Daha fazla rehbere ihtiyaç duyarsanız, Amazon Geliştirici Merkezi tüm Satış Ortağı, Reklam ve Ortaklar belgelerini tek bir yerde listeler; Seller Central Yardım Merkezi ise API entegrasyonunuzun bağlı olduğu hesap, politika ve operasyonel soruları kapsar.
İleriye Doğru
Amazon’daki satış operasyonlarınızı otomatikleştirmek, bağlı kuruluş gelir akışları oluşturmak, reklam kampanyalarını ölçekli olarak yönetmek veya Amazon ekosistemi için SaaS araçları geliştirmek; doğru API, önemli verimlilik artışları ve gelir fırsatları sunar.
