Scraping API

Satu API untuk scraping

Halaman produk, hasil pencarian dan katalog toko Shopee dalam format JSON, sesuai permintaan.

Endpoint7
Wilayah8id · sg · th · ph · my · vn · tw · br
Halaman produk8 credits≈ $10 per 1.000

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

Butuh penjualan bulanan dan pangsa pasar? Data pasar Shopee →

Ambil satu halaman produkRequest
POST/v1/shopee/get_pc/submit
GET/v1/shopee/get_pc/retrieve/37039736
{
  "region": "id",
  "shop_id": "34907167",
  "item_id": "40869177342"
}
Respons asli, dipangkasrespons lengkap ↓
{
  "task_id": 37039736,
  "status": "completed",
  "result": {
    "page_url": "https://shopee.co.id/product/34907167/40869177342",
    "collected_at": 1790312459,
    "detail": {
      "item": {
        "item_id": 40869177342,
        "shop_id": 34907167,
        "title": "Apple iPhone 15 - Garansi Resmi",
        "brand": "Apple",
        "currency": "IDR",
        "tier_variations": [
          {
            "name": "Warna",
  …
Mulai cepat

Request Shopee 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 produknya lewat POST ke /v1/shopee/get_pc/submit. Anda akan menerima task ID.

  3. 3

    Ambil hasilnya. Polling /v1/shopee/get_pc/retrieve/{task_id} sampai statusnya selesai, lalu baca hasilnya.

Ambil satu halaman produk

# shop_id and item_id are in the product URL: ...-i.{shop_id}.{item_id}
curl -X POST https://api.magpieiq.com/scraping/v1/shopee/get_pc/submit \
  -H "Authorization: Bearer $MAGPIE_API_KEY" -H "Content-Type: application/json" \
  -d '{"region": "id", "shop_id": "34907167", "item_id": "40869177342"}'
# -> {"task_id": 37039736, "status": "pending", ...}

curl https://api.magpieiq.com/scraping/v1/shopee/get_pc/retrieve/37039736 \
  -H "Authorization: Bearer $MAGPIE_API_KEY"

Respons asli, dipangkas

{
  "task_id": 37039736,
  "status": "completed",
  "result": {
    "page_url": "https://shopee.co.id/product/34907167/40869177342",
    "collected_at": 1790312459,
    "detail": {
      "item": {
        "item_id": 40869177342,
        "shop_id": 34907167,
        "title": "Apple iPhone 15 - Garansi Resmi",
        "brand": "Apple",
        "currency": "IDR",
        "tier_variations": [
          {
            "name": "Warna",
            "options": ["Yellow", "Green", "Black", "Pink", "Blue"]
          },
          {
            "name": "Penyimpanan",
            "options": ["128GB", "256GB"]
          }
        ],
        "models": [
          {
            "model_id": 375252464276,
            "name": "Green,256GB",
            "price": 1407900000000
          },
          {
            "model_id": 238282002834,
            "name": "Blue,128GB",
            "price": 1360100000000
          }
        ]
      },
      "product_price": {
        "price": {
          "range_min": 1151700000000,
          "range_max": 1432500000000
        }
      },
      "product_review": {
        "rating_star": 4.92,
        "total_rating_count": 25,
        "sold_count_display": "43",
        "liked_count": 190
      },
      "product_attributes": {
        "categories": ["Handphone & Aksesoris", "Handphone", "Apple"]
      },
      "shop_detailed": {
        "shopid": 34907167,
        "name": "Doran Wearable Manado",
        "is_official_shop": true,
        "is_shopee_verified": false,
        "rating_star": 4.853132,
        "follower_count": 7089,
        "item_count": 1289,
        "response_rate": 100
      }
    }
  }
}
Referensi

Endpoint Shopee

Halaman produk

/v1/shopee/get_pc

Satu listing produk apa adanya: harga, seluruh varian, rating, jumlah terjual dan detail penjual.

Inputregionshop_iditem_id
Tanpa approval · kapan saja8 credits / request· ≈ $10 per 1.000

Halaman produk (bulk)

/v1/shopee/get_pc_bulk

Data yang sama untuk banyak produk, diunduh sebagai CSV atau JSONL. Bisa dijadwalkan dengan webhook saat hasilnya siap.

InputCSV berisi regionshop_iditem_id
Tanpa approval · kapan saja8 credits / product· ≈ $10 per 1.000

Pencarian dan daftar kategori

/v1/shopee/pdp-bundling

Semua produk pada satu halaman hasil pencarian atau kategori. Urutan dan filter diambil dari URL: sortBy=sales, sortBy=ctime.

InputMaksimal 50 URLmax_pages
Perlu approval · 08.00–18.00 GMT+812 credits / product· ≈ $15 per 1.000

Katalog toko

/v1/shopee/search-items

Produk di dalam satu toko, halaman demi halaman, dengan pilihan urutan yang sama lewat URL.

InputMaksimal 50 URL tokomax_pages
Perlu approval · 08.00–18.00 GMT+86 credits / page· ≈ $7.5 per 1.000

Terjual per varian

/v1/shopee/app/search-items

Jumlah kumulatif terjual yang persis untuk tiap varian. Tidak ada field bulanan: bandingkan dua snapshot untuk mendapat angka satu periode.

InputMaksimal 50.000 itemsatu negara per request
Perlu approval · 08.00–18.00 GMT+810 credits / page· ≈ $13 per 1.000

Shop catalog

/v1/shopee/merchant-items

The products in one shop, page by page, with the same URL sort options.

InputUp to 50 shop URLsmax_pages
Approval required · 8am–6pm GMT+86 credits / page· ≈ $7.5 per 1.000

Variant sold

/v1/shopee/variant_sold_v1

The exact cumulative sold count per variant. No monthly field: compare two snapshots to get a period.

InputUp to 50,000 itemsone country per request
Approval required · 8am–6pm GMT+810 credits / item· ≈ $13 per 1.000
Respons

Field penting dalam respons

FieldTipeArti
result.page_urlstringURL Shopee untuk produk tersebut.
result.collected_atunix secondsWaktu hasil ini dikumpulkan.
result.detail.item.item_id / shop_idintegerIdentifier produk dan toko dari Shopee.
result.detail.item.titlestringJudul listing seperti yang tampil di Shopee.
result.detail.item.brandstringBrand sesuai yang diisi pada listing.
result.detail.item.currencystringMata uang untuk semua field harga (IDR untuk Indonesia).
result.detail.item.tier_variationsarrayDimensi varian beserta pilihannya (misalnya warna, ukuran penyimpanan).
result.detail.item.models[]arraySatu entri per kombinasi varian, lengkap dengan model_id dan harganya sendiri.
result.detail.product_price.price.range_min / range_maxintegerHarga varian terendah dan tertinggi. Bagi dengan 100.000 untuk mendapat nominal mata uangnya.
result.detail.product_review.rating_starnumberRating rata-rata, 0–5.
result.detail.product_review.total_rating_countintegerJumlah rating.
result.detail.product_review.sold_count_displaystringJumlah terjual seperti ditampilkan Shopee. Pakai Terjual per varian untuk angka persis tiap varian.
result.detail.product_attributes.categoriesarrayJalur kategori Shopee.
result.detail.shop_detailed.namestringNama toko.
result.detail.shop_detailed.is_official_shopbooleanApakah toko tersebut official store.
result.detail.shop_detailed.rating_star / follower_countnumberRating dan jumlah pengikut toko.
Harga

Hitungan biayanya

Biaya

1.000 halaman produk, sekali jalan

8.000kredit

≈ $10

Biaya

500 produk tiap hari selama 30 hari

120.000kredit

≈ $150

Biaya

Produk terlaris dari 20 halaman kategori

120kredit

≈ $0.15

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.

Job Pencarian dan Katalog toko memesan kredit untuk jumlah halaman yang Anda minta, dan hanya ditagih untuk halaman yang benar-benar dikembalikan.

Agen AI

Pakai dari Claude atau ChatGPT

Berikan daftar produk Anda beserta URL Shopee-nya ke asisten Anda, dan ia akan memeriksa apakah ada yang menjual di bawah harga Anda.

Tempel ke asisten Anda
I will give you a list of products, each with our offer price and the Shopee URL of the matching listing. For each row, extract shop_id and item_id from the URL, which ends in -i.{shop_id}.{item_id}. POST to /v1/shopee/get_pc/submit with {"region": "id", "item_id": "...", "shop_id": "..."} to get a task_id, then poll GET /v1/shopee/get_pc/retrieve/{task_id} until it returns a result. Read the current price and divide it by 100000.

Give me a table of every product where the Shopee price is at or below ours, showing our price, the Shopee price and the gap. Also report is_lowest_price_at_shopee for each row — read it from each entry in item.models, because the item-level field comes back null.

Only use get_pc: it runs without manual approval.

Prompt yang disalin juga memberi tahu asisten Anda cara mendapatkan API key kalau Anda belum punya, dan untuk bertanya dulu sebelum memakai kredit.

Batasan

Batasan dan pemrosesan

  • Halaman produk dan Halaman produk (bulk) berjalan kapan saja tanpa approval.
  • Job Pencarian, Katalog toko dan Terjual per varian ditinjau dulu sebelum jalan, dan diproses 08.00–18.00 GMT+8.
  • Pencarian dan Katalog toko menerima maksimal 50 URL per request dan ditagih per halaman yang benar-benar dikembalikan.
  • Terjual per varian menerima maksimal 50.000 item per request, satu negara per request.
  • Wilayah untuk Halaman produk: id, sg, th, ph, my, vn, tw, br.
FAQ

Pertanyaan tentang API Shopee

Apakah saya perlu akun penjual Shopee?

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

Berapa cepat satu halaman produk selesai?

Request Halaman produk berjalan kapan saja tanpa approval; Anda kirim, lalu polling sampai hasilnya siap. Job daftar produk dan varian ditinjau dulu dan diproses 08.00–18.00 GMT+8.

Kenapa harga harus dibagi 100.000?

Shopee mengembalikan harga sebagai bilangan bulat dalam format mentahnya sendiri. Membaginya dengan 100.000 menghasilkan nominal dalam mata uang listing tersebut.

Bisakah saya mendapat angka penjualan persis per varian?

Bisa, lewat Terjual per varian. Endpoint ini mengembalikan jumlah kumulatif terjual yang persis untuk tiap varian. Jadwalkan, lalu kurangkan dua snapshot untuk mendapat penjualan satu periode.

Bagaimana penagihannya?

Dalam kredit prabayar dari satu dompet yang dipakai bersama Data API. Halaman produk ditagih per produk, halaman daftar per halaman yang benar-benar dikembalikan. Kartu tarif memuat semua harga yang berlaku.

Bisakah saya mendapat total penjualan bulanan, bukan halaman mentah?

Bisa. Data API menyajikan GMV, unit terjual dan pangsa pasar bulanan untuk Shopee per brand, merchant dan SKU, sudah dibersihkan dan dikategorikan.

Kirim request Shopee pertama Anda hari ini.

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