Scraping API

Satu API untuk scraping

Halaman produk Amazon berdasarkan ASIN dan hasil pencarian per kata kunci atau kategori, dalam format JSON, di sepuluh storefront.

Endpoint2
Wilayah10us · uk · de · fr · it · es · ca · au · jp · sg
Halaman produk5 credits≈ $6.25 per 1.000

Kredit uji coba gratis. Katalog dan estimasi langsung bisa dipakai.

Ambil halaman produk Amazon lewat ASINRequest
POST/v1/amazon/pdp/bulk/submit
GET/v1/amazon/pdp/bulk/retrieve/<job_id>
{
  "items": [
    {
      "asin": "B0BCKHQGJN",
      "country": "uk"
    }
  ]
}
Satu baris dari berkas hasil, dipangkasrespons lengkap ↓
{
  "item_id": "B0BCKHQGJN_uk",
  "asin": "B0BCKHQGJN",
  "country": "uk",
  "response": {
    "asin": "B0BCKHQGJN",
    "country": "uk",
    "url": "https://www.amazon.co.uk/dp/B0BCKHQGJN",
    "title": "Wireless Earbuds, Bluetooth 5.4 Headphones In Ear with 4 ENC Noise Cancelling Mic, Btootos New Bluetooth Earbuds Mini Deep Bass Stereo Sound, 36H Playtime LED Display Wireless Earphones IP7 Waterproof",
    "brand": "Visit the Btootos Store",
    "price": "£19.92",
    "rating": "4.4 out of 5 stars",
    "review_count": "(68,161)",
    "availability": "In stock",
    "category_path": "Electronics > Best Sellers > Deals > Phones & Accessories > TVs & Home Cinema > Camera & Photo > Headphones & Earphones > Audio & HiFi > Speakers > Computers & Accessories",
    "image_url": "https://m.media-amazon.com/images/I/71vfIyTVo5L._AC_SY300_SX300_QL70_ML2_.jpg",
  …
Mulai cepat

Request Amazon pertama Anda

  1. 1

    Ambil API key. Masuk dan buat API key di dashboard. Akun baru mendapat kredit uji coba gratis.

  2. 2

    Kirim. Kirim ASIN dan negaranya lewat POST ke /v1/amazon/pdp/bulk/submit, maksimal 2.000 per request. Anda akan menerima job ID.

  3. 3

    Ambil hasilnya. Polling /v1/amazon/pdp/bulk/retrieve/{job_id}; begitu selesai, unduh berkas hasilnya dari download_url (JSONL ter-gzip, satu baris per ASIN).

Ambil halaman produk Amazon lewat ASIN

curl -X POST https://api.magpieiq.com/scraping/v1/amazon/pdp/bulk/submit \
  -H "Authorization: Bearer $MAGPIE_API_KEY" -H "Content-Type: application/json" \
  -d '{"items": [{"asin": "B0BCKHQGJN", "country": "uk"}]}'
# -> {"job_id": "...", ...}

curl https://api.magpieiq.com/scraping/v1/amazon/pdp/bulk/retrieve/<job_id> \
  -H "Authorization: Bearer $MAGPIE_API_KEY"
# when complete: download_url -> gzipped JSONL, one row per ASIN

Satu baris dari berkas hasil, dipangkas

{
  "item_id": "B0BCKHQGJN_uk",
  "asin": "B0BCKHQGJN",
  "country": "uk",
  "response": {
    "asin": "B0BCKHQGJN",
    "country": "uk",
    "url": "https://www.amazon.co.uk/dp/B0BCKHQGJN",
    "title": "Wireless Earbuds, Bluetooth 5.4 Headphones In Ear with 4 ENC Noise Cancelling Mic, Btootos New Bluetooth Earbuds Mini Deep Bass Stereo Sound, 36H Playtime LED Display Wireless Earphones IP7 Waterproof",
    "brand": "Visit the Btootos Store",
    "price": "£19.92",
    "rating": "4.4 out of 5 stars",
    "review_count": "(68,161)",
    "availability": "In stock",
    "category_path": "Electronics > Best Sellers > Deals > Phones & Accessories > TVs & Home Cinema > Camera & Photo > Headphones & Earphones > Audio & HiFi > Speakers > Computers & Accessories",
    "image_url": "https://m.media-amazon.com/images/I/71vfIyTVo5L._AC_SY300_SX300_QL70_ML2_.jpg",
    "bullets": ["Bluetooth 5.4 Technology : The wireless earbuds use the bluetooth 5.4 chipset. There is a faster and more stable signal transmission and has successfully achieved low latency without interruption. Even if you put the mobile phone in your pocket, the bluetooth earbuds will not be disconnected, the connection distance is up to 33ft."],
    "fetch_status": "ok",
    "scraped_at": "2026-09-16T13:24:11.709959+00:00"
  }
}
Referensi

Endpoint Amazon

Halaman produk

/v1/amazon/pdp/bulk

Judul, brand, harga, rating, jumlah ulasan, ketersediaan, jalur kategori, gambar dan poin-poin listing untuk tiap ASIN.

InputMaksimal 2.000 itemasincountry
Tanpa approval · kapan saja5 credits / item· ≈ $6.25 per 1.000

Pencarian dan daftar kategori

/v1/amazon/search/bulk

Produk yang dikembalikan satu pencarian kata kunci atau daftar kategori, halaman demi halaman.

InputMaksimal 50 taskkata kunci atau ID node kategoricountrypages
Tanpa approval · kapan saja5 credits / item· ≈ $6.25 per 1.000
Respons

Field penting dalam respons

FieldTipeArti
asin / countrystringASIN dan storefront yang diminta.
response.urlstringURL produk tersebut di storefront itu.
response.titlestringJudul listing.
response.brandstringBaris brand seperti tampil di halaman (bisa terbaca “Visit the … Store”).
response.pricestringHarga seperti ditampilkan, lengkap dengan simbol mata uang.
response.ratingstringRating seperti ditampilkan, misalnya “4.4 out of 5 stars”.
response.review_countstringJumlah rating seperti ditampilkan.
response.availabilitystringPesan ketersediaan stok seperti ditampilkan.
response.category_pathstringBreadcrumb kategori.
response.image_urlstringGambar produk utama.
response.bulletsarrayPoin-poin pada listing.
response.fetch_status / scraped_atstringApakah halaman berhasil dikumpulkan, dan kapan.
Harga

Hitungan biayanya

Biaya

1.000 ASIN, sekali jalan

5.000kredit

≈ $6.25

Biaya

500 ASIN tiap hari selama 30 hari

75.000kredit

≈ $94

Biaya

100 pencarian kata kunci

500kredit

≈ $0.63

Angka dolar memakai tarif kredit Tier 1. Top-up pay-as-you-go lebih mahal per kredit dan paket besar lebih murah; kartu tarif memuat semua paket.

Kredit dipotong saat Anda mengirim job; item yang gagal dikembalikan.

Batasan

Batasan dan pemrosesan

  • Kedua endpoint berjalan kapan saja tanpa approval.
  • Storefront: us, uk, de, fr, it, es, ca, au, jp, sg — diatur per item lewat country.
  • Halaman produk menerima maksimal 2.000 item per request; pencarian maksimal 50 task per request.
  • Halaman pencarian: isi pages, atau 0 untuk mengumpulkan semua halaman yang ditemukan.
  • Hasil tiba sebagai berkas JSONL ter-gzip, satu baris per ASIN.
FAQ

Pertanyaan tentang API Amazon

Apakah saya perlu akun penjual Amazon?

Tidak. Yang Anda perlukan adalah API key Magpie. Pendaftaran dilakukan sendiri dan sudah termasuk kredit uji coba gratis.

Storefront Amazon mana saja yang tercakup?

Amerika Serikat, Inggris, Jerman, Prancis, Italia, Spanyol, Kanada, Australia, Jepang dan Singapura. Pilih satu per item lewat field country.

Bisakah saya membandingkan kata kunci yang sama antar negara?

Bisa. Kirim kata kunci yang sama sekali untuk tiap negara dalam satu request pencarian, lalu bandingkan hasilnya.

Kenapa harga dan rating berupa string?

Keduanya dikembalikan apa adanya seperti di halaman, lengkap dengan simbol mata uang dan kalimatnya, supaya tidak ada yang hilang saat konversi. Parsing dilakukan di pipeline Anda.

Bagaimana penagihannya?

Dalam kredit prabayar dari satu dompet, per ASIN atau per task pencarian. Kartu tarif memuat semua harga yang berlaku.

Apakah ada data penjualan bulanan untuk Amazon?

Tidak. Amazon hanya dilayani Scraping API; Data API bulanan mencakup marketplace Asia Tenggara.

Kirim request Amazon pertama Anda hari ini.

Kredit uji coba gratis. Katalog dan estimasi langsung bisa dipakai.