docs / tokopedia

Tokopedia API scraper

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
}