API Reference
Search Tokopedia's product catalog, browse categories and homepage recommendations, and get full public product detail as structured JSON. 8 endpoints documented below.
curl "https://api.crawlora.net/api/v1/tokopedia/search?q=sepatu+lari" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's Tokopedia endpoints return normalized public storefront data as JSON with one API key — no Tokopedia account required.
Send a required q keyword to /tokopedia/search, with optional page (1 through 5), sort (lowest/highest price, most reviewed, newest, or most relevant), and repeated filter key:value pairs. Call /tokopedia/search/filters with the same q first to discover which filter keys and values are currently live for that search.
Pass up to 100 characters of partial product text to /tokopedia/autocomplete for Tokopedia's own search-box suggestions.
Pass a canonical category path beginning with /p/ to /tokopedia/category. For homepage recommendations, call /tokopedia/home/tabs to list the current tabs, then pass a tab_id and page (1 through 5) to /tokopedia/home.
Pass the canonical shop_domain and product_key pair (as returned by search or category results) to /tokopedia/product for full public detail. Use /tokopedia/product/review-filters with a numeric product_id for that product's review-filter metadata.
/tokopedia/autocompleteapiKey3 credits/requestReturns current public Tokopedia search suggestions for a partial keyword. Suggestions include canonical product-search URLs and are not product-search results.
Required: q.
Sampled 14 Oct 2026: 9 items. Filled in every item: text, url, is_ad. In the sample: text: “sepatu pria” and 8 other values; url: tokopedia.com; is_ad: true in 0 of 9.
/tokopedia/categoryapiKey3 credits/requestReturns public product cards from a canonical Tokopedia category path. `path` must begin with `/p/`; use the category page path, not a product or search URL.
Required: path.
Sampled 14 Oct 2026: 5 items. Filled in every item: name, url. In the sample: name: “Sony SHAKE-X10D Home Audio Speaker Bluetooth With DVD Shake…” and 4 other values; url: tokopedia.com.
/tokopedia/homeapiKey3 credits/requestReturns public product-card recommendations for a current Tokopedia home tab. Omit `tab_id` for the first available tab; discover other tabs through `/tokopedia/home/tabs`.
Optional: tab_id, page.
Sampled 14 Oct 2026: 19 items. Filled in every item: name, url, image_url, price, price_text, rating, shop_name, shop_city. In the sample: price: 21,888 to 400,000, median 97,020; name: “Mieia Panci Presto Rumah Tangga Serbaguna Pengoperasian Sat…” and 18 other values; url: tokopedia.com; image_url: p16-images-sign-sg.tokopedia-static.net and 2 other hosts; price_text: “Rp255.420” and 18 other values; rating: 4.7 to 5, median 4.9; shop_name: “Mieia” and 16 other values; shop_city: “Kab. Tangerang” and 9 other values.
/tokopedia/home/tabsapiKey3 credits/requestLists the current Tokopedia home recommendation tabs, each with its `id`, `name` and an optional image URL, plus a `fetched_at` timestamp. It takes no parameters. Pass a returned `id` as `tab_id` to `/tokopedia/home` to load that tab.
Takes no parameters.
Sampled 14 Oct 2026: 11 items. Filled in every item: id, name. Not in every item: image_url (1). In the sample: name: “For You” and 10 other values; image_url: p16-images-comn-sg.tokopedia-static.net.
/tokopedia/productapiKey5 credits/requestReturns public product detail from a canonical Tokopedia shop domain and product key. This endpoint does not accept arbitrary URLs; numeric product IDs are returned when the product page exposes them but cannot be used as lookup input.
Required: shop_domain, product_key.
Sampled 14 Oct 2026: 11 fields returned with a value. In the sample: price: 25,092,000; shop_domain: “ismile-indonesia”; browser_rendered: true; description: 2,735 characters; images: 5 entries; name: “[ SPESIAL PROMO ] Apple iPhone 17 Pro Max Garansi Resmi 256…”; price_text: “Rp25.092.000”; original_price: “Rp31.999.000”.
/tokopedia/product/review-filtersapiKey3 credits/requestReturns which public review media, rating, and topic filters are available for a numeric product ID. It does not return review text, review media, or a review archive.
Required: product_id.
Sampled 14 Oct 2026: 6 items. Filled in every item: key, available. In the sample: available: true in 6 of 6.
/tokopedia/searchapiKey3 credits/requestReturns public Tokopedia product cards for a keyword from Tokopedia's public product-search operation. `sort` accepts `3` (lowest price), `4` (highest price), `5` (most reviewed), `9` (newest), or `23` (most relevant). Repeat `filter` as `key:value` using values from `/tokopedia/search/filters`.
Required: q. Optional: page, sort (5 allowed values: 3, 4, 5, 9, 23), filter.
Sampled 14 Oct 2026: 60 items. Filled in every item: name, url, image_url, price, price_text, rating, shop_name, shop_city. In the sample: price: 80,000 to 3,399,000, median 391,200; name: “SALOMON SPEEDCROSS 3 HOLIDAY Unisex Sportstyle Running Shoe…” and 58 other values; url: tokopedia.com; image_url: p16-images-sign-sg.tokopedia-static.net and 3 other hosts; price_text: “Rp3.399.000” and 53 other values; shop_name: “SALOMON Indonesia” and 27 other values; shop_city: “Jakarta Utara” and 9 other values.
/tokopedia/search/filtersapiKey3 credits/requestReturns the live filter tree and supported sort choices for a Tokopedia product search. The response includes categories when the current query exposes them, store type, delivery location, price, rating, offer, condition, recency, shipping, and stock options as applicable.
Required: q.
Sampled 14 Oct 2026: 10 items. Filled in every item: title, options. Not in every item: template (5), searchable (1), placeholder (1). In the sample: title: “Durasi Pengiriman” and 9 other values; searchable: true in 1 of 1; options: median 2 entries; template: “template_location” and 4 other values; placeholder: “Cari Lokasi”.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Autocomplete Tokopedia product searches | GET /tokopedia/autocomplete?q=iph | 99.7% | 1.64 s |
| Browse a Tokopedia category | GET /tokopedia/category?path=%2Fp%2Fhandphone-tablet%2Fhandphone | 99% | 2.43 s |
| Get Tokopedia home recommendations | GET /tokopedia/home | 99.9% | 3.79 s |
| List Tokopedia home recommendation tabs | GET /tokopedia/home/tabs | 99.8% | 1.46 s |
| Get a Tokopedia product's public detail | GET /tokopedia/product?product_key=apple-iphone-17-pro-max-garansi-resmi-256gb-512gb-1tb-2tb-1733012454966462347&shop_domain=ismile-indonesia | 99.5% | 19.12 s |
| Get Tokopedia product review-filter metadata | GET /tokopedia/product/review-filters?product_id=102491859263 | 99.8% | 1.57 s |
| Search Tokopedia products | GET /tokopedia/search?q=sepatu+lari | 99% | 2.29 s |
| Get Tokopedia search filters and sorts | GET /tokopedia/search/filters?q=sepatu | 99.4% | 1.80 s |