Tokopedia API & Scraper
The Tokopedia API returns product, shop and review data from Indonesia's largest e-commerce marketplace as clean JSON.
5 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns products with id, name, URL, image, price, rating, category, units sold and the seller's shop details — everything you need for price and catalog intelligence. You can also pull a product detail, a shop profile, all of a shop's products and product reviews. It is built for pricing teams, marketplace tools and catalog-enrichment workflows that need live Indonesian marketplace data without running a scraper against Tokopedia's anti-bot defenses. One ReefAPI key, one shared credit pool, the standard envelope.
Reference
The same product field is a different type in search than in detail
Tokopedia renders its search cards and its product page from different sources, and the engine passes both through as they arrive rather than guessing a normalized value. That means several fields you would expect to match do not: sold is a localized Indonesian phrase on a search row and a bare number on a detail record, and rating is a string in one and a number in the other. Read the column for the action you are actually calling. Every response carries meta.locale id-ID and meta.currency IDR.
| Field | What search returns | What detail returns |
|---|---|---|
| price / price_value | "Rp1.735.000" (the dot is a thousands separator) and 1735000 | the same pair, always whole rupiah with no cents |
| rating | string, "5.0", and null when the product has no rating yet | number, 5 |
| sold | Indonesian phrase, "8 terjual"; banded once it is large, "50+ terjual" | plain numeric string, "8" |
| review_count / view_count / talk_count | not present on a search row | strings, not numbers: "3", "0", "0" |
| category | null on every row measured | category_breadcrumb[] of {id, name}, leaf first |
| condition | the filter takes lowercase new or used | returned uppercase, "NEW" |
| shop | {shop_id, name, city, url, is_official, is_power_badge} | {shop_id, name} only |
| stock / weight | not present | stock 6, weight 2.5 with weight_unit "KILOGRAM" |
| labels[] | the badge strip as printed: ["8 terjual", "Bisa COD", "52%"] | not present |
product_id is a numeric string but its length varies a lot: 11946055467 and 103077211933 were both live ids in the same result set. Do not validate it by length, and do not store it as an integer in a language that narrows large ints.
Live example
Real request and response JSON
Captured from the indexed primary action, search, on .
Captured request
{
"method": "POST",
"url": "https://api.reefapi.com/tokopedia/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"q": "laptop"
}
}Captured response
{
"ok": true,
"meta": {
"api": "tokopedia",
"endpoint": "search",
"mode": "live",
"latency_ms": 1641.3,
"record_count": 20,
"bytes": 38535,
"cache_hit": false,
"stop_reason": "limit_reached",
"locale": "id-ID",
"currency": "IDR",
"total": 988821,
"page": 1,
"has_more": true,
"next_page": 2,
"charged_credits": 1,
"version": "1.0.0"
},
"data": {
"products": [
{
"product_id": "11807421908",
"name": "Tas Laptop Sleevecase Carbon",
"url": "https://www.tokopedia.com/alienwarestore/tas-laptop-sleevecase-carbon?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/img/VqbcmM/2023/10/11/885aba3d-3e6a-4ed7-8ed5-e4280eb1dcbb.jpg~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=bkMAQ2slouo7jH6TmHScCEhZe%2Bc%3D&x-signature-webp=iuSS5QmYJbk724XRQ%2BUh4soVzJY%3D",
"price": "Rp99.000",
"price_value": 99000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "8 terjual",
"labels": [
"8 terjual",
"Hemat s.d 3% Pakai Bonus",
"Rp99.000",
"Hemat s.d 3% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "2678348",
"name": "ALIENWARE GAMING STORE",
"city": "Jakarta Utara",
"url": "https://www.tokopedia.com/alienwarestore",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "103515364068",
"name": "Jakemy 6 in 1 Screwdriver Kit Model Philips 3mm - JM-8154 Original Obeng Set Presisi Service HP Laptop Komputer Elektronik",
"url": "https://www.tokopedia.com/metaverse-world-tools/jakemy-6-in-1-screwdriver-kit-model-philips-3mm-jm-8154-original-obeng-set-presisi-service-hp-laptop-komputer-elektronik-1736196790889646032?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/5ee6d1bd730241bbb50e2ee7f53ebcd6~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=aPvQuZ4fh5hWbevrDwQRO0KM3XA%3D&x-signature-webp=KCLxSkI3rIZJ8wKgmq6nAiYNmFU%3D",
"price": "Rp112.240",
"price_value": 112240,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "3 terjual",
"labels": [
"3 terjual",
"Hemat s.d 8% Pakai Bonus",
"Rp112.240",
"Hemat s.d 8% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "17606713",
"name": "Metaverse World Tools",
"city": "Kab. Tangerang",
"url": "https://www.tokopedia.com/metaverse-world-tools",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "103036951709",
"name": "Redragon RANGER M910/ BLUDHOUND M617 Wired Gaming Mouse High Precision USB Mouse for PC Laptop",
"url": "https://www.tokopedia.com/redragonindonesia/redragon-ranger-m910-bludhound-m617-wired-gaming-mouse-high-precision-usb-mouse-for-pc-laptop-1734397338185204829?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/3aceb4d7996242dd98fcfab4dbaa5717~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=OqWfPjdPXZurl%2FdxHCvHKGxqOmc%3D&x-signature-webp=ZRfKAXNT6BqWZ%2FxXXwGUdVAo5NY%3D",
"price": "Rp212.000",
"price_value": 212000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "11 terjual",
"labels": [
"11 terjual",
"Hemat s.d 3% Pakai Bonus",
"56%",
"Rp212.000",
"Hemat s.d 3% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "7496151954588993629",
"name": "redragonindonesia",
"city": "Bekasi",
"url": "https://www.tokopedia.com/redragonindonesia",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "102334852246",
"name": "VENTION KDMI0 Laptop Stand Lipat Aluminum Alloy Alas Dudukan Meja Laptop Notebook Foldable Up To 17\" 17 Inch Peninggi",
"url": "https://www.tokopedia.com/pampamolshop/vention-kdmi0-laptop-stand-lipat-aluminum-alloy-alas-dudukan-meja-laptop-notebook-foldable-up-to-17-17-inch-peninggi-1732666171027195836?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/e4f0150256484244b2bc90d9dc8ce608~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=tYExHpqS9SfIYyu4MA2SQcLVo3g%3D&x-signature-webp=wEQ9bP8V1X2JFiIyi3PGC7cLMm8%3D",
"price": "Rp191.000",
"price_value": 191000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "7 terjual",
"labels": [
"7 terjual",
"Bisa COD",
"Rp191.000",
"Bisa COD"
],
"shop": {
"shop_id": "582410",
"name": "Pampam Shop",
"city": "Kab. Tangerang",
"url": "https://www.tokopedia.com/pampamolshop",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "100553988848",
"name": "Tas Kerja Kantor Ransel Pria Baru 2022 Tas Sekolah Nilon Tahan Air Ransel Kapasitas Besar Tas Laptop Kasual Tas Punggung Perjalanan Solid",
"url": "https://www.tokopedia.com/tasairbone/tas-kerja-kantor-ransel-pria-baru-2022-tas-sekolah-nilon-tahan-air-ransel-kapasitas-besar-tas-laptop-kasual-tas-punggung-perjalanan-solid-1729583501273959071?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-common-sign-sg.tokopedia-static.net/tos-maliva-i-o3syd03w52-us/5e1c2ce4281a4e3aaceffea495af6365~tplv-o3syd03w52-resize-jpeg:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=tvfhifu8J5YrweDjb6wxhXYZOoQ%3D&x-signature-webp=daLrh%2FTTxZqGiw0z%2B8Z7rHpnRGc%3D",
"price": "Rp155.000",
"price_value": 155000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "13 terjual",
"labels": [
"13 terjual",
"Beli Lokal",
"Hemat s.d 8% Pakai Bonus",
"Rp155.000",
"Hemat s.d 8% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "1580107",
"name": "Polofelix",
"city": "Jakarta Timur",
"url": "https://www.tokopedia.com/tasairbone",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "100420288958",
"name": "Mr. Island Tas Ransel Travel Pria berbagai fungsi tas gunung Tahan Air 17 inci tas laptop",
"url": "https://www.tokopedia.com/mrisland-store/mr-island-tas-ransel-travel-pria-berbagai-fungsi-tas-gunung-tahan-air-17-inci-tas-laptop-1731412328730887309?extParam=ivf%3Dtrue%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/c215779fb6174f88a3367d42b2c9972a~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=0kv4hhOK7Lrj92uCeBdTyW5qR60%3D&x-signature-webp=BVF8XDlLykVfi2vKXrGc%2Bgekx8g%3D",
"price": "Rp249.000",
"price_value": 249000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "7 terjual",
"labels": [
"7 terjual",
"Hemat s.d 8% Pakai Bonus",
"60%",
"Rp249.000",
"Hemat s.d 8% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "7496130491448199309",
"name": "mr.island store",
"city": "Kab. Tangerang",
"url": "https://www.tokopedia.com/mrisland-store",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "10701377487",
"name": "PX UCH14 USB Hub Converter Type C Hub Adapter Laptop Macbook Ipad Tablet Type C 3.1 to HDMI 4K USB 3.0 VGA Type C Power Delivery 100W 4 Port 4 in 1",
"url": "https://www.tokopedia.com/vidsenonline/px-uch14-type-c-3-1-to-hdmi-vga-usb-hub-converter-adaptor-4-in-1-4k?extParam=ivf%3Dtrue%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/67e37c0e803544549fca3ef42de3753a~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=qvhao28KrR2hxBNiooICm2gpa68%3D&x-signature-webp=2nxqrwgEC%2Bdygi8iMxKGsZPRx8g%3D",
"price": "Rp299.000",
"price_value": 299000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "6 terjual",
"labels": [
"6 terjual",
"Hemat s.d 3% Pakai Bonus",
"Rp299.000",
"Hemat s.d 3% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "3869958",
"name": "Vidsen Online",
"city": "Jakarta Pusat",
"url": "https://www.tokopedia.com/vidsenonline",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "100121777850",
"name": "Maryland Sling Bag Tas Selempang Laptop 14 Inch Cordoray Corduroy Carrington",
"url": "https://www.tokopedia.com/bogsa/maryland-sling-bag-tas-selempang-laptop-14-inch-cordoray-corduroy-carrington-1729657916132853759?extParam=ivf%3Dtrue%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/e2a94a7355c4474596d0a80a1c1addd8~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=pttFv1tmzLJdLhmssq2wT7TI%2F7A%3D&x-signature-webp=wmCo6BzkqsBAcX8aqQAd4mx9seo%3D",
"price": "Rp160.300",
"price_value": 160300,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "4 terjual",
"labels": [
"4 terjual",
"Hemat s.d 8% Pakai Bonus",
"15%",
"Rp160.300",
"Hemat s.d 8% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "7495288358763006975",
"name": "Bogsa",
"city": "Kab. Bantul",
"url": "https://www.tokopedia.com/bogsa",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "12931356849",
"name": "Bruno Cavalli Backpack Laptop Sefton 17111",
"url": "https://www.tokopedia.com/brunocavalli/bruno-cavalli-backpack-laptop-sefton-17111-black-48663?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/img/VqbcmM/2024/3/14/70b2ef2e-edf4-49f1-87b3-16ad168654c4.jpg~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=fUivSFs3AIyLsjwgO8mkZjIowuQ%3D&x-signature-webp=isezNvwz%2FbzS8MTmDY34JpIs%2B9c%3D",
"price": "Rp538.920",
"price_value": 538920,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "10 terjual",
"labels": [
"10 terjual",
"Hemat s.d 8% Pakai Bonus",
"23%",
"Rp538.920",
"Hemat s.d 8% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "4212957",
"name": "Bruno Cavalli",
"city": "Kab. Tangerang",
"url": "https://www.tokopedia.com/brunocavalli",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "12946284739",
"name": "Bange BG2953 Tas Ransel Backpack laptop Kerja Pria 15.6 Inch",
"url": "https://www.tokopedia.com/bangeid/bange-bg2953-tas-ransel-backpack-laptop-kerja-pria-15-6-inch-hitam-04974?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/73534660f8e74e56852186fc9b23f0c9~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=ImEY6Ycqr87O7XDziubE6WS94xY%3D&x-signature-webp=%2B7Ze1jYzxQxWlsPVzZLaKdtGhOU%3D",
"price": "Rp720.000",
"price_value": 720000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "17 terjual",
"labels": [
"17 terjual",
"Hemat s.d 8% Pakai Bonus",
"Rp720.000",
"Hemat s.d 8% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "16706330",
"name": "Bange.id",
"city": "Kab. Tangerang",
"url": "https://www.tokopedia.com/bangeid",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "14907765794",
"name": "VGeN RAM Laptop DDR4 4GB PC3200 SODIMM Platinum V-GeN",
"url": "https://www.tokopedia.com/jaya-komputa/vgen-ram-laptop-ddr4-4gb-pc3200-sodimm-platinum-v-gen?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/img/VqbcmM/2024/8/23/78e3fa5b-bde2-42a3-9c4b-b14e85161fa6.jpg~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=WHbxlNfsqJQ8L2NRo7s63kTy%2BIM%3D&x-signature-webp=CHTe9jWBnL%2FKKsvcJnfT%2FWCt7Hw%3D",
"price": "Rp548.000",
"price_value": 548000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "11 terjual",
"labels": [
"11 terjual",
"Bisa COD",
"Rp548.000",
"Bisa COD"
],
"shop": {
"shop_id": "11464166",
"name": "Jaya Komputa",
"city": "Jakarta Pusat",
"url": "https://www.tokopedia.com/jaya-komputa",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "15652226155",
"name": "Classa Tas Ransel Sekolah Tas Casual Backpack Laptop A3623",
"url": "https://www.tokopedia.com/koperid/classa-tas-ransel-sekolah-tas-casual-backpack-laptop-a3623-grey-3967b?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/img/VqbcmM/2024/10/30/6372a0a9-366f-47eb-8d6e-2d5e92ef231e.jpg~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=eFclv4N6rgImys2nUD2JK1TH9o0%3D&x-signature-webp=5KKig7fP1U0ArFGbjt0tTto4jk8%3D",
"price": "Rp239.000",
"price_value": 239000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "1 terjual",
"labels": [
"1 terjual",
"Beli Lokal",
"Bisa COD",
"70%",
"Rp239.000",
"Bisa COD"
],
"shop": {
"shop_id": "669021",
"name": "KoperID",
"city": "Jakarta Barat",
"url": "https://www.tokopedia.com/koperid",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "102067280687",
"name": "EIGER WANDERFURTHER BACKPACK 23L 1A LAPTOP",
"url": "https://www.tokopedia.com/eiger-adventure-official-store/eiger-wanderfurther-backpack-23l-1a-laptop-1731529582602585271?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/88b9322931d842b6a982608107d67da6~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=9AtLShCVBXAqkoOtfUaOq5A8diM%3D&x-signature-webp=lzjvw89ZAMz8edyVlbyT%2FgpMw0c%3D",
"price": "Rp634.000",
"price_value": 634000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "40+ terjual",
"labels": [
"40+ terjual",
"Rp634.000",
"Beli Lokal",
"Hemat s.d 8% Pakai Bonus",
"Harga Diskon",
"Rp634.000",
"Hemat s.d 8% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "7494557671839402167",
"name": "Eiger Adventure Official Store_NEW",
"city": "Kab. Subang",
"url": "https://www.tokopedia.com/eiger-adventure-official-store",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "102804058532",
"name": "11 in 1 USB HUB NYK Type C Port 3.1 iOS Windows Macbook Linux Smart Phone TV C11 Laptop",
"url": "https://www.tokopedia.com/borongkomputer/11-in-1-usb-hub-nyk-type-c-port-3-1-ios-windows-macbook-linux-smart-phone-tv-c11-laptop-1733899866789610992?extParam=ivf%3Dtrue%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-common-sign-sg.tokopedia-static.net/tos-maliva-i-o3syd03w52-us/82bbcad0f24441e3b6fd1c96c28f0bff~tplv-o3syd03w52-resize-jpeg:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=tDxhNVo1NB2ntUIFzJSq%2F6xZxY4%3D&x-signature-webp=9x84d8G4hu5jFI3yOb7ZN5IsUbA%3D",
"price": "Rp209.358",
"price_value": 209358,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "2 terjual",
"labels": [
"2 terjual",
"Hemat s.d 3% Pakai Bonus",
"Rp209.358",
"Hemat s.d 3% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "1226035",
"name": "BORONG KOMPUTER",
"city": "Jakarta Barat",
"url": "https://www.tokopedia.com/borongkomputer",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "103407787201",
"name": "Thermalright Peerless Assassin 120 Digital ARGB CPU Cooler Dual Tower Layar Digital / Pendingin CPU HSF Laptop Stainless",
"url": "https://www.tokopedia.com/thermalright-id-store/thermalright-peerless-assassin-120-digital-argb-cpu-cooler-dual-tower-layar-digital-pendingin-cpu-hsf-1735723612582675921-1735723715298100689?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/bd61736d841848ff8d334e9f34472689~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=fjFd4KA0%2BqAFTAHNHRQiude3TZE%3D&x-signature-webp=S2zPdYcCuIdOureGYotez746dDg%3D",
"price": "Rp776.000",
"price_value": 776000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "7 terjual",
"labels": [
"7 terjual",
"Rp776.000",
"Hemat s.d 3% Pakai Bonus",
"58%",
"Harga Diskon",
"Rp776.000",
"Hemat s.d 3% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "7494326471956202961",
"name": "Thermalright ID Store",
"city": "Kab. Padang Lawas Utara",
"url": "https://www.tokopedia.com/thermalright-id-store",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "103397448733",
"name": "Panchayat Backpack Premium Kantor Travel - Tas Ransel Muat Laptop 15.6 inch Anti Air Wanita Pria",
"url": "https://www.tokopedia.com/panchayat-store/panchayat-tas-ransel-asli-korea-kasual-untuk-ransel-sekolah-kapasitas-besar-wanita-tahan-air-1735675065296979140-1735675429106386116?extParam=ivf%3Dtrue%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/5ffe2babe49d43ad9d55ff0fd6d4c7f4~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=WoStl17TAmlg2SVj2c%2Bxf0bZsaU%3D&x-signature-webp=vcjK3XqE32NzZ551xzfxUQ0%2BurU%3D",
"price": "Rp229.000",
"price_value": 229000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "12 terjual",
"labels": [
"12 terjual",
"Hemat s.d 8% Pakai Bonus",
"56%",
"Rp229.000",
"Hemat s.d 8% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "7496314152002291908",
"name": "Panchayat Store",
"city": "Kab. Tangerang",
"url": "https://www.tokopedia.com/panchayat-store",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "103077211933",
"name": "Speaker Desktop K2060 RGB Audio Gaming Office | Suara Surround untuk Komputer Laptop PC",
"url": "https://www.tokopedia.com/unitechofficial/speaker-desktop-k2060-rgb-audio-gaming-office-suara-surround-untuk-komputer-laptop-pc-1734490097367876803?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/dd484077bf584ee2817c58281788c649~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=Xsfl8lBFJWXRp6N9W6090sAZKl8%3D&x-signature-webp=yLFepyIOcZEzVReMf%2BAEeisk95M%3D",
"price": "Rp109.000",
"price_value": 109000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "16 terjual",
"labels": [
"16 terjual",
"Hemat s.d 3% Pakai Bonus",
"52%",
"Rp109.000",
"Hemat s.d 3% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "191075",
"name": "Unitech Shop_NEW",
"city": "Jakarta Utara",
"url": "https://www.tokopedia.com/unitechofficial",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "102168483039",
"name": "TRIPLEDI Laptop Holder Multifunction 17.3 inch TD1203 Foldable Magnetic Phone Stand Aluminium Adjustable For Macbook Notebook iPad Tablet Samsung iPhone Xiaomi",
"url": "https://www.tokopedia.com/tripledi/tripledi-laptop-holder-multifunction-17-3-inch-td1203-foldable-magnetic-phone-stand-aluminium-adjustable-for-macbook-notebook-ipad-tablet-samsung-iphone-xiaomi-1732323367892255795?extParam=ivf%3Dtrue%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/16ed0f9a41fd45a19d87a3dfd54d18ba~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=4G08Ch8gx1g6xt4aWzeaw6MqcSg%3D&x-signature-webp=HI3XMM1FpJoA7zSOXKb%2BQgfLOYE%3D",
"price": "Rp420.000",
"price_value": 420000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "30+ terjual",
"labels": [
"30+ terjual",
"Hemat s.d 3% Pakai Bonus",
"Rp420.000",
"Hemat s.d 3% Pakai Bonus",
"Bisa COD"
],
"shop": {
"shop_id": "8390833",
"name": "TRIPLEDI",
"city": "Kab. Tangerang",
"url": "https://www.tokopedia.com/tripledi",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "102082926837",
"name": "UGREEN 25248 Ergonomic Keyboard Arm Rest Memory Foam Wrist Rest Black Bantalan Alas Pergelangan Tangan Sandaran Tatakan Tangan Key Board Meja Kerja Computer Komputer PC Laptop",
"url": "https://www.tokopedia.com/pampamolshop/ugreen-25248-ergonomic-keyboard-arm-rest-memory-foam-wrist-rest-black-bantalan-alas-pergelangan-tangan-sandaran-tatakan-tangan-key-board-meja-kerja-computer-komputer-pc-laptop-1732188198945064892?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/a5ea00b25cae4121a4d6f5a913bb03f0~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=sC6LKqrOOi%2B3KR3xBeB4sUgGn30%3D&x-signature-webp=I2Qt0qtkCM0R%2Fevxmg%2BXFuMVONM%3D",
"price": "Rp119.000",
"price_value": 119000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "5 terjual",
"labels": [
"5 terjual",
"Bisa COD",
"Rp119.000",
"Bisa COD"
],
"shop": {
"shop_id": "582410",
"name": "Pampam Shop",
"city": "Kab. Tangerang",
"url": "https://www.tokopedia.com/pampamolshop",
"is_official": true,
"is_power_badge": false
}
},
{
"product_id": "421095773",
"name": "V-GeN RAM SODimm DDR4 4GB 17000 PLATINUM-Memory RAM LAPTOP VGEN",
"url": "https://www.tokopedia.com/v-genindonesia/v-gen-ram-sodimm-ddr4-4gb-17000-platinum-memory-ram-laptop-vgen?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D20260923215407FE73F687E5BC521B9TOJ%26src%3Dsearch",
"image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/img/VqbcmM/2022/1/13/ab5a6e9f-05bf-409e-9eda-f4f07470821a.jpg~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=1790204047&x-signature=HKVED5W6%2BGeUxIQassV02qn%2BlXw%3D&x-signature-webp=7yp7VA9bLeXQG08T4n7vr2sPGXE%3D",
"price": "Rp503.000",
"price_value": 503000,
"price_range": null,
"rating": "5.0",
"category": null,
"sold": "70+ terjual",
"labels": [
"70+ terjual",
"Bisa COD",
"Rp503.000",
"Bisa COD"
],
"shop": {
"shop_id": "5490530",
"name": "V-GeN Indonesia Official Store",
"city": "Jakarta Pusat",
"url": "https://www.tokopedia.com/v-genindonesia",
"is_official": true,
"is_power_badge": false
}
}
]
}
}Actions
What the Tokopedia API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Tokopedia products by keyword with optional price / condition / rating filters and sort. Returns up to 20 products per page (product_id, name, url, price in IDR, rating, sold count, category, shop) with page-based pagination. | Pricing teams call search to search Tokopedia products by keyword with optional price / condition / rating filters and sort. | q, page, sort, price_min, price_max, ... |
| detail | Full product detail by product url: price, slashed/original price, discount, active campaign, stock, min/max order, weight, rating, review/view/talk counts, sold count, full description, spec rows, category breadcrumb, image gallery, variants and the seller shop. | Marketplace operators call detail to get full product detail by product url. | url |
| shop | Store/shop profile by shop domain (the tokopedia.com/<shop> handle): name, description, open-since, follower count, active product count, total products sold, successful transactions, location, avatar and cover. | Catalog enrichment teams call shop to get store/shop profile by shop domain (the tokopedia.com/<shop> handle). | shop |
| shop_products | Paginated product catalog of one shop by shop domain. Returns up to 20 products per page (same shape as search) plus the shop's total product count. Page through every product a store sells. | Retail analysts call shop_products to get paginated product catalog of one shop by shop domain. | shop, page, sort |
| reviews | Paginated public product reviews by product_id (or url): star rating, review text, variant bought, relative date, reviewer handle, photos/videos, likes and the seller's reply. 20 reviews per page — page with `page`; meta.total / meta.has_more tell you how many. | Pricing teams call reviews to get paginated public product reviews by product_id (or url). | product_id, url, page, sort_reviews, filter_rating |
Code samples
Call search from your stack
curl -X POST https://api.reefapi.com/tokopedia/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"q":"laptop"}'import requests
r = requests.post(
"https://api.reefapi.com/tokopedia/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"q": "laptop"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/tokopedia/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"q": "laptop"
}),
});
const { ok, data, meta, error } = await res.json();MCP one-liner
Ask your MCP-connected assistant: call reefapi.tokopedia.search with {"q":"laptop"}.Use cases
Who uses this API and why
- Pricing teams call search to track competitor prices and units-sold across Tokopedia categories.
- Brand-protection tools use shop_products to audit every listing from a specific seller.
- Catalog-enrichment workflows pull detail and reviews to fill product pages with live marketplace data.
FAQ
Questions developers ask before integrating
Why does detail not take the product_id that search just gave me?
Because a bare numeric id is not addressable on Tokopedia, and detail no longer pretends otherwise: product_id has been removed from that action's schema, so a call without a url now answers MISSING_PARAM naming url, immediately and without going upstream. Take the url straight from the search row; you can drop everything from the ? onward, since the query string is only Tokopedia's click tracking. reviews is the exception and still accepts product_id, because there it works.
What exactly does sold mean, and is it a number?
It is Tokopedia's units-sold badge, and on a search row it is text, not a number. Measured values include "8 terjual", "29 terjual" and "50+ terjual" - terjual is Indonesian for sold, and the plus sign means Tokopedia has stopped reporting the exact figure and banded it. The detail action gives you the same product as a plain numeric string ("8"), so if you need arithmetic, read it there, or parse the leading digits and treat a trailing plus as a floor rather than an exact count.
Are prices integer rupiah, and can they have decimals?
price_value is a whole-rupiah integer - 109000 for Rp109.000, 1423056 for Rp1.423.056 - because the rupiah has no practical subunit in retail pricing. The companion price field is the display string Tokopedia prints, where the dot is a thousands separator, not a decimal point. Parsing "Rp1.735.000" as a float in a locale that reads dots as decimals gives you 1.735 rupiah. Use price_value for anything numeric.
Why did reviews come back empty when detail said review_count 3?
Tokopedia's review widget and the counter on the product page are fed separately, and the widget can return nothing for a product whose counter is non-zero. A measured call against a product whose detail reported review_count "3" returned ok:true, meta.total 0 and an empty reviews list, with stop_reason "complete" - so it is a real empty result, not a truncated page. Treat review_count as a page-level hint and meta.total on the reviews action as the number you can actually fetch.
What happens when search hands me a url whose product has been delisted?
You get NOT_FOUND with retryable false and a message saying the product was removed or never existed. Tokopedia's search index keeps serving delisted listings for a while, so a url that came out of a fresh search can already be dead - three of the first four best-selling results for one keyword behaved that way. That answer used to arrive as a retryable upstream error, which meant a sync could keep re-buying a permanently negative result; it is now a closed verdict. Delete the row rather than queueing it.
How many products can I page through for one keyword?
20 per page, with page running from 1 to 100, so 2,000 rows is the ceiling per query no matter how large meta.total is - "laptop gaming" reported total 38,583. meta.has_more and meta.next_page tell you when to stop. To go deeper, narrow with price_min / price_max, condition or rating and run several queries, or use shop_products, which walks a single seller's catalog exhaustively.
What do the numbers on a shop profile actually count?
They are lifetime store totals, not current inventory. A measured profile returned active_product_count 95 (what is listed right now) against product_sold 597,775 and transaction_success 287,109 (both since the shop opened), plus total_favorite 36,072, which is the follower count rather than a like count. open_since is an English month-and-year string ("July 2014"), location / city / district split the address, and status is a numeric code (1 on an open shop) alongside the is_open boolean.
What date format do reviews use?
Two fields, and only one is machine-readable. date is the Indonesian relative phrase Tokopedia prints - "2 minggu lalu" (2 weeks ago), "3 bulan lalu" (3 months ago) - while date_raw is a Unix epoch in seconds delivered as a string ("1785992410"). Sort and store on date_raw. Also expect author, author_id and author_url to be null whenever is_anonymous is true, which was the case for every review measured; shop_reply carries the seller's canned response when there is one.
What is the Tokopedia API?
Tokopedia API is a ReefAPI endpoint group for tokopedia It returns live JSON through POST requests under /tokopedia/v1.
Is the Tokopedia API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Tokopedia calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Tokopedia login or account?
No login to Tokopedia is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Tokopedia data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Tokopedia API use?
Tokopedia actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Tokopedia from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call tokopedia actions with the same key, credit pool and JSON envelope used by normal REST requests.