Jika Anda terhubung dengan Amazon sebagai penjual, afiliasi, atau pengiklan, Anda akan menghadapi pilihan krusial: API mana yang benar-benar memenuhi kebutuhan Anda? Amazon menawarkan empat API berbeda, masing-masing dirancang untuk berbagai kasus penggunaan.
Dengan penghapusan Marketplace Web Services (MWS) lama, semua integrasi Amazon modern harus memilih antara Selling Partner API, Product Advertising API, Amazon Advertising API, dan API khusus seperti Vendor Central API. Panduan ini membimbing Anda melalui seluruh ekosistem, mulai dari mengidentifikasi API yang Anda perlukan hingga memahami metode otentikasi, sehingga Anda bisa membuat keputusan yang tepat mengenai strategi integrasi Anda.
Memahami kasus penggunaan Anda adalah langkah pertama. Mari kita jelajahi konsep kunci, mulai dari aplikasi umum pada API Amazon.
Di mana API Amazon Diterapkan?
Ekosistem API Amazon melayani beberapa komunitas, masing-masing dengan kasus penggunaan dan model bisnis yang berbeda.
Penjual Amazon & Operator Multisaluran
Penjual profesional mengandalkan Selling Partner API untuk mengelola persediaan di seluruh FBA (Fulfillment by Amazon) dan FBM (Fulfillment by Merchant), mengotomatisasi strategi penetapan harga, menghasilkan laporan, menangani pesanan dan pengembalian secara terprogram, atau mengintegrasikan Amazon dengan sistem ERP, perangkat lunak akuntansi, dan platform manajemen persediaan.
Pemasar Afiliasi & Pembuat Konten
Afiliasi pemasar dan pembuat konten menggunakan Product Advertising API untuk mengambil informasi produk Amazon, ulasan, harga, dan data ketersediaan untuk ditampilkan di situs mereka. Baik saat membangun alat perbandingan produk, pengumpul ulasan, atau blog produk niche, API memungkinkan monetisasi melalui struktur komisi Amazon Associates tanpa penjualan langsung.
Agen Periklanan & Spesialis PPC
Agen yang mengelola kampanye iklan Amazon dalam skala besar menggunakan Amazon Advertising API untuk membuat, memperbarui, menjeda, dan mengoptimalkan produk beriklan, merek, dan iklan tampilan secara terprogram. API ini menyediakan metrik kinerja kampanye secara real-time, kemampuan otomatisasi tawaran, dan data atribusi yang tidak bisa dicapai dengan optimasi manual.
Pengembang Platform SaaS
Pengembang yang membangun solusi SaaS untuk penjual Amazon mengintegrasikan SP-API untuk membuat dasbor manajemen, alat penyesuaian harga otomatis, alat listing otomatis, platform analitik, dan aplikasi khusus industri. Contoh: SaaS penyesuaian harga yang memantau harga pesaing dan secara otomatis menyesuaikan harga Anda agar tetap kompetitif sambil menjaga margin keuntungan.
Pemasok & Dropshippers
Vendor Amazon dan platform vendor khusus menggunakan API vendor khusus untuk mengelola rantai pasokan, mengakses data penjualan yang dirangkum pada tingkat katalog, dan terintegrasi dengan sistem pengadaan. Dropshippers sering menggabungkan Product Advertising API dengan SP-API untuk mengelola feed produk dan pesanan secara otomatis.
Memahami Ekosistem API Amazon
Pada 31 Maret 2024, Amazon mematikan endpoint MWS warisan-nya, sehingga setiap alat penjual yang serius kini harus berjalan di Selling Partner API (SP-API) yang modern untuk terus mengambil pesanan, persediaan, dan data pembayaran secara andal.
Saat ini, Amazon tidak menyediakan satu API terpadu – melainkan API khusus yang dioptimalkan untuk alur kerja yang berbeda. Sebelum memilih API, Anda perlu memahami apa saja yang dilakukan masing-masing API.
Empat API utama Amazon
Tabel ini menunjukkan perbedaan SP-API, Product Advertising, Amazon Advertising, dan Vendor Central API dalam tujuan, skenario penggunaan utama, pengguna utama, dan model otentikasi—memberi Anda filter awal yang jelas untuk pilihan Anda.
| API | Tujuan | Terbaik untuk | Pengguna Utama | Otentikasi |
|---|---|---|---|---|
| Selling Partner API (SP-API) | Pengelolaan data pesanan, persediaan, listing, dan keuangan | Penjual dan vendor yang mengotomatiskan operasional | Penjual profesional, vendor, dan pengembang | OAuth 2.0 + LwA (Masuk dengan Amazon) |
| Product Advertising API | Pengambilan data produk untuk situs afiliasi | Menampilkan produk Amazon di situs eksternal | Pemasar afiliasi, pembuat konten, situs ulasan | Kunci API + OAuth 2.0 |
| API Periklanan Amazon | Manajemen kampanye dan kinerja iklan | Mengelola iklan bersponsor secara terprogram | Agen periklanan, penjual, manajer merek | OAuth 2.0 + LWA |
| Vendor Central API (Hak Milik Vendor) | Rantai pasokan dan pelaporan khusus vendor. | Rantai Pasokan dan Pengadaan | Hanya vendor Amazon | Kredensial AWS atau OAuth |
Setiap API berfungsi secara independen dengan autentikasi, batas laju, dan struktur harga yang terpisah. Memilih yang tepat sepenuhnya bergantung pada apa yang ingin Anda capai.
Kerangka Keputusan Cepat
Jika Anda tidak yakin API Amazon mana yang sebenarnya Anda perlukan, gunakan kerangka kerja singkat ini sebelum membaca dokumentasi. Ini memetakan tujuan yang paling umum ke API yang tepat agar Anda tidak membuang waktu mengintegrasikan API yang salah.
Memilih API Amazon menjadi jauh lebih mudah jika Anda menautkannya pada satu tujuan yang konkret. Seiring bertambahnya tumpukan teknologi Anda, Anda mungkin menggabungkan beberapa API dalam satu solusi, namun kerangka kerja ini menjaga setiap integrasi tetap berpegang pada tujuan yang jelas, bukan teknologi semata. Pada bagian-bagian berikut, kita akan membahas setiap API secara rinci, termasuk kemampuan, keterbatasan, dan bagaimana memulai.
Selling Partner API (SP-API): Tulang Punggung Penjual Modern
Pada September 2021, SP‑API menjadi standar baru dan penerus fungsional dari MWS (Marketplace Web Services). Saat ini, SP-API adalah API utama untuk penjual Amazon di seluruh dunia dan menjadi fondasi operasional penjualan profesional.
Apa itu SP-API?
Selling Partner API adalah API berbasis REST yang memberi penjual Amazon akses programatik ke data bisnis mereka. Ini mencakup pesanan, pengiriman, tingkat persediaan, daftar produk, transaksi keuangan, pengembalian, dan pelaporan rinci. Lebih dari 1 juta penjual di seluruh dunia menggunakan SP-API untuk mengotomatiskan dan memperluas operasional mereka.
Apa yang Bisa Anda Lakukan dengan SP-API?
- Manajemen Inventaris & Daftar Produk. Tambahkan, perbarui, atau hapus listing produk secara terprogram, kelola stok di beberapa SKU dan marketplace, serta lakukan pembaruan massal untuk katalog besar daripada mengedit semuanya secara manual di Seller Central.
- Pemrosesan Pesanan & Pengiriman. Ambil pesanan secara real time, konfirmasi pengiriman, perbarui nomor pelacakan, tangani pembatalan dan pengembalian dana, dan buat slip kemasan agar pesanan bisa mengalir langsung dari Amazon ke pusat pemenuhan Anda.
- Otomatisasi Penetapan Harga. Sesuaikan harga secara otomatis berdasarkan tingkat persediaan, kecepatan penjualan, aktivitas pesaing, atau tren pasar, menggunakan logika penyesuaian harga yang dapat mengoptimalkan ribuan SKU secara real-time.
- Data keuangan & pelaporan. Tarik laporan rinci tentang kinerja penjualan, lalu lintas, usia persediaan, rekomendasi restock, dan peristiwa keuangan tanpa mengunduh CSV secara manual, memungkinkan analisis mutakhir di dasbor Anda sendiri.
- Returns, refunds & external integrations. Otomatiskan alur kerja pengembalian (detail pengembalian, label, pengembalian dana) dan sinkronkan Amazon dengan ERP, CRM, akuntansi, dan sistem pengiriman sehingga data operasional berpindah antar alat tanpa entri data manual.
Mulai Cepat: Panggilan SP-API Pertama Anda (Python)
Berikut contoh minimal untuk mengambil pesanan terbaru Anda:
import requests
from datetime import datetime, timedelta
access_token = "YOUR_ACCESS_TOKEN"
region = "us-east-1"
headers = {
"Authorization": f"Bearer {access_token}",
"Content-Type": "application/json"
}
created_after = (datetime.utcnow() - timedelta(days=7)).isoformat() + "Z"
url = "https://sellingpartnerapi-na.amazon.com/orders/v0/orders"
params = {
"CreatedAfter": created_after,
"OrderStatuses": "Unshipped,PartiallyShipped,Pending"
}
response = requests.get(url, headers=headers, params=params)
if response.status_code == 200:
orders = response.json()
print(f"Retrieved {len(orders['Orders'])} orders")
for order in orders["Orders"]:
print(f"Order {order['AmazonOrderId']}: ${order['OrderTotal']['Amount']}")
else:
print(f"Error: {response.status_code} - {response.text}")
Batas Laju SP-API Berdasarkan Operasi
Berbagai operasi SP-API memiliki batas laju yang berbeda. Berikut yang perlu Anda ketahui:
| Operasi | Batas Laju | Burst | Kasus Penggunaan | Dampak |
|---|---|---|---|---|
| GetOrder | 0.5 req/sec | 1 | Mengambil detail pesanan tunggal | Terbaik untuk penelusuran pesanan real-time |
| ListOrders | 0.5 req/sec | 1 | Ambil batch pesanan | Gunakan untuk sinkronisasi pesanan harian |
| GetInventorySummaries | 2 permintaan/detik | 10 | Cek stok | Pantau stok di seluruh SKU |
| UpdateInventory | 2 permintaan/detik | 5 | Sesuaikan jumlah stok | Disarankan pembaruan batch |
| GetListingOffersBatch | 0.1 req/sec | 1 | Ambil harga/penawaran | Operasi yang paling dibatasi |
| PutProduct | 10 permintaan/detik | 10 | Buat/Perbarui Daftar Produk | Operasi listing massal |
| CreateInboundShipment | 2 permintaan/detik | 10 | Pembuatan pengiriman FBA | Kelola logistik masuk |
Inti yang perlu diingat: GetListingOffersBatch adalah yang paling membatasi (0,1 permintaan/detik), sehingga pemeriksaan harga perlu pembatasan laju yang hati-hati. Gunakan operasi batch jika memungkinkan.
Keterbatasan SP-API & Pertimbangan Penting
Meskipun Selling Partner API sangat kuat, ia datang dengan beberapa kendala praktis yang perlu Anda rencanakan sebelum mengintegrasikannya ke dalam tumpukan teknologi Anda.
| Aspek | Yang Perlu Anda Ketahui | Apa Artinya bagi Anda |
|---|---|---|
| Persyaratan pendaftaran | Anda harus memiliki akun Penjual Profesional dengan paket Penjualan Profesional yang aktif untuk mengakses SP-API. | Tentukan anggaran untuk paket bulanan dan konfirmasikan status akun Anda sebelum mulai membangun atau menguji. |
| Pembatasan Laju | SP-API enforces operation-specific request limits; going over them triggers throttling responses (HTTP 429). | Terapkan antrian permintaan, pengelompokan saat memungkinkan, dan backoff eksponensial untuk menghindari kegagalan saat beban tinggi. |
| Pembatasan regional | Kredensial terkait dengan marketplace individu (mis. amazon.com vs amazon.co.uk). | Untuk pengaturan multi-region, Anda memerlukan kredensial terpisah dan logika routing per marketplace. |
| Lingkungan Sandbox | Amazon menyediakan endpoint sandbox untuk pengujian non-produksi. | Gunakan sandbox untuk pengembangan awal dan pengujian regresi sehingga Anda tidak membahayakan pesanan nyata atau data akun. |
Jika Anda merancang integrasi dengan batasan ini sejak hari pertama, implementasi SP-API Anda akan jauh lebih stabil, skalabel, dan mudah dipelihara saat bisnis Amazon Anda tumbuh.
Product Advertising API: Alat Pemasar Afiliasi
Product Advertising API memungkinkan afiliasi mengambil data produk Amazon untuk ditampilkan di situs eksternal. Dirancang khusus untuk Amazon Associates yang ingin secara programatis mengambil informasi produk, ulasan, harga, dan ketersediaan.
Apa itu Product Advertising API?
API Periklanan Produk menyediakan akses baca-saja ke katalog produk Amazon. Anda dapat mencari produk menggunakan kata kunci, mengambil informasi produk terperinci termasuk judul, deskripsi, gambar, harga, ketersediaan, dan ulasan pelanggan. Yang penting, semua data yang diambil harus ditampilkan di situs web— API tidak dirancang untuk scraping data massal secara offline.
Apa yang bisa Anda lakukan dengan Product Advertising API?
- Pencarian produk. Cari katalog Amazon berdasarkan kata kunci dan dapatkan produk yang cocok dengan detail utama, ideal untuk blok produk dinamis yang diperbarui berdasarkan apa yang dicari pengguna.
- Ambil detail produk yang kaya. Tarik metadata lengkap untuk item tertentu, termasuk judul, deskripsi, gambar, merek, peringkat, jumlah ulasan, harga, dan ASIN, sehingga Anda bisa membangun kartu produk dan tabel perbandingan yang rinci.
- Ambil ulasan pelanggan. Dapatkan teks ulasan, penilaian, tanggal, dan nama pengulas untuk memperkaya widget ulasan, bagian testimoni, atau halaman agregasi ulasan mandiri di situs Anda.
- Periksa ketersediaan dan harga. Akses harga dan status stok nyaris waktu nyata, yang krusial bagi situs perbandingan yang harus menunjukkan apakah barang saat ini tersedia atau sedang kehabisan stok sementara.
- Bangun pengalaman belanja lengkap. Buat alur belanja mini dengan keranjang belanja, tarik penawaran dari beberapa penjual untuk produk yang sama, dan arahkan pengguna ke Amazon dengan tautan pelacakan agar komisi afiliasi tercatat dengan benar.
Mulai Cepat: Pencarian Produk dengan Node.js
Berikut contoh sederhana untuk mencari produk:
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");
Keterbatasan Product Advertising API & Pertimbangan Penting
Sebelum Anda mulai membangun dengan Product Advertising API, pastikan Anda memahami batasan-batasan ini agar integrasi afiliasi Anda tidak mengalami hambatan yang tak terduga.
| Aspek | Yang Perlu Anda Ketahui | Apa Artinya bagi Anda |
|---|---|---|
| Persetujuan Amazon Associates | Anda memerlukan akun Amazon Associates yang aktif, telah disetujui selama setidaknya 30 hari, dan telah menghasilkan jumlah penjualan yang memenuhi syarat. | Anda tidak bisa mengandalkan API ini untuk situs baru; rencanakan waktu untuk mendapatkan lalu lintas dan konversi awal sebelum pengembangan. |
| Akses baca-saja | API hanya mengembalikan data katalog; tidak dapat membuat, memperbarui, atau menghapus daftar produk. | Gunakan untuk data produk dan tautan, bukan untuk mengelola persediaan atau tawaran di sisi Amazon. |
| Batas Penggunaan | Kuota permintaan harian berlaku (100.000 permintaan per 24 jam). Tingkat langganan lebih tinggi tersedia bagi afiliasi yang memenuhi syarat. | Simpan data produk dalam cache, batching pemanggilan, dan pantau volume permintaan agar tidak melampaui batas keras pada hari sibuk. |
| Persyaratan Tampilan | Data harus ditampilkan di situs publik dengan atribusi yang tepat dan diperbarui secara wajar. | Jangan gunakan API hanya untuk analisis offline atau untuk menerbitkan data ke saluran yang tidak patuh atau alat tertutup. |
| Pembatasan geografis | Akses terkait dengan program Afiliasi regional spesifik dan negara yang didukung. | Jika Anda menargetkan beberapa wilayah, Anda mungkin membutuhkan akun Associate terpisah dan konfigurasi per wilayah. |
Rancang integrasi Anda dengan pedoman ini dalam pikiran, agar Product Advertising API tetap stabil, patuh, dan dapat diskalakan seiring pertumbuhan lalu lintas afiliasi Anda.
Amazon Advertising API: Pilihan Manajer Kampanye
API Periklanan Amazon memungkinkan pengelolaan programatik kampanye iklan produk bersponsor, merek, dan display. Dirancang untuk agen, penjual, dan platform yang mengelola iklan dalam skala besar.
Apa itu Amazon Advertising API?
The Amazon Advertising API menyediakan akses programatik ke akun iklan Anda. Anda dapat membuat dan mengelola kampanye, menyesuaikan tawaran dan anggaran, mengambil metrik kinerja rinci, dan mengoptimalkan pengeluaran iklan secara otomatis. Berbeda dengan manajemen kampanye secara manual di Advertising Console, API memungkinkan optimasi real-time berdasarkan data kinerja aktual.
Apa yang Bisa Anda Lakukan dengan Amazon Advertising API?
- Campaign management. Buat kampanye baru, jeda kampanye yang berkinerja buruk, hidupkan kembali saat kondisi membaik, dan sesuaikan penargetan, anggaran, serta jadwal secara otomatis.
- Bid optimization. Ubah tawaran secara otomatis berdasarkan metrik seperti tayangan, klik, konversi, atau ACoS sehingga kata kunci berkinerja tinggi mendapatkan lebih banyak anggaran dan kata kunci lemah dikurangi.
- Laporan Performa. Tarik laporan rinci tentang tayangan, klik, pengeluaran, konversi, dan pendapatan pada tingkat kampanye, grup iklan, dan kata kunci untuk mendukung dasbor dan peringatan kustom.
- Manajemen multi-akun. Kelola kampanye untuk banyak merek atau klien dari satu sistem, terapkan aturan optimasi global, dan standarkan pelaporan di seluruh akun.
- Wawasan atribusi. Gunakan data atribusi untuk menghubungkan sumber lalu lintas di luar Amazon (pencarian, media sosial, email) dengan penjualan Amazon yang dihasilkan dan memahami ROI funnel lengkap.
Mulai Cepat: Mengambil Kinerja Kampanye (Python)
de>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}")
Keterbatasan Amazon Advertising API & Pertimbangan Penting
Seperti API Amazon lainnya, Advertising API memiliki aturan akses dan kendala teknisnya sendiri yang perlu Anda pertimbangkan saat merencanakan alat kampanye Anda.
| Aspek | Yang Perlu Anda Ketahui | Apa Artinya bagi Anda |
|---|---|---|
| Akun Periklanan diperlukan | Anda memerlukan akun Amazon Advertising yang aktif dengan setidaknya satu kampanye yang disetujui. | Siapkan dan validasikan kampanye di konsol terlebih dahulu, lalu tambahkan API di atasnya untuk otomasi. |
| Pembatasan Laju | API membatasi permintaan hingga 10 permintaan per detik. Melebihi batas akan menghasilkan respons HTTP 429. | Terapkan pemrosesan batch, backoff, dan penjadwalan agar pekerjaan pelaporan dan optimasi tidak terbatasi. |
| Pemisahan regional | Kredensial dan entitas terkait dengan marketplace tertentu (misalnya AS vs. UE). | Pelaporan atau manajemen lintas wilayah memerlukan penanganan kredensial dan entitas masing-masing wilayah secara terpisah. |
| Jendela historis terbatas | API biasanya menyediakan data kinerja untuk 60 hari terakhir. Data yang lebih lama memerlukan fungsi Laporan milik Amazon. | Simpan data di penyimpanan Anda sendiri jika Anda memerlukan analisis tren jangka panjang di luar jendela histori bawaan. |
Dengan merencanakan kendala-kendala ini sejak awal, Anda bisa membangun tumpukan otomasi periklanan yang tetap andal seiring meningkatnya pengeluaran, lalu lintas, dan jumlah akun yang dikelola.
Vendor Central API & API Spesialis Lainnya
Jika Anda seorang Vendor Amazon (bukan Penjual), kebutuhan integrasi Anda berbeda secara signifikan. Vendor Amazon beroperasi melalui model bisnis yang berbeda di mana Amazon membeli inventaris langsung dari Anda.
Vendor Central API
Vendor Central API menyediakan kemampuan manajemen rantai pasokan meliputi pesanan pembelian, faktur, pelacakan pengiriman, dan manajemen persediaan. API ini dirancang khusus untuk Vendor Amazon dan menggunakan metode otentikasi yang berbeda dibandingkan SP-API.
Fungsi utama
- Lihat dan kelola pesanan pembelian yang masuk dari Amazon
- Lacak status pengiriman dan informasi pengantaran
- Ambil laporan keuangan pada tingkat katalog
- Kelola pengajuan faktur dan pelacakan pembayaran
- Pantau metrik kinerja persediaan
Akses API Vendor memerlukan undangan dari Manajer Vendor Amazon Anda. Akses tidak bersifat layanan mandiri seperti SP-API – Anda harus bekerja dengan Manajer Bisnis Vendor Anda untuk menyiapkan kredensial.
Metode Otentikasi & Memulai
Semua API Amazon memerlukan autentikasi, tetapi caranya berbeda tergantung pada API mana yang Anda gunakan.
SP-API: OAuth 2.0 + Masuk dengan Amazon
SP-API menggunakan OAuth 2.0 yang dipadukan dengan Login with Amazon (LwA) untuk otorisasi yang aman.
Cara Kerjanya
- Aplikasi Anda mengarahkan penjual ke halaman otorisasi Amazon.
- Penjual masuk dan memberikan izin ke aplikasi Anda
- Amazon mengembalikan sebuah kode otorisasi
- Aplikasi Anda menukar kode dengan token akses
- Anda menggunakan token untuk semua permintaan API
Mulai
Kunjungi https://developer.amazonservices.com/register dan ikuti langkah-langkah berikut:
- Buat akun penjual (rencana Profesional diperlukan)
- Daftar sebagai pengembang di Seller Central
- IAM role in AWS”>Buat peran IAM di AWS
- Daftarkan aplikasi Anda dan peroleh kredensial LwA.
- Terapkan alur OAuth di aplikasi Anda
Product Advertising API: API Key
Product Advertising API menggunakan metode otentikasi kunci API yang lebih sederhana.
Mulai
- Pastikan Anda memiliki akun Amazon Associates yang aktif dan disetujui.
- Lebih dari 30 hari telah berlalu sejak persetujuan pertama Anda
- Minimal 3 komisi yang diperoleh
- Kunjungi https://affiliate-program.amazon.com/
- Buka Tools → Product Advertising API
- Salin kunci API Anda
- Mulailah membuat permintaan dengan kunci Anda.
Amazon Advertising API: OAuth 2.0
API Periklanan Amazon juga menggunakan OAuth 2.0 untuk otentikasi.
Mulai
- Daftar di https://advertising.amazon.com/
- Buka pengaturan konsol iklan Anda
- Cari kredensial akses API
- Pilih OAuth 2.0 dan ikuti alur otorisasi
- Gunakan token yang dikembalikan untuk permintaan API
Secara praktik, ketiga API mengikuti ide inti yang sama: aplikasi Anda tidak pernah berbicara dengan Amazon secara anonim. Baik Anda menggunakan token OAuth maupun kunci API, Anda mengotentikasi dulu, lalu memanggil endpoint yang diizinkan kredensial Anda. Setelah fondasi ini terpasang, Anda bisa fokus membangun fitur alih-alih mengkhawatirkan detail otentikasi tingkat rendah.
Harga API Amazon & Biaya (2025–2026)
“Mulai 31 Januari 2026, semua pengembang pihak ketiga yang terintegrasi dengan SP-API akan dikenai biaya langganan tahunan sebesar 1400 USD.”
Harga Selling Partner API
Langganan ini mencakup akses ke Portal Penyedia Solusi, dukungan, dan penggunaan SP‑API secara langsung, dengan penagihan dimulai pada panggilan produksi pertama pengembang atau pada tanggal mulai yang ditentukan untuk akun yang ada.
Sejak 30 April 2026, Amazon mengenakan biaya bulanan berdasarkan volume panggilan GET, dengan empat tingkat penggunaan (Basic, Pro, Plus, Enterprise) dan tingkat Basic gratis. Pengembang dapat melihat perkiraan biaya melalui alat pratinjau biaya dan diberi pemberitahuan enam bulan beserta panduan optimasi panggilan sehingga mereka bisa mengurangi panggilan yang tidak perlu dan menjaga biaya tetap rendah.
| Tingkat | Jumlah GET Bulanan Termasuk | Biaya Bulanan | Biaya kelebihan penggunaan |
|---|---|---|---|
| Dasar | 2,5 juta | $0 | $0,40 per 1.000 panggilan |
| Pro | 25 juta | $1,000 | $0,40 per 1.000 panggilan |
| Plus | 250 juta | $10,000 | $0,40 per 1.000 panggilan |
| Enterprise | Kustom | Kustom | Hubungi Amazon |
Poin-poin utama
- Semua pengembang secara default ke tier Basic.
- Permintaan PUT, PATCH, POST tidak dikenai meteran (tanpa batas, tetap tunduk pada pembatasan laju)
- Hanya permintaan GET yang dihitung terhadap kuota bulanan Anda
- Biaya kelebihan berlaku jika Anda melebihi kuota panggilan yang disertakan di tier Anda.
Panduan Penanganan Error & Pemecahan Masalah
Bahkan integrasi yang dirancang dengan baik pun bisa mengalami error. Berikut cara menangani kesalahan API Amazon yang umum:
Kode Status HTTP & Solusinya
| Kode Status | Jenis Kesalahan | Arti | Solusi |
|---|---|---|---|
| 400 | Permintaan tidak valid | Permintaan tidak valid (JSON tidak valid, bidang yang diperlukan hilang) | Periksa payload permintaan Anda; validasikan sesuai dokumentasi API |
| 401 | Tidak diizinkan | Token autentikasi tidak valid atau kedaluwarsa | Perbarui token OAuth Anda; verifikasi kredensial |
| 403 | Dilarang | Anda tidak memiliki izin untuk operasi ini | Pastikan aplikasi Anda memiliki hak akses yang diperlukan; periksa status akun penjual |
| 404 | Tidak Ditemukan | Sumber daya tidak ada (pesanan/ASIN tidak ditemukan) | Pastikan ID sumber daya benar; periksa apakah ID tersebut ada |
| 429 | Terlalu Banyak Permintaan | Batas permintaan terlampaui | Terapkan backoff eksponensial; periksa batas tier Anda; pertimbangkan peningkatan. |
| 500 | Kesalahan Server Internal | Server Amazon mengalami kesalahan | Coba lagi setelah 30 detik; periksa Kesehatan Layanan Amazon; hubungi dukungan jika tetap berlanjut. |
| 503 | Layanan tidak tersedia | Layanan Amazon sedang tidak tersedia sementara | Tunggu 5–10 menit; periksa halaman status; coba lagi dengan backoff |
Secara praktis, sebagian besar masalah bermuara pada sejumlah pola: input buruk (400), otentikasi hilang atau tidak valid (401/403), pembatasan laju (429), atau masalah sementara pada platform milik Amazon (500/503). Jika Anda memusatkan penanganan error, mencatat respons, dan menerapkan aturan retry serta backoff yang konsisten, Anda bisa mengubah kode tersebut menjadi sinyal yang bisa diprediksi alih-alih darurat produksi.
Tips Optimasi Cepat untuk API Amazon
Setelah Anda memilih API Amazon yang tepat, beberapa teknik optimisasi sederhana bisa secara signifikan mengurangi volume permintaan, mempercepat respons, dan menjaga integrasi Anda tetap dalam batas biaya dan laju penggunaan yang wajar.
- Minta hanya apa yang Anda butuhkan. Gunakan filter bidang dan lingkup sempit alih-alih menarik payload penuh untuk setiap pesanan atau produk.
- Tambahkan caching pintar. Simpan data stabil untuk berjam-jam dan data yang berubah cepat untuk beberapa menit agar mengurangi pemanggilan berulang pada dasbor dan laporan.
- Lakukan batch saat memungkinkan. Gunakan endpoint batch yang menerima beberapa ID dalam satu permintaan daripada memanggil satu per satu.
- Kelola pembatasan laju dengan baik. Pada HTTP 429, tunda permintaan dengan jeda yang meningkat alih-alih mencoba lagi segera.
- Lacak pemakaian Anda. Pantau volume panggilan, latensi, dan tingkat kesalahan, serta pasang notifikasi sebelum mencapai batas keras atau tier kelebihan.
- Gunakan peristiwa daripada polling. Di mana tersedia, ganti pola “cek setiap menit” dengan webhook/notifikasi untuk mengurangi lalu lintas API yang tidak perlu.
Pertanyaan Umum tentang API Amazon
Berikut beberapa pertanyaan yang paling sering diajukan mengenai API Amazon:
Bisakah saya menggunakan beberapa API Amazon bersama-sama?
API mana yang paling mudah diimplementasikan?
Apakah API Amazon berbayar?
Apa yang terjadi jika saya melebihi batas laju?
Bisakah saya meningkatkan penggunaan API saya?
Apakah saya memerlukan akun penjual profesional untuk SP-API?
Bisakah saya menggunakan Product Advertising API untuk data scraping atau alat internal saja?
Amazon Developer Center links out to all Selling Partner, Advertising, and Associates docs in one place, while the Seller Central Help Center covers account, policy, and operational questions your API integration depends on.
Langkah Selanjutnya
Baik Anda mengotomatiskan operasional penjualan Amazon, membangun aliran pendapatan afiliasi, mengelola kampanye iklan secara skala besar, atau membuat alat SaaS untuk ekosistem Amazon, API yang tepat membuka peningkatan efisiensi yang signifikan dan peluang pendapatan yang besar.
Setelah Anda memilih API, luangkan waktu untuk memahami otentikasi, batas laju, dan strategi optimisasi. Dasar-dasar ini membedakan integrasi yang gagal di bawah beban dari sistem yang dapat diskalakan secara andal hingga ribuan permintaan setiap hari. Amazon secara rutin memperbarui API dan layanan mereka. Periksa dokumentasi resmi di https://developer.amazon.com/ untuk perubahan dan pembaruan terbaru.
