E-commerce & Marketplaces

Tokopedia API

The Tokopedia API returns product, shop and review data from Indonesia's largest e-commerce marketplace as clean JSON.

5 actionsLive JSON1,000 free 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.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

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": 1979.9,
    "record_count": 20,
    "bytes": 38242,
    "cache_hit": false,
    "stop_reason": "limit_reached",
    "locale": "id-ID",
    "currency": "IDR",
    "total": 1155970,
    "page": 1,
    "has_more": true,
    "next_page": 2
  },
  "data": {
    "products": [
      {
        "product_id": "[redacted-phone]",
        "name": "[redacted-name]",
        "url": "https://www.tokopedia.com/vidsenonline/px-uca50s-usb-type-c-to-usb-3-0-hub-adaptor-macbook-laptop-5-in-1?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D[redacted-phone]EBFFD530F162NDZ%26src%3Dsearch",
        "image_url": "https://p19-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/img/VqbcmM/2024/8/22/68b06e9f-109e-4feb-b4c3-4567cbd5ca82.jpg~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=[redacted-phone]&x-signature=L6AqlRyM5%2FOfGyNxStAI92SlE34%3D&x-signature-webp=ipzO66TVDQYxabZDIsTMl%2FVdtto%3D",
        "price": "Rp139.000",
        "price_value": 139000,
        "price_range": null,
        "rating": "5.0",
        "category": null,
        "sold": "1 terjual",
        "labels": [
          "1 terjual",
          "Hemat s.d  8% Pakai Bonus",
          "Rp139.000"
        ],
        "shop": {
          "shop_id": "3869958",
          "name": "[redacted-name]",
          "city": "Jakarta Pusat",
          "url": "https://www.tokopedia.com/vidsenonline",
          "is_official": true,
          "is_power_badge": false
        }
      },
      {
        "product_id": "[redacted-phone]",
        "name": "[redacted-name]",
        "url": "https://www.tokopedia.com/alienwarestore/tas-laptop-sleevecase-carbon?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D[redacted-phone]EBFFD530F162NDZ%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=[redacted-phone]&x-signature=1HuKlufdRNlMO7w3jcZj00R8kig%3D&x-signature-webp=wpFngsxbJ%2FqRiwdZgMD25LWJj1I%3D",
        "price": "Rp100.000",
        "price_value": 100000,
        "price_range": null,
        "rating": "5.0",
        "category": null,
        "sold": "8 terjual",
        "labels": [
          "8 terjual",
          "Hemat s.d  8% Pakai Bonus",
          "Rp100.000"
        ],
        "shop": {
          "shop_id": "2678348",
          "name": "[redacted-name]",
          "city": "Jakarta Utara",
          "url": "https://www.tokopedia.com/alienwarestore",
          "is_official": true,
          "is_power_badge": false
        }
      },
      {
        "product_id": "[redacted-phone]",
        "name": "[redacted-name]",
        "url": "https://www.tokopedia.com/bag-solution-shop/tas-ransel-laptop-polo-hunter-bef-tas-pria-backpack-free-bag-cover-hitam-556bc?extParam=ivf%3Dfalse%26keyword%3Dlaptop%26search_id%3D[redacted-phone]EBFFD530F162NDZ%26src%3Dsearch",
        "image_url": "https://p16-images-sign-sg.tokopedia-static.net/tos-alisg-i-aphluv4xwc-sg/0aa0723faba24ce09ffe16eafa534958~tplv-aphluv4xwc-white-pad-v1:200:200.jpeg?lk3s=97278606&x-expires=[redacted-phone]&x-signature=Qwt4WwU2rswS5RkKKS1ken8cCsI%3D&x-signature-webp=oBgKXbsLNEzPQL%2FugwJ0Ys4A1n8%3D",
        "price": "Rp179.000",
        "price_value": 179000,
        "price_range": null,
        "rating": "5.0",
        "category": null,
        "sold": "17 terjual",
        "labels": [
          "17 terjual",
          "Bisa COD",
          "72%"
        ],
        "shop": {
          "shop_id": "7286555",
          "name": "[redacted-name]",
          "city": "Jakarta Utara",
          "url": "https://www.tokopedia.com/bag-solution-shop",
          "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_id (or 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_id (or product url).	product_id, 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

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, and 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.

Is the Tokopedia API a Tokopedia scraper?

It is the managed alternative to a DIY Tokopedia scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same tokopedia back as clean JSON.

Why does my Tokopedia scraper keep getting blocked?

Most Tokopedia scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / tokopedia

Tokopedia

base /tokopedia/v15 endpoints

post/tokopedia/v1/search1 credit

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.

Parameter		Allowed / range	Description
q	required	—	Search keyword — a product, brand or category in Indonesian or English ('laptop gaming', 'iphone 15', 'sepatu nike', 'kopi').
page = 1	optional	1–100	1-based page number (20 results per page). Page forward with meta.next_page.
sort = 23	optional	23 · 5 · 3 · 4 · 8 · 9	Result ordering (Tokopedia 'ob' code).
price_min	optional	0–	Minimum price filter in IDR (rupiah, e.g. 100000 = Rp100.000).
price_max	optional	0–	Maximum price filter in IDR (rupiah).
condition	optional	new · used	Filter by item condition (new = baru, used = bekas).
rating	optional	4 · 5	Minimum product star rating filter.

Try in playground →

post/tokopedia/v1/detail1 credit

Full product detail by product_id (or 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.

Parameter		Allowed / range	Description
product_id	optional	—	Tokopedia numeric product id (from a search result's product_id). Alternatively pass a full product `url`.
url	optional	—	Full Tokopedia product URL (tokopedia.com/<shop>/<product-slug>). Use this when you have the link rather than the numeric id.

Try in playground →

post/tokopedia/v1/shop1 credit

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.

Parameter		Allowed / range	Description
shop	required	—	Shop/store domain — the handle in tokopedia.com/<shop> (or a full shop URL).

Try in playground →

post/tokopedia/v1/shop_products1 credit

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.

Parameter		Allowed / range	Description
shop	required	—	Shop/store domain — the handle in tokopedia.com/<shop> (or a full shop URL).
page = 1	optional	1–100	1-based page number (20 results per page). Page forward with meta.next_page.
sort = 23	optional	23 · 5 · 3 · 4 · 8 · 9	Result ordering (Tokopedia 'ob' code).

Try in playground →

post/tokopedia/v1/reviews1 credit

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.

Parameter		Allowed / range	Description
product_id	optional	—	Tokopedia numeric product id (from a search result's product_id). Alternatively pass a full product `url`.
url	optional	—	Full Tokopedia product URL (tokopedia.com/<shop>/<product-slug>). Use this when you have the link rather than the numeric id.
page = 1	optional	1–100	1-based page number (20 results per page). Page forward with meta.next_page.
sort_reviews	optional	informative_score desc · create_time desc · create_time asc	Order reviews (helpfulness or date).
filter_rating	optional	5 · 4 · 3 · 2 · 1	Show only reviews with this star rating.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/tokopedia/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"q":"laptop"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}