Tokopedia Scraper - Store, Search & Product Details

Extract comprehensive product data from Tokopedia, Indonesia's #1 e-commerce platform. Get prices, ratings, sales data, detailed product specs, and more in seconds with our fast, reliable scraper.

🚀 Why Choose This Scraper?

• ⚡ Lightning Fast - Get results in 6-12 seconds (headless mode, optimized selectors)
• 🎯 Three Modes - Store scraping, product search, OR detailed individual product scraping
• 🔍 Comprehensive Filters - Price range, condition, shipping, ratings, shop type, offers, and more
• 📊 Rich Data - Extract prices, ratings, sales count, stock, variants, descriptions, and more
• 💰 Cost Effective - Low memory usage (~150-200MB), minimal compute time
• 🔄 Smart Pagination - Automatically handles multiple pages
• ✅ Reliable - Robust error handling, continues even if individual products fail

✨ What Can You Do?

🏪 Mode 1: Store Scraping

• Scrape all products from any Tokopedia store
• Filter by specific categories (discount, best-selling, etc.)
• Monitor competitor pricing and inventory
• Track product performance over time

🔎 Mode 2: Product Search

• Search Tokopedia globally for any product
• Comprehensive Filters: Price range, condition, shipping duration, ratings, and more
• Sort by: Price (low/high), Reviews, Newest, Most Relevant
• Filter by: Location, shop type (Mall/Power Merchant), COD/Discount offers
• Advanced Options: Recently added products, instant/same day delivery
• Find the best deals across all sellers

📦 Mode 3: Individual Product Details

• Get comprehensive details for a single product
• Extract stock quantities and availability
• Get all variants (colors, sizes, etc.) with availability
• Full product descriptions
• Minimum order quantities
• Product condition (new/used)
• Etalase/category information
• Multiple product images

📈 Use Cases

• Price Monitoring: Track product prices across stores
• Market Research: Analyze product trends and pricing
• Competitor Analysis: Monitor competitor products and pricing
• Product Sourcing: Find the best suppliers and deals
• Inventory Tracking: Monitor stock and sales performance
• Lead Generation: Find sellers in specific locations

⚠️ Important: One Mode at a Time

You can only run ONE mode per execution:

• ✅ Use store_url for Mode 1 (Store Scraping)
• ✅ Use search for Mode 2 (Product Search)
• ✅ Use product_url for Mode 3 (Individual Product)

❌ Do NOT provide multiple mode parameters in the same run (e.g., both store_url and search)

The scraper will automatically detect which mode to use based on the parameter you provide.

Default Behavior (No Input)

If you run the Actor with no input parameters, it will automatically scrape from an Official Store with a limit of 10 products as a demonstration.

📥 Input Parameters

Mode 1: Store Scraping

Parameter	Required	Description	Example
store_url	Yes	Tokopedia store URL	https://www.tokopedia.com/asus-indonesia-official
limit	No	Max products to scrape (0 = unlimited)	50
category	No	Filter by etalase category	"discount" or "sold"

Mode 2: Product Search

Parameter	Required	Description	Example
search	Yes	Search query	"laptop gaming"
limit	No	Max products to scrape (0 = unlimited)	20
sort_order	No	Sort results	"harga_terendah" (lowest price)
location	No	Filter by seller location	"dki_jakarta"
price_min	No	Minimum price in Rupiah	100000 (Rp100,000)
price_max	No	Maximum price in Rupiah	5000000 (Rp5,000,000)
condition	No	Product condition: "baru" or "bekas"	"baru"
shipping_duration	No	Array of shipping options	["instant", "same_day"]
recently_added_days	No	Days since product added	"7", "14", "30", "90"
shop_tier	No	Array of shop types	["mall", "power_merchant"]
rating_minimum	No	Minimum product rating	"4" (4+ stars)
offers	No	Array of special offers	["cod", "discount"]
stock_status	No	Stock availability	"preorder" or "ready_stock"

Mode 3: Individual Product Details

Parameter	Required	Description	Example
product_url	Yes	Single product URL to scrape	https://www.tokopedia.com/asus-indonesia-official/product

Sort Order Options

• paling_sesuai - Most relevant
• ulasan - Best reviews
• terbaru - Newest
• harga_tertinggi - Highest price
• harga_terendah - Lowest price

Location Options

Major Cities & Regions:

• dki_jakarta - DKI Jakarta
• jabodetabek - Jakarta & surrounding areas (Bogor, Depok, Tangerang, Bekasi)
• bandung - Bandung
• medan - Medan
• surabaya - Surabaya
• semarang - Semarang
• yogyakarta - Yogyakarta
• makassar - Makassar
• bali - Bali
• padang - Padang
• palangka_raya - Palangka Raya

Provinces:

• aceh - Aceh
• banten - Banten
• bengkulu - Bengkulu
• papua - Papua

Other Cities:

