Tokopedia Scraper

Slug: fatihtahta/tokopedia-scraper

Overview

This actor scrapes structured product data from Tokopedia, Indonesia's largest online marketplace. It automates the collection of product listings from search results, category pages, or direct URLs, outputting clean JSON datasets. It's designed for reliable, large-scale data extraction for analysis and integration.

Key Features

• Comprehensive Data Extraction: Captures product titles, prices, ratings, seller details (name, city, tier), promotional labels, and category information.
• Flexible Input Sources: Accepts direct URLs (startUrls) or search keywords (queries) to initiate scraping.
• Scalable Execution: Handles large batches with configurable limits and uses proxy rotation by default for stability.
• Structured Output: Provides consistent, analytics-ready JSON with numeric and textual fields for easy processing.

How to Use

Configure the actor run with input parameters. You must provide at least one data source via startUrls or queries.

Input Parameters

Example Input

{
  "startUrls": [
    "https://www.tokopedia.com/search?st=&q=baseball"
  ],
  "queries": [
    "baseball bat"
  ],
  "limit": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Input/Output

Output Data

The actor outputs a dataset of items, each representing a product listing. Below is a sample item with field descriptions.

{
  "query": "baseball",
  "page": 1,
  "position": 2,
  "id": 100059318904,
  "title": "81cm Tongkat Bisbol/Alat Olahraga Bisbol/Tongkat Bisbol 81cm/Alat Olahraga",
  "url": "https://www.tokopedia.com/kdsa-mall/81cm-tongkat-bisbol-alat-olahraga-bisbol-tongkat-bisbol-81cm-alat-olahraga-1729621112245159931?extParam=ivf%3Dfalse%26keyword%3Dbaseball%26search_id%3D2025111111181134ED066DF378EF0583HL%26src%3Dsearch",
  "priceText": "Rp99.900",
  "price": 99900,
  "originalPrice": "Rp200.800",
  "discountPercentage": 0,
  "rating": 4.8,
  "shopName": "KDSA MALL",
  "shopCity": "Jakarta Barat",
  "shopTier": 3,
  "isOfficialStore": false,
  "labels": ["8rb+ terjual", "Campaign", "50%"],
  "categoryName": "Olahraga",
  "categoryBreadcrumb": "olahraga/baseball/tongkat-baseball",
  "image": "https://p16-images-common-sign-sg.tokopedia-static.net/...image-url.jpg"
}

Key Output Fields:
* Context: query, page, position (where the item was found in search).
* Product ID: id, title, url.
* Pricing: priceText, price (numeric), originalPrice, discountPercentage.
* Seller Info: shopName, shopCity, shopTier, isOfficialStore, rating.
* Product Details: labels (promotions), categoryName, categoryBreadcrumb, image.