Shopee Search & Category Scraper

Search Shopee products by keyword, browse a category page, or auto-detect any Shopee listing URL. Returns lightweight product cards by default, or fully enriched product detail when fetchDetail: true.

---

Modes

Mode	Input	What you get
keyword	Search term	A list of product cards matching the keyword
category	Category path or URL	All products listed under that category
url	Any Shopee URL	Auto-detected: search, category, or shop listing

---

Supported Countries

Code	Domain
id	shopee.co.id (Indonesia)
sg	shopee.sg (Singapore)
my	shopee.com.my (Malaysia)
th	shopee.co.th (Thailand)
ph	shopee.ph (Philippines)
vn	shopee.vn (Vietnam)
br	shopee.com.br (Brazil)
tw	shopee.tw (Taiwan)
mx	shopee.com.mx (Mexico)
co	shopee.com.co (Colombia)
cl	shopee.cl (Chile)

---

Where the request comes from matters

Search and shop listing pages work for every country regardless of where your request comes from. Two specific cases need attention:

• category mode for co (Colombia) and cl (Chile) — these regions do not expose category pages publicly. The actor will stop early with a clear message. Use keyword or shop mode instead, or pick a different country.
• fetchDetail: true — to enrich each product with full information (description, brand, variants, attributes, image gallery), the request must originate inside the target country. On Apify Cloud this is handled automatically for id/sg/my/th/ph via residential proxy. From outside, or for vn/br/tw/mx/co/cl, enrichment returns a lighter set (title, price, primary image, rating, sold count, seller info).

What you get per country × mode

Country	keyword	category	url	fetchDetail: true on Apify Cloud	fetchDetail: true running locally
id	✅	✅	✅	✅ Full	✅ Full
sg	✅	✅	✅	✅ Full (residential proxy used)	⚠️ Light
my	✅	✅	✅	✅ Full (residential proxy used)	⚠️ Light
th	✅	✅	✅	✅ Full (residential proxy used)	⚠️ Light
ph	✅	✅	✅	✅ Full (residential proxy used)	⚠️ Light
vn	✅	✅	✅	⚠️ Light	⚠️ Light
br	✅	✅	✅	⚠️ Light	⚠️ Light
tw	✅	✅	✅	⚠️ Light	⚠️ Light
mx	✅ (60–70% have a price)	✅	✅	⚠️ Light	⚠️ Light
co	✅	❌ Not available	✅ (except category URLs)	⚠️ Light	⚠️ Light
cl	✅	❌ Not available	✅ (except category URLs)	⚠️ Light	⚠️ Light

Full = title, price range, description, brand, all variant names, all attributes, all images, full categories, breadcrumb, seller info.

Light = title, price, primary image, rating, sold count, seller info.

---

Input

Field	Type	Required	Description
country	select	No (default: id)	Country site
mode	select	Yes	keyword / category / url
keyword	string	When mode=keyword	Search term
category	string	When mode=category	Slug or full category URL
url	string	When mode=url	Any Shopee URL
sort	select	No	relevancy / sales / newest / price_asc / price_desc
maxProducts	integer	No (default: 40)	Maximum number of products to return
minPrice / maxPrice	integer	No	Price filter (keyword mode only)
fetchDetail	boolean	No (default: false)	Enrich each card with full product detail
delay	number	No (default: 1.0)	Delay between requests (seconds)

---

Sample Input

Keyword search

{
  "country": "sg",
  "mode": "keyword",
  "keyword": "laptop gaming",
  "sort": "sales",
  "maxProducts": 40
}

Category page

{
  "country": "id",
  "mode": "category",
  "category": "/Laptop-cat.11044364.11044440",
  "maxProducts": 40
}

Auto-detect from any URL

{
  "mode": "url",
  "url": "https://shopee.sg/search?keyword=mouse+wireless"
}

---

Known Limitations

• Roughly 40 products per search page. The actor pages through additional sort orders to surface more unique results, but the total can fall short of maxProducts for narrow queries.
• category mode is not available for Colombia and Chile. These regions do not expose category pages publicly. Use keyword or shop mode for those countries.
• Mexico shows fewer prices. Roughly 30–40% of products on Shopee Mexico do not have a public price — those will come back with price: null.
• fetchDetail: true returns a lighter data set for vn, br, tw, mx, co, cl, even on Apify Cloud. Description, brand, variant list, attributes, and the full image gallery are not available for these countries.
• "Sold count" is missing for most products. Shopee hides this number; the actor recovers it on a best-effort basis (~30–50% of products).