Tokopedia Search Scraper

Extract product listing data from Tokopedia search pages and store it as structured dataset items.
Use a Tokopedia search URL or a keyword, and control result limits for fast, repeatable collection.

---

Features

• Scrapes Tokopedia search products by keyword or direct search URL
• Supports pagination with results_wanted and max_pages limits
• Captures product, price, rating, sold text, shop, and category data
• Deduplicates results across pages
• Returns clean dataset output ready for API or export workflows

---

Use Cases

• Product and price monitoring
• Competitor assortment research
• Marketplace trend tracking by keyword
• Seller and category benchmarking
• Input data for dashboards or BI tools

---

Input Parameters

Field	Type	Default	Description
startUrl	string	Tokopedia game search URL	Tokopedia search URL to start from
keyword	string	game	Search keyword; overrides q from startUrl when provided
results_wanted	integer	20	Maximum number of products to save
max_pages	integer	10	Maximum number of result pages to visit
proxyConfiguration	object	{ "useApifyProxy": false }	Optional proxy settings

---

Output Data

Field	Type	Description
keyword	string	Search keyword used
page	integer	Page number
position	integer	Product position in overall sequence
product_id	string	Product identifier
title	string	Product title
product_url	string	Product page URL
image_url	string	Product image URL
price	string	Display price
price_number	number	Numeric price
original_price	string	Original price if available
discount_percentage	number	Discount percentage if available
rating	number	Product rating
sold_count	string	Sold text from listing
shop_name	string	Seller name
shop_url	string	Seller URL
shop_city	string	Seller city/region
category_name	string	Category name
is_ad	boolean	Ad indicator
fetched_at	string	ISO timestamp

---

Usage Examples

Example 1: Basic keyword scrape

{
  "keyword": "game",
  "results_wanted": 20,
  "max_pages": 3
}

Example 2: Start from a specific search URL

{
  "startUrl": "https://www.tokopedia.com/search?st=&q=keyboard",
  "results_wanted": 50,
  "max_pages": 5
}

---

Sample Output

{
  "keyword": "game",
  "page": 1,
  "position": 1,
  "product_id": "1755362829",
  "title": "Sticker Pack Capcom Character Game Megaman Ryu Ken Stiker Laptop Vinyl - Pack A, Doff",
  "product_url": "https://www.tokopedia.com/sutikki/sticker-pack-capcom-character-game-megaman-ryu-ken-stiker-laptop-vinyl-pack-a-glossy",
  "image_url": "https://p16-images-sign-sg.tokopedia-static.net/...jpeg",
  "price": "Rp25.000",
  "price_number": 25000,
  "discount_percentage": 0,
  "shop_name": "Sutikki",
  "shop_url": "https://www.tokopedia.com/sutikki",
  "shop_city": "Jakarta Selatan",
  "category_name": "Komputer & Laptop",
  "is_ad": false,
  "fetched_at": "2026-03-04T07:00:00.000Z"
}

---

Tips

• Keep results_wanted close to your real need for faster runs.
• Use max_pages as a safety cap when running broad keywords.
• Page size, sort order, and safe search are configured internally for stable output.
• If response quality drops, enable a proxy configuration.

---

Integrations

• Use dataset API endpoint for downstream automations
• Connect with webhooks for run completion workflows
• Export results to CSV/JSON for analytics pipelines
• Schedule recurring runs for daily or hourly monitoring

---

FAQ

Why are results different between runs?

Search ranking and marketplace inventory can change quickly, so ordering and product availability may vary.

Does this scrape product detail pages?

No. This actor collects search listing data only.

Can I scrape multiple keywords?

Run once per keyword or orchestrate multiple runs from your workflow.

What if I get fewer results than requested?

The scraper stops when there are no more pages/items or when max_pages is reached.

---

Legal Notice

You are responsible for using this scraper in compliance with Tokopedia terms, applicable laws, and data privacy rules.
Only collect and use data for lawful purposes, and avoid collecting restricted personal information.