• ambon - Ambon
• balikpapan - Balikpapan
• bandar_lampung - Bandar Lampung
• banjar - Banjar
• banjarbaru - Banjarbaru
• banjarmasin - Banjarmasin
• batam - Batam
• batu - Batu
• bekasi - Bekasi
• bima - Bima
• binjai - Binjai
• bitung - Bitung
• blitar - Blitar
• bogor - Bogor
• cilegon - Cilegon
• cimahi - Cimahi
• cirebon - Cirebon
• depok - Depok

Note: We can add more specific locations based on request. Contact us if you need a specific city or region not listed above.

💡 Example Inputs

Example 1: Scrape All Products from a Store

{
  "store_url": "https://www.tokopedia.com/yourstore",
  "limit": 50
}

Use Case: Get all products from a specific store for inventory analysis.

---

Example 2: Scrape Discounted Products Only

{
  "store_url": "https://www.tokopedia.com/yourstore",
  "limit": 100,
  "category": "discount"
}

Use Case: Find all discounted items from a specific store for deal hunting.

---

Example 3: Search for Laptops - Cheapest First

{
  "search": "laptop gaming",
  "limit": 30,
  "sort_order": "harga_terendah"
}

Use Case: Find the cheapest gaming laptops across all Tokopedia sellers.

---

Example 4: Best-Rated Products in Jakarta

{
  "search": "sepatu",
  "limit": 20,
  "sort_order": "ulasan",
  "location": "dki_jakarta"
}

Use Case: Find top-rated shoes from Jakarta sellers only.

---

Example 5: Newest Electronics in Bali

{
  "search": "smartphone",
  "limit": 15,
  "sort_order": "terbaru",
  "location": "bali"
}

Use Case: Monitor latest smartphone releases from Bali sellers.

---

Example 6: Unlimited Store Scraping

{
  "store_url": "https://www.tokopedia.com/yourstore",
  "limit": 0
}

Use Case: Get complete product catalog from any store.

---

Example 7: Search with Price Range Filter

{
  "search": "laptop",
  "limit": 50,
  "price_min": 3000000,
  "price_max": 10000000,
  "sort_order": "harga_terendah"
}

Use Case: Find laptops in the Rp3,000,000 - Rp10,000,000 price range, sorted by lowest price first.

---

Example 8: New Products with Fast Shipping

{
  "search": "smartphone",
  "limit": 30,
  "condition": "baru",
  "shipping_duration": ["instant", "same_day"],
  "recently_added_days": "7"
}

Use Case: Find brand new smartphones added in the last 7 days with instant or same-day delivery options.

---

Example 9: High-Rated Mall Products with Discount

{
  "search": "headphone wireless",
  "limit": 25,
  "shop_tier": ["mall"],
  "rating_minimum": "4",
  "offers": ["discount"],
  "sort_order": "ulasan"
}

Use Case: Find discounted wireless headphones from official mall stores with 4+ star ratings, sorted by reviews.

---

Example 10: Comprehensive Filter Combination

{
  "search": "sepatu olahraga",
  "limit": 40,
  "location": "dki_jakarta",
  "price_min": 200000,
  "price_max": 1000000,
  "condition": "baru",
  "shop_tier": ["mall", "power_merchant"],
  "rating_minimum": "4",
  "offers": ["cod", "discount"],
  "stock_status": "ready_stock",
  "sort_order": "harga_terendah"
}

Use Case: Advanced search for new sports shoes in Jakarta with price range Rp200K-1M, from Mall/Power Merchant stores, 4+ stars, COD available, discounted, ready stock, sorted by lowest price.

---

Example 11: Get Detailed Product Information (Mode 3)

{
  "product_url": "https://www.tokopedia.com/storename/product-name"
}

Use Case: Extract comprehensive details including stock, all variants (colors, sizes), full description, minimum order, condition, and more from a specific product page.

📤 Output Data

Standard Fields (All Modes)

• product_name - Full product title
• product_url - Direct link to product page
• store_name - Seller/store name
• image_url - Product image URL
• price - Current price (e.g., "Rp1.699.999")
• price_numeric - Numeric price for sorting (e.g., 1699999)
• rating - Product rating (e.g., "4.9")
• location - Seller location (e.g., "Jakarta Selatan")
• platform - Always "tokopedia"

Additional Fields (Mode 1 & 2 Only)

• discount_info - Discount percentage (e.g., "34%")
• items_sold - Sales count (e.g., "500+ terjual")
• items_sold_numeric - Numeric sales for sorting (e.g., 500)
• search_query - (Search mode only) The search term used

Exclusive Fields (Mode 3: Individual Product Only)

• stock - Current available quantity (e.g., 71)
• variants - Array of variant options with availability

  [
    {
      "type": "warna",
      "options": [
        {"name": "Putih", "available": true},
        {"name": "Hitam", "available": true},
        {"name": "Kuning", "available": false}
      ]
    }
  ]
  

