Shopee Scraper

Scrape Shopee product search results and product detail pages across major Shopee marketplaces with flat, MCP-ready JSON output for price monitoring, seller intelligence, marketplace research, and AI-agent workflows.

The actor supports Shopee Singapore, Malaysia, Philippines, Thailand, Vietnam, Indonesia, Brazil, Mexico, and Taiwan. It accepts keyword searches and Shopee URLs, then returns one product record per item with price, rating, sales, stock, seller, image, and source metadata.

What It Extracts

Field	Description
productId, shopId	Shopee item and shop identifiers when available
productUrl	Canonical Shopee product URL
title	Product title
price, priceMin, priceMax	Current price and variant price range
priceBeforeDiscount, discount	Original price and discount label
currency	Marketplace currency such as SGD, MYR, PHP, THB, VND, IDR, BRL, MXN, or TWD
rating, ratingCount	Product rating signals
sold, historicalSold	Recent and historical sold counts when Shopee exposes them
stock	Available stock when returned by the product payload
shopName, shopLocation	Seller identity and location
isOfficialShop, isShopeeMall	Seller quality flags when available
imageUrl	Main product image URL
description	Product description when detail extraction is enabled
categories	Category breadcrumbs when available

When To Use It

Use this actor for e-commerce teams, marketplace sellers, agencies, and analysts who need Shopee product data for competitor price tracking, assortment research, seller benchmarking, stock monitoring, and category intelligence.

Use keyword searches when you want a broad product list:

{
  "providerMode": "scrapeless",
  "country": "SG",
  "searchQueries": ["wireless earbuds", "mechanical keyboard"],
  "maxProducts": 100,
  "maxSearchPages": 3,
  "includeDetails": true
}

Use start URLs when you already have Shopee product, search, category, or shop URLs:

{
  "providerMode": "scrapeless",
  "country": "PH",
  "startUrls": [
    { "url": "https://shopee.ph/search?keyword=sunscreen" },
    { "url": "https://shopee.ph/product/123456/987654321" }
  ],
  "maxProducts": 50
}

When Not To Use It

This actor is not a review scraper, checkout automation tool, private account scraper, coupon redeemer, or order-management integration. It does not log in to Shopee accounts and it does not bypass paywalled or private user data.

Shopee changes anti-bot defenses often. The actor uses browser-backed extraction and residential proxy defaults, but heavily challenged regions or temporary Shopee outages can still produce partial results or warning summaries.

Input Options

Input	Default	Notes
providerMode	auto	scrapeless uses SCRAPELESS_API_KEY, owned uses browser scraping, auto uses Scrapeless when configured
country	SG	Marketplace domain and currency selector
searchQueries	["wireless earbuds"]	One or more keyword searches
startUrls	empty	Shopee product, search, category, or shop URLs
maxProducts	50	Hard cap on returned and charged product records
maxSearchPages	3	Pagination cap for generated keyword search URLs
includeDetails	true	Visits product pages when listing data is incomplete
sortBy	relevance	relevance, latest, or top_sales
includeRawData	false	Adds trimmed raw Shopee payloads for debugging

Output Example

{
  "productId": "131564786",
  "shopId": "22739277",
  "productUrl": "https://shopee.sg/product/22739277/131564786",
  "title": "Wireless Bluetooth Earbuds",
  "price": 19.9,
  "priceMin": 15.9,
  "priceMax": 24.9,
  "priceBeforeDiscount": 29.9,
  "currency": "SGD",
  "discount": "20%",
  "rating": 4.8,
  "ratingCount": 1240,
  "sold": 5000,
  "historicalSold": 15000,
  "stock": 98,
  "shopName": "Shopee Mall Store",
  "shopLocation": "Singapore",
  "isOfficialShop": true,
  "isShopeeMall": true,
  "imageUrl": "https://down-sg.img.susercontent.com/file/example",
  "description": "Bluetooth earbuds with charging case.",
  "categories": ["Mobile & Gadgets", "Audio"],
  "sourceType": "search",
  "sourceUrl": "https://shopee.sg/search?keyword=wireless%20earbuds",
  "scrapedAt": "2026-06-12T08:00:00.000Z"
}

Pricing

Event	Price
Actor start	$0.00005
Product scraped	$0.07 per product

A run capped at 100 products costs at most about $7.00 in product events, plus the small actor start event and Apify platform usage. The actor prints the cost cap at run start and stops charging after maxProducts.

MCP And AI Agent Notes

The actor is designed for Apify MCP and agent workflows. Inputs are narrow, output fields are flat, and every product item keeps stable semantic keys. Use it when an agent needs Shopee product intelligence; do not route generic Amazon, Lazada, TikTok Shop, or review-only tasks here.

Reliability Notes

Shopee data is loaded dynamically and is protected by anti-bot systems in some regions. The recommended production backend is Scrapeless, configured with the SCRAPELESS_API_KEY actor secret and providerMode: "scrapeless". The owned browser backend remains available for diagnostics and future hardening, but current Shopee anti-bot responses can block it. If Shopee or the provider returns a challenge, the run records warnings in OUTPUT and RUN_SUMMARY instead of silently pretending empty data is complete.

For best results:

• Keep maxProducts realistic for the first run.
• Configure SCRAPELESS_API_KEY before using provider-backed production mode.
• Use country-specific Shopee URLs that match the selected country.
• Use residential proxies for cloud runs.
• Enable includeRawData only for debugging.

Legal And Compliance

This actor extracts publicly available Shopee product information. You are responsible for using the data in compliance with Shopee terms, applicable laws, privacy requirements, and marketplace rules. Do not use this actor for account abuse, checkout automation, spam, or collection of private user information.