Shopee Scraper: Search Products Across All Shopee Markets

Extract live Shopee product search results from every supported Shopee country/region marketplace with automatic market-matched residential proxy routing.

Shopee Search Scraper is built for ecommerce teams, sellers, analysts, and data pipelines that need structured Shopee product data without maintaining browser automation, proxy routing, and search-result parsing themselves.

What does this Shopee scraper do?

This Actor opens the selected Shopee marketplace, searches your keyword, captures Shopee search result data, and writes normalized product rows to the default Apify dataset.

It is useful as a practical Shopee search API alternative for:

• Shopee price monitoring
• competitor product tracking
• ecommerce market research
• assortment and catalog analysis
• product sourcing research
• seller and marketplace intelligence
• scheduled product search exports

Supported Shopee countries and proxy routing

When you choose a market, the Actor automatically uses Apify RESIDENTIAL proxy IPs from the matching country/region. You usually do not need to configure proxies manually.

Market code	Country / region	Shopee domain	Proxy country
PH	Philippines	shopee.ph	PH
SG	Singapore	shopee.sg	SG
MY	Malaysia	shopee.com.my	MY
TH	Thailand	shopee.co.th	TH
TW	Taiwan	shopee.tw	TW
VN	Vietnam	shopee.vn	VN
ID	Indonesia	shopee.co.id	ID
BR	Brazil	shopee.com.br	BR
MX	Mexico	shopee.com.mx	MX
CO	Colombia	shopee.com.co	CO
CL	Chile	shopee.cl	CL

If you provide a custom proxyConfiguration with the wrong proxy country, the Actor fails fast instead of silently scraping the wrong regional site.

Features

• Scrape Shopee search results by keyword
• Support all currently configured Shopee country/region marketplaces listed above
• Automatically match Apify residential proxy country to selected market
• Browser-assisted collection with Shopee search_items network payload capture
• DOM fallback when the API payload is unavailable
• Normalized product rows with stable IDs and product URLs
• Optional debug artifacts in key-value store for troubleshooting
• Live View / Standby endpoints with a valid OpenAPI schema
• Pay-per-event pricing: low run start fee + per-result billing

Input

Field	Type	Required	Description
keyword	string	yes	Search keyword, for example phone case, sneakers, or wireless earbuds.
market	string	no	Shopee country/region code. Default: PH.
limit	integer	no	Maximum number of product rows to output. Default: 30, max: 200.
fetchMode	string	no	playwright_browser for live runs; fixture only for deterministic local QA.
proxyConfiguration	object	no	Optional Apify proxy configuration. If omitted, the Actor uses RESIDENTIAL + selected market country.
proxyUrl / proxyServer	string	no	Optional custom proxy override. Use only if you manage your own proxy routing.
proxyCountry	string	no	Optional country assertion. Must match selected market country.

Advanced browser/session fields are available for troubleshooting in the input schema, including storage-state replay, Chrome cookie import, native Chrome CDP attach, scroll settings, and debug limits.

Example input

{
  "keyword": "phone case",
  "market": "PH",
  "limit": 30,
  "fetchMode": "playwright_browser"
}

Example for Singapore:

{
  "keyword": "wireless earbuds",
  "market": "SG",
  "limit": 100
}

Output

Each product is written as one dataset item.

Field	Description
market	Selected Shopee market code
market_name	Country/region display name
market_host	Shopee domain used for collection
country	Country/region name
keyword	Search keyword
rank	Rank within the returned results
absolute_rank	Absolute result rank
shop_id	Shopee shop ID
item_id	Shopee item ID
product_id	Combined product identifier when available
title	Product title
price	Display price with market currency
sold_text	Sold count text when visible
rating_text	Rating text when visible
location	Seller/product location text
product_url	Canonical Shopee product URL
source_url	Search URL used for collection
image	Product image URL
currency / currency_code	Market currency details
captured_at	ISO timestamp
source	Extraction source, e.g. API capture or DOM fallback
provider	Fetch provider used by the Actor

Example output item

