Halaman produk, hasil pencarian dan katalog toko Tokopedia dalam format JSON, sesuai permintaan.
Kredit uji coba gratis. Katalog dan estimasi langsung bisa dipakai.
Butuh penjualan bulanan dan pangsa pasar? Data pasar Tokopedia →
{
"items": [
{
"list_type": "search",
"keyword": "sabun mandi",
"product_limit": 60
}
]
}{
"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,
…Ambil API key. Masuk dan buat API key di dashboard. Akun baru mendapat kredit uji coba gratis.
Kirim. Kirim kata kunci Anda lewat POST ke /v1/tokopedia/search/bulk/submit, maksimal 50 per request. Anda akan menerima job ID.
Ambil hasilnya. Polling /v1/tokopedia/search/bulk/retrieve/{job_id}; begitu sebuah item selesai, segera unduh dari download_url-nya, karena tautannya kedaluwarsa.
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 resultsimport os, time, requests
BASE = "https://api.magpieiq.com/scraping"
H = {"Authorization": f"Bearer {os.environ['MAGPIE_API_KEY']}"}
job = requests.post(f"{BASE}/v1/tokopedia/search/bulk/submit", headers=H,
json={"items": [{"list_type": "search", "keyword": "sabun mandi", "product_limit": 60}]}).json()
while True:
r = requests.get(f"{BASE}/v1/tokopedia/search/bulk/retrieve/{job['job_id']}", headers=H).json()
if r["status"] not in ("pending", "processing"):
break
time.sleep(10)
if r["status"] == "failed":
raise SystemExit(f"job {job['job_id']} failed: {r}")
print(r) # completed items carry a download_url; download it promptly, the links expire{
"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"
}
}
]
}/v1/tokopedia/pdp/bulkDetail produk untuk tiap item, termasuk harga dan jumlah terjual sepanjang masa yang persis.
product_keyshop_domain/v1/tokopedia/search/bulkProduk yang dikembalikan satu pencarian kata kunci atau kategori, berurutan, lengkap dengan harga, rating, kategori dan toko.
kata kunci atau ID kategorilist_typeproduct_limit/v1/tokopedia/merchant/bulkProduk yang terdaftar di satu toko Tokopedia.
shopidopsional keyword atau max_pages| Field | Tipe | Arti |
|---|---|---|
keyword / list_type | string | Apa yang dicari dan apakah pencarian itu berbasis kata kunci atau kategori. |
pages_fetched | integer | Jumlah halaman hasil yang dikumpulkan untuk pencarian ini. |
total_unique_ids | integer | Jumlah produk unik yang ditemukan di seluruh halaman tersebut. |
products[] | array | Produk dalam urutan hasil. Peringkat sebuah produk adalah posisinya, dihitung dari 1. |
products[].id / name / url | string | ID produk, judul listing dan URL produk. |
products[].price.number | integer | Harga saat ini dalam rupiah. |
products[].price.text / original | string | Harga seperti ditampilkan, dan harga sebelum diskon kalau ditampilkan. |
products[].rating | string | Rating rata-rata, 0–5. |
products[].category.name / breadcrumb | string | Nama dan jalur kategori. |
products[].shop.name / city | string | Nama toko dan kota yang dicantumkannya. |
products[].stock.ttsSKUID | string | Identifier SKU yang melekat pada listing. |
2.000kredit
≈ $2.5
1.500kredit
≈ $1.88
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.
Berikan kata kunci dan listing Anda ke asisten Anda, dan ia akan melacak posisi Anda di pencarian Tokopedia serta siapa yang menyalip.
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.
Tidak. Yang Anda perlukan adalah API key Magpie. Pendaftaran dilakukan sendiri dan sudah termasuk kredit uji coba gratis.
Keduanya ada di URL produk: tokopedia.com/{shop_domain}/{product_key}. Salin apa adanya.
Bisa. Jalankan endpoint pencarian untuk kata kunci Anda secara terjadwal; peringkat sebuah listing adalah posisinya di dalam array products.
Slot berbayar membawa ads.id yang terisi di hasil pencarian, jadi Anda bisa melewatinya saat menghitung peringkat organik.
Dalam kredit prabayar dari satu dompet yang dipakai bersama Data API, per item atau per task. Kartu tarif memuat semua harga yang berlaku.
Bisa. Data API menyajikan GMV, unit terjual dan pangsa pasar bulanan untuk Tokopedia per brand, merchant dan SKU, sudah dibersihkan dan dikategorikan.
Kredit uji coba gratis. Katalog dan estimasi langsung bisa dipakai.