• description - Full product description with specifications
• min_order - Minimum order quantity (e.g., "1 Buah")
• condition - Product condition ("Baru" or "Bekas")
• etalase - Product category/showcase name
• rating_count - Number of ratings (e.g., "17 rating")
• images - Array of all product images (high quality URLs)

📊 Example Output

Store Product (Mode 1)

{
  "platform": "tokopedia",
  "store_name": "Example Store",
  "product_name": "Example Product Name",
  "product_url": "https://www.tokopedia.com/storename/product-slug",
  "image_url": "https://images.tokopedia.net/img/cache/200-square/...",
  "price": "Rp175.000",
  "price_numeric": 175000,
  "discount_info": "15%",
  "rating": "4.8",
  "items_sold": "100 terjual",
  "items_sold_numeric": 100,
  "location": "Jakarta Pusat"
}

Search Result (Mode 2)

{
  "platform": "tokopedia",
  "store_name": "Example Store",
  "product_name": "Example Product Name",
  "product_url": "https://www.tokopedia.com/storename/product-slug",
  "image_url": "https://images.tokopedia.net/img/cache/200-square/...",
  "price": "Rp1.699.999",
  "price_numeric": 1699999,
  "discount_info": "15%",
  "rating": "5.0",
  "items_sold": "500+ terjual",
  "items_sold_numeric": 500,
  "location": "Jakarta Pusat",
  "search_query": "laptop gaming"
}

Individual Product Details (Mode 3)

{
  "platform": "tokopedia",
  "product_url": "https://www.tokopedia.com/storename/product-name",
  "product_name": "Example Product Name - Variant A",
  "price": "Rp43.900",
  "price_numeric": 43900,
  "stock": 71,
  "rating": "4.4",
  "rating_count": "17 rating",
  "items_sold": "80+",
  "condition": "Baru",
  "min_order": "1 Buah",
  "etalase": "Category Name",
  "store_name": "Example Store",
  "location": "Jakarta Barat",
  "description": "Product description with specifications...",
  "variants": [
    {
      "type": "warna",
      "options": [
        {"name": "White", "available": true},
        {"name": "Black", "available": true},
        {"name": "Gray", "available": true},
        {"name": "Red", "available": true},
        {"name": "Blue", "available": true},
        {"name": "Yellow", "available": false}
      ]
    },
    {
      "type": "ukuran",
      "options": [
        {"name": "S", "available": true},
        {"name": "M", "available": true},
        {"name": "L", "available": true},
        {"name": "XL", "available": false}
      ]
    }
  ],
  "images": [
    "https://images.tokopedia.net/img/cache/700/...",
    "https://images.tokopedia.net/img/cache/700/...",
    "https://images.tokopedia.net/img/cache/700/..."
  ],
  "image_url": "https://images.tokopedia.net/img/cache/700/..."
}

⚡ Performance

• Speed: 6-12 seconds for 20 products
• Memory: ~150-200MB (headless mode)
• Efficiency: Streams data directly, no accumulation
• Reliability: Handles pagination, errors, and edge cases

🎯 Perfect For

• E-commerce Businesses: Monitor competitors and pricing
• Market Researchers: Analyze product trends and demand
• Drop Shippers: Find profitable products and suppliers
• Price Comparison Sites: Aggregate pricing data
• Data Analysts: Collect data for market analysis
• Retailers: Track inventory and pricing strategies

📋 Common Workflows

Workflow 1: Daily Price Monitoring

1. Set up scheduled runs (daily/hourly)
2. Scrape specific store or search query
3. Export data to Google Sheets/Database
4. Track price changes over time

Workflow 2: Market Research

1. Search for product categories
2. Sort by best reviews or most sold
3. Analyze pricing distribution
4. Identify market leaders

Workflow 3: Competitor Analysis

1. Scrape competitor stores
2. Compare product ranges
3. Monitor pricing strategies
4. Track new product launches

🔗 Integration

This Actor works seamlessly with:

• Google Sheets - Export data automatically
• Zapier - Trigger workflows on new data
• Make (Integromat) - Connect to 1000+ apps
• Slack/Discord - Get notifications
• Databases - PostgreSQL, MongoDB, etc.
• Apify API - Programmatic access

❓ FAQ

Q: Can I scrape unlimited products?
A: Yes! Set limit: 0 to scrape all products. Be mindful of Apify compute units.

Q: How fast is the scraper?
A: Approximately 0.3-0.6 seconds per product. 20 products in 6-12 seconds.

Q: Does it support pagination?
A: Yes! Automatically follows "next page" links until limit is reached.

Q: Can I filter by multiple locations?
A: Currently one location at a time. Contact us for custom multi-location support.

Q: What if a product is missing data?
A: The scraper extracts all available data. Missing fields are simply omitted.

Q: How often can I run this?
A: As often as needed! Set up scheduled runs for continuous monitoring.

🗺️ Custom Locations

Need a specific city or region that's not in our location list? We can add more specific locations based on request! Contact us with the location you need, and we'll add it to the scraper.

📞 Support

contact the maintainer through the issue tab or email us at contact@tictech.id