{
  "market": "PH",
  "market_name": "Philippines",
  "market_host": "shopee.ph",
  "country": "Philippines",
  "keyword": "phone case",
  "rank": 1,
  "absolute_rank": 1,
  "shop_id": "123456789",
  "item_id": "11111111111",
  "product_id": "123456789_11111111111",
  "title": "Soft Silicone Phone Case for iPhone 13",
  "price": "₱129.00",
  "sold_text": "1.2k sold",
  "rating_text": "4.9",
  "location": "Metro Manila",
  "product_url": "https://shopee.ph/product/123456789/11111111111",
  "image": "https://down-ph.img.susercontent.com/file/example-image",
  "currency_code": "PHP",
  "source": "shopee_search_api",
  "provider": "playwright_browser"
}

Live View and OpenAPI

The Actor includes a lightweight Standby / Live View web server. Normal scraping still runs as a standard Apify Actor run.

Available Live View endpoints:

Endpoint	Purpose
GET /	Service metadata and readiness
GET /health	Health check
GET /markets	Supported markets and proxy-country mapping
GET /input-example	Low-cost example input
GET /openapi.json	Packaged OpenAPI 3 schema

Pricing

This Actor uses Pay per event pricing.

Event	Event name	Price
Actor Start	apify-actor-start	$0.005 per run
Result	apify-default-dataset-item	$2.00 / 1,000 results ($0.002 each)

User pays platform usage costs: Yes. Apify platform usage such as compute and proxy usage is charged to the user separately from the Actor event price.

Example: 1,000 product rows cost approximately $0.005 start + $2.00 result events, plus Apify platform usage.

How to scrape Shopee search results

1. Open the Actor on Apify.
2. Enter a keyword.
3. Select the target market.
4. Set limit.
5. Keep fetchMode=playwright_browser for live scraping.
6. Run the Actor.
7. Export the dataset as JSON, CSV, Excel, XML, RSS, or HTML.

Free Apify plan limits (set by this Actor's developer)

Limit	Free Apify plan	Paid Apify plan
Runs of this Actor	10 runs total	Unlimited
Results per run	Up to 200	Up to schema max (200)

When the run cap is hit, the run finishes with a clear status message — not an Apify platform error.

Worker URL is config, not code: the Actor reads WORKER_BASE_URL from Actor environment variables (plus optional per-run workerBaseUrl). If you migrate the worker to a new host, update WORKER_BASE_URL (and WORKER_AUTH if the API key changes) in Apify Console — no Actor code change required. Set WORKER_PROVIDES_PROXY=1 when the worker supplies its own proxy / Bright Data stack.

Notes and limitations

• Shopee may show traffic verification, CAPTCHA, or other anti-bot pages depending on session state and IP reputation.
• Residential proxies are strongly recommended for live runs and are automatically selected on Apify.
• Some markets may return fewer visible results for certain keywords.
• The Actor extracts public search-result information; use the data responsibly and respect applicable laws and Shopee terms.

FAQ

Why did my free-plan run stop with a limit message?

Free Apify plan users can run this Actor up to 10 times, with up to 200 results per run. These caps are set by the Actor developer, not Apify. Upgrade to a paid Apify plan for unlimited runs (schema limit still applies).

Which Shopee countries are supported?

Philippines, Singapore, Malaysia, Thailand, Taiwan, Vietnam, Indonesia, Brazil, Mexico, Colombia, and Chile.

Do I need to choose a proxy country?

No. Select the Shopee market and the Actor automatically chooses the matching Apify residential proxy country. If you pass an explicit proxy country that does not match the market, the Actor fails fast to prevent wrong-region results.

Can I run it on a schedule?

Yes. Use Apify schedules to monitor keywords over time for price tracking, competitor monitoring, or product research.

Can I use it from code?

Yes. You can run the Actor from the Apify API, the Apify JavaScript/Python clients, CLI, integrations, or MCP tools.

Is this a Shopee API?

It is not an official Shopee API. It is an Apify Actor that provides structured Shopee search-result data and can be used as a practical Shopee product search API alternative for many workflows.