Shopee Shop Scraper

Extract product listings from a Shopee shop by username, shop ID, or shop URL. Optionally enrich each product with full detail data (variants, stock, images, attributes, seller info).

---

Why This Actor?

Use this to:

• Audit a competitor's full catalog — get every listed product from a specific seller
• Monitor a shop's pricing — track price changes across a shop's entire inventory
• Collect product data with seller context — includes shop rating, follower count, response rate
• Build a dataset of a shop's products — with optional full detail enrichment per product

---

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

Listing a shop's products works for every country regardless of where your request comes from — no proxy is needed for the default mode.

What changes per location is fetchDetail: true: to receive the full detail for each product (description, brand, all 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.

What you get per country

Country	Shop listing (default)	fetchDetail: true on Apify Cloud	fetchDetail: true running locally
id	✅ Product cards	✅ Full detail	✅ Full detail
sg	✅	✅ Full detail	⚠️ Light only
my	✅	✅ Full detail	⚠️ Light only
th	✅	✅ Full detail	⚠️ Light only
ph	✅	✅ Full detail	⚠️ Light only
vn	✅	⚠️ Light only	⚠️ Light only
br	✅	⚠️ Light only	⚠️ Light only
tw	✅	⚠️ Light only	⚠️ Light only
mx	✅	⚠️ Light only	⚠️ Light only
co	✅	⚠️ Light only	⚠️ Light only
cl	✅	⚠️ Light only	⚠️ Light only

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

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

Recommendation: Default mode (without fetchDetail) works everywhere. For fetchDetail: true on sg/my/th/ph, run this actor on Apify Cloud.

---

Input

Field	Type	Required	Description
country	select	No (default: id)	Shopee regional domain
shop	string	Yes	Shop identifier — username, numeric ID, or full shop URL
maxProducts	integer	No (default: 40)	Maximum products to return
fetchDetail	boolean	No (default: false)	If true, each product is enriched with full detail data
delay	number	No (default: 1.0)	Delay between HTTP requests (seconds)

How to Identify a Shop

Format	Example
Username	rasyidjaya_computer
Numeric shop ID	196846900
Full shop URL	https://shopee.co.id/rasyidjaya_computer

---

Output Modes

Default — ProductCard (fast)

Returns lightweight product cards: name, price, discount, rating, sold count, location, image.

{
  "shop_id": 196846900,
  "item_id": 11089699432,
  "name": "Laptop Lenovo Thinkpad X1 Carbon 6th Intel Core i5",
  "url": "https://shopee.co.id/Laptop-Lenovo-i.196846900.11089699432",
  "image_url": "https://down-id.img.susercontent.com/file/id-11134207-xxx",
  "price": 3570000,
  "original_price": null,
  "discount_pct": null,
  "rating": 4.87,
  "rating_count": 55,
  "sold_count": null,
  "location": "KOTA BANDUNG",
  "is_mall": false,
  "currency": "IDR"
}

fetchDetail: true — ProductDetail (rich)

Each product is additionally fetched for full data:

{
  "shop_id": 196846900,
  "item_id": 11089699432,
  "title": "Laptop Lenovo Thinkpad X1 Carbon 6th Intel Core i5",
  "currency": "IDR",
  "description": "Laptop bekas kualitas premium...",
  "brand": "Lenovo",
  "price": 3570000.0,
  "price_min": 3200000.0,
  "price_max": 8370000.0,
  "availability": "InStock",
  "stock": 31,
  "rating_star": 4.87,
  "total_ratings": 55,
  "images": ["https://down-id.img.susercontent.com/file/..."],
  "models": [
    { "model_id": 227787022248, "name": "i5 Gen8 16GB/256GB", "has_stock": true }
  ],
  "attributes": [
    { "name": "Ukuran Layar", "value": "14 inci" }
  ],
  "shop": {
    "name": "RASYIDJAYA COMPUTER",
    "rating_star": 4.84,
    "item_count": 39,
    "follower_count": 2251,
    "response_rate": 98
  }
}

---

Sample Input

Basic shop crawl

{
  "country": "id",
  "shop": "rasyidjaya_computer",
  "maxProducts": 40
}

With full detail enrichment

{
  "country": "id",
  "shop": "rasyidjaya_computer",
  "maxProducts": 20,
  "fetchDetail": true
}

By shop ID

{
  "country": "sg",
  "shop": "196846900",
  "maxProducts": 40
}

By shop URL

{
  "shop": "https://shopee.co.id/rasyidjaya_computer",
  "maxProducts": 40
}

---

Speed & Cost

fetchDetail	Products	Approx. time	Requests
false	40	~40–60 sec	~2
true	10	~2–3 min	~22
true	40	~6–10 min	~82

With fetchDetail: true, each product requires two extra requests. Residential proxy latency on Apify Cloud adds ~5–10 seconds per product.

Recommendation: For a full catalog audit, run with fetchDetail: false first to get the complete product list, then selectively enrich specific products using the Shopee Product Detail actor.

---

Known Limitations

• About 40 products per shop page. The actor pages through more results to reach maxProducts. Shopee eventually starts returning a generic "you may also like" block once the real catalog ends, typically after roughly 150–200 unique items per shop.
• Per-variant prices and stock are hidden by Shopee. With fetchDetail: true, every variant entry will have price: null and stock: null. Use the overall price_min / price_max and the total stock field instead.
• fetchDetail: true returns less data outside id/sg/my/th/ph. For vn, br, tw, mx, co, cl you receive a lighter set: title, price, primary image, rating, sold count, seller info. Description, brand, variants, attributes, breadcrumb, and image gallery are not available for these countries.
• Running locally from a mismatched IP (e.g. from Indonesia for country=sg) also returns the lighter data set for fetchDetail: true. Deploy to Apify Cloud for full detail.
• "Sold count" is missing for most products. Shopee hides this number; the actor recovers it on a best-effort basis (~30–50% of products).