Scraping API

Satu API untuk scraping

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

Endpoint3
Wilayah1id
Halaman produk2 credits≈ $2.5 per 1.000

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

Butuh penjualan bulanan dan pangsa pasar? Data pasar Tokopedia →

Cari produk Tokopedia lewat kata kunciRequest
POST/v1/tokopedia/search/bulk/submit
GET/v1/tokopedia/search/bulk/retrieve/<job_id>
{
  "items": [
    {
      "list_type": "search",
      "keyword": "sabun mandi",
      "product_limit": 60
    }
  ]
}
Hasil satu kata kunci, dipangkas jadi 2 produkrespons lengkap ↓
{
  "keyword": "sabun mandi",
  "list_type": "search",
  "pages_fetched": 40,
  "total_unique_ids": 1849,
  "products": [
    {
      "id": "102407389499",
      "name": "Grace and Glow Brightening Body Wash 400ml | Shower Gel Grace and Glow | English Pear, Rouge540 | Sabun Mandi Cair Wangi Parfum yang Mencerahkan, Membersihkan, Melembutkan Tubuh, Kulit Lebih Segar & Tangan Terawat",
      "url": "https://www.tokopedia.com/graceandglowofficial/grace-and-glow-brightening-body-wash-shower-gel-grace-and-glow-english-pear-rouge540-miss-moisture-peony-sabun-mandi-cair-wangi-parfum-yang-mencerahkan-membersihkan-melembutkan-tubuh-kulit-lebih-segar-tangan-terawat-1732841867910939916?extParam=ivf%3Dtrue%26keyword%3Dsabun+mandi%26search_id%3D20260918063826D1F255A373A3CE32D7ZO%26src%3Dsearch",
      "price": {
        "text": "Rp18.500",
        "number": 18500,
        "range": "",
        "original": "Rp64.000",
        "discountPercentage": 0,
  …
Mulai cepat

Request Tokopedia 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 kata kunci Anda lewat POST ke /v1/tokopedia/search/bulk/submit, maksimal 50 per request. Anda akan menerima job ID.

  3. 3

    Ambil hasilnya. Polling /v1/tokopedia/search/bulk/retrieve/{job_id}; begitu sebuah item selesai, segera unduh dari download_url-nya, karena tautannya kedaluwarsa.

Cari produk Tokopedia lewat kata kunci

curl -X POST https://api.magpieiq.com/scraping/v1/tokopedia/search/bulk/submit \
  -H "Authorization: Bearer $MAGPIE_API_KEY" -H "Content-Type: application/json" \
  -d '{"items": [{"list_type": "search", "keyword": "sabun mandi", "product_limit": 60}]}'
# -> {"job_id": "...", ...}

curl https://api.magpieiq.com/scraping/v1/tokopedia/search/bulk/retrieve/<job_id> \
  -H "Authorization: Bearer $MAGPIE_API_KEY"
# each completed item carries a download_url for its results

Hasil satu kata kunci, dipangkas jadi 2 produk

{
  "keyword": "sabun mandi",
  "list_type": "search",
  "pages_fetched": 40,
  "total_unique_ids": 1849,
  "products": [
    {
      "id": "102407389499",
      "name": "Grace and Glow Brightening Body Wash 400ml | Shower Gel Grace and Glow | English Pear, Rouge540 | Sabun Mandi Cair Wangi Parfum yang Mencerahkan, Membersihkan, Melembutkan Tubuh, Kulit Lebih Segar & Tangan Terawat",
      "url": "https://www.tokopedia.com/graceandglowofficial/grace-and-glow-brightening-body-wash-shower-gel-grace-and-glow-english-pear-rouge540-miss-moisture-peony-sabun-mandi-cair-wangi-parfum-yang-mencerahkan-membersihkan-melembutkan-tubuh-kulit-lebih-segar-tangan-terawat-1732841867910939916?extParam=ivf%3Dtrue%26keyword%3Dsabun+mandi%26search_id%3D20260918063826D1F255A373A3CE32D7ZO%26src%3Dsearch",
      "price": {
        "text": "Rp18.500",
        "number": 18500,
        "range": "",
        "original": "Rp64.000",
        "discountPercentage": 0,
        "__typename": "SearchProductV5Price"
      },
      "stock": {
        "ttsSKUID": "1732841867910939916",
        "__typename": "SearchProductV5Stock"
      },
      "rating": "4.9",
      "category": {
        "id": "2133",
        "name": "Perawatan Tubuh",
        "breadcrumb": "perawatan-tubuh/perlengkapan-mandi/sabun-mandi"
      },
      "shop": {
        "name": "Grace and Glow Indonesia_NEW",
        "city": "Kab. Bogor"
      }
    },
    {
      "id": "2217681166",
      "name": "NUVO FAMILY Sabun Mandi Cair Total Protect Pouch 800 g x2",
      "url": "https://www.tokopedia.com/wingsofficial/nuvo-family-sabun-mandi-cair-total-protect-pouch-800ml-x2-1729935252670745314?extParam=ivf%3Dfalse%26keyword%3Dsabun+mandi%26search_id%3D20260918063826D1F255A373A3CE32D7ZO%26src%3Dsearch%26whid%3D7386608",
      "price": {
        "text": "Rp25.400",
        "number": 25400,
        "range": "",
        "original": "Rp100.000",
        "discountPercentage": 0,
        "__typename": "SearchProductV5Price"
      },
      "stock": {
        "ttsSKUID": "1729935252670810850",
        "__typename": "SearchProductV5Stock"
      },
      "rating": "5.0",
      "category": {
        "id": "2133",
        "name": "Perawatan Tubuh",
        "breadcrumb": "perawatan-tubuh/perlengkapan-mandi/sabun-mandi"
      },
      "shop": {
        "name": "Wings Indonesia",
        "city": "Kab. Bekasi"
      }
    }
  ]
}
Referensi

Endpoint Tokopedia

Halaman produk

/v1/tokopedia/pdp/bulk

Detail produk untuk tiap item, termasuk harga dan jumlah terjual sepanjang masa yang persis.

InputMaksimal 2.000 itemproduct_keyshop_domain
Tanpa approval · kapan saja2 credits / request· ≈ $2.5 per 1.000

Pencarian dan daftar kategori

/v1/tokopedia/search/bulk

Produk yang dikembalikan satu pencarian kata kunci atau kategori, berurutan, lengkap dengan harga, rating, kategori dan toko.

InputMaksimal 50 taskkata kunci atau ID kategorilist_typeproduct_limit
Tanpa approval · kapan saja1 credit / request· ≈ $1.25 per 1.000

Katalog toko

/v1/tokopedia/merchant/bulk

Produk yang terdaftar di satu toko Tokopedia.

InputMaksimal 50 taskshopidopsional keyword atau max_pages
Tanpa approval · kapan saja1 credit / request· ≈ $1.25 per 1.000
Respons

Field penting dalam respons

FieldTipeArti
keyword / list_typestringApa yang dicari dan apakah pencarian itu berbasis kata kunci atau kategori.
pages_fetchedintegerJumlah halaman hasil yang dikumpulkan untuk pencarian ini.
total_unique_idsintegerJumlah produk unik yang ditemukan di seluruh halaman tersebut.
products[]arrayProduk dalam urutan hasil. Peringkat sebuah produk adalah posisinya, dihitung dari 1.
products[].id / name / urlstringID produk, judul listing dan URL produk.
products[].price.numberintegerHarga saat ini dalam rupiah.
products[].price.text / originalstringHarga seperti ditampilkan, dan harga sebelum diskon kalau ditampilkan.
products[].ratingstringRating rata-rata, 0–5.
products[].category.name / breadcrumbstringNama dan jalur kategori.
products[].shop.name / citystringNama toko dan kota yang dicantumkannya.
products[].stock.ttsSKUIDstringIdentifier SKU yang melekat pada listing.
Harga

Hitungan biayanya

Biaya

1.000 halaman produk, sekali jalan

2.000kredit

≈ $2.5

Biaya

50 kata kunci dicari tiap hari selama 30 hari

1.500kredit

≈ $1.88

Biaya

20 toko kompetitor, sekali jalan

20kredit

≈ $0.03

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.

Agen AI

Pakai dari Claude atau ChatGPT

Berikan kata kunci dan listing Anda ke asisten Anda, dan ia akan melacak posisi Anda di pencarian Tokopedia serta siapa yang menyalip.

Tempel ke asisten Anda
Submit POST /v1/tokopedia/search/bulk/submit with {"items": [{"list_type": "search", "keyword": "<keyword>", "product_limit": 60}]} for each of my keywords (up to 50 per request). Poll GET /v1/tokopedia/search/bulk/retrieve/{job_id}, and download each item's download_url promptly and save it — the links expire.

A listing's rank is its position in the products array, counting from 1. Skip any product whose ads.id is filled — that slot is sponsored, not organic. Match my listings by id or shop.id and record rank per keyword per run, then show me who climbed past us since the last run.

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

  • Ketiga endpoint berjalan kapan saja tanpa approval.
  • Halaman produk menerima maksimal 2.000 item per request; pencarian dan katalog toko maksimal 50 task per request.
  • Segera unduh tiap hasil dari download_url-nya; tautannya kedaluwarsa.
  • Hasil pencarian kembali dalam urutan tetap yang mendekati, tetapi tidak persis sama dengan, tampilan default pembeli.
  • Tokopedia adalah marketplace Indonesia; harganya dalam rupiah.
FAQ

Pertanyaan tentang API Tokopedia

Apakah saya perlu akun penjual Tokopedia?

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

Di mana saya menemukan product_key dan shop_domain?

Keduanya ada di URL produk: tokopedia.com/{shop_domain}/{product_key}. Salin apa adanya.

Bisakah saya melacak posisi listing saya untuk sebuah kata kunci?

Bisa. Jalankan endpoint pencarian untuk kata kunci Anda secara terjadwal; peringkat sebuah listing adalah posisinya di dalam array products.

Apakah hasil berbayar dipisahkan?

Slot berbayar membawa ads.id yang terisi di hasil pencarian, jadi Anda bisa melewatinya saat menghitung peringkat organik.

Bagaimana penagihannya?

Dalam kredit prabayar dari satu dompet yang dipakai bersama Data API, per item atau per task. 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 Tokopedia per brand, merchant dan SKU, sudah dibersihkan dan dikategorikan.

Kirim request Tokopedia pertama Anda hari ini.

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