Tokopedia Search, Category & Price Drop Scraper

Tokopedia is Indonesia's largest marketplace, and this actor turns its public product pages into a clean dataset. Search by keyword or search URL, browse a category, or paste product URLs to collect prices in Rupiah, discounts, ratings, sold counts, seller details, condition, stock, variants, and images. No account, login, or proxy setup is needed.

What this actor does

• Search products by keyword or a Tokopedia search/find URL, with Tokopedia's real filters and five real sort orders.
• Browse categories from a /p/... URL or a numeric category ID.
• Fetch product details from Tokopedia product URLs: condition, stock, weight, minimum order, variants and child SKUs, description, rating breakdown, and campaign dates.
• Price-drop view: every record exposes the current price, original price, discount percentage, discount amount, and a priceDropped flag. Tokopedia does not publish historical prices, so this is a current-snapshot view rather than a price history.
• Overview or detail: keep search results fast, or enable includeDetails to enrich each row with the full product page.
• Empty fields are omitted from each record instead of being returned as null or blank.

Output per product

Field	Description
productId	Tokopedia product ID
name	Product name
productUrl	Direct product page URL
price, priceText	Current price in IDR, numeric and as displayed
originalPrice, originalPriceText	Pre-discount price when shown
discountPercent, discountAmount	Current discount
priceDropped	True when the original price is above the current price
currency	Always IDR
rating, reviewCount	Rating and, in detail mode, review count
sold, soldText	Units sold, parsed into a number plus the source label
shop, shopId, shopUrl, shopLocation	Seller identity and location
shopTier	mall, power_shop, or regular when known
imageUrl, imageUrlOriginal	Main image plus the signed source URL. Most normalized links are durable; a minority stay on a signed host and expire.
categoryId, categoryName, categoryPath	Category identity and breadcrumb path
labels	Promotional and service labels shown on the card
badge	Official/Power/Mall badge when one is visible
preorder	Whether the listing is a preorder
condition, conditionText	NEW/USED and its local display text (detail)
status	Product status such as ACTIVE (detail)
stock, minOrder, maxOrder	Availability and order limits (detail)
weight, weightUnit	Shipping weight (detail)
isVariant, variants, variantChildren	Variation axes and child SKUs with their prices and stock (detail)
description	Seller description (detail)
specifications	Best-effort key/value specifications parsed from the description (detail)
ratingBreakdown	Per-star rating counts and percentages (detail)
imageUrls	Full gallery of image URLs (detail; mostly durable)
categoryBreadcrumb	Category path with names and URLs (detail)
campaignType, campaignEndsAt, campaignDiscountPercent, campaignStockSoldPercent	Active campaign details when present (detail)
mode, searchQuery, position, scrapedAt	Provenance: mode, query, result position, and scrape time

Input

Field	Type	Default	Description
mode	string	–	search, categoryBrowse, or productDetails
searchQueries	array	[] (prefill ["smartphone"])	Keywords to search (mode=search)
searchUrls	array	[]	Tokopedia search or /find/ URLs (mode=search)
categoryUrls	array	[]	Tokopedia category URLs (mode=categoryBrowse)
categoryIds	array	[]	Numeric category IDs (mode=categoryBrowse)
productUrls	array	[]	Product page URLs (mode=productDetails)
sortBy	string	relevance	relevance, newest, price_low, price_high, most_reviewed
priceMin, priceMax	integer	–	Price range in IDR
condition	string	any	any, new, used
shopType	string	any	any, mall, power_shop
minRating	string	any	any or 4
city	string	any	Common seller locations, or any
cityId	string	–	Exact Tokopedia city ID(s), comma-separated
latestProductDays	string	any	any, 7, 14, 30, 90
discountOnly	boolean	false	Only discounted products
codOnly	boolean	false	Only cash-on-delivery products
freeShippingOnly	boolean	false	Only products with the free-shipping offer
preorder	string	any	any, ready_stock, preorder
includeDetails	boolean	false	Enrich search/category rows from each product page
maxItems	integer	100	Maximum products, 1–6000

Example: search with filters

{
  "mode": "search",
  "searchQueries": ["sepatu lari"],
  "sortBy": "price_low",
  "priceMin": 100000,
  "priceMax": 500000,
  "shopType": "mall",
  "minRating": "4",
  "maxItems": 50
}

Example: browse a category

{
  "mode": "categoryBrowse",
  "categoryUrls": ["https://www.tokopedia.com/p/handphone-tablet/handphone"],
  "sortBy": "newest",
  "maxItems": 100
}

Example: full product details

{
  "mode": "productDetails",
  "productUrls": [
    "https://www.tokopedia.com/pxofficialindonesia/kabel-data-usb-type-c-ultra-fast-charging-pd240w-charger-nylon-braided-laptop-tablet-smartphone-samsung-oppo-huawei-vivo-px-fcc-2m-1736805261334316721"
  ]
}

Use cases

• Price and discount monitoring — compare current prices, discounts, and campaign end dates across a category or keyword.
• Seller intelligence — compare shop type, location, sold counts, and ratings across merchants.
• Assortment planning — browse a category to see the current product mix and pricing ladder.
• Product research — collect variants, child SKUs, stock, weight, condition, and descriptions for a shortlist.
• Marketplace analytics — feed clean product records into dashboards, spreadsheets, or a database.

FAQ

Do I need a Tokopedia account or login? No. The actor reads public product, search, and category pages.

What currency are prices in? Indonesian Rupiah (IDR), returned as integers.

What does "price drop" mean here? It means the product currently has a lower price than its displayed original price. Tokopedia does not publish a historical price series, so the actor cannot show a true past price. Run it on a schedule and compare price values to build your own history.

Why are some fields missing? Tokopedia does not show every field on every listing. A product without a discount has no originalPrice; a listing without a description spec block has no specifications. The actor omits missing fields instead of guessing.

Why do some product URLs fail? The actor needs the normal Tokopedia product URL (/{shop}/{product-slug}-{id}). Numeric product IDs alone do not resolve through the public site.

How many products can I get per search? Up to 6,000 products per search slice. Tokopedia caps pagination at that point. For larger sets, split the work by keyword, category, price range, or location.

Can I filter by seller city? Yes. Use the location dropdown for common cities, or cityId for an exact Tokopedia city ID from a Tokopedia search URL.

Are image links permanent? The actor returns a normalized image URL and keeps the original signed URL in imageUrlOriginal. Most normalized links are durable, but a minority remain on Tokopedia's signed host; those expire within hours. Use imageUrlOriginal promptly or re-run the actor to refresh them.

Is this affiliated with Tokopedia? No. This is an independent third-party actor that reads publicly available Tokopedia pages and is not operated by or affiliated with Tokopedia.