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.

---

Related Actors

Shopee Scraper Suite  ·  Search, browse, get full product detail, and extract entire shop catalogs across 11 Shopee countries
All-in-One	Search & Category ▸ You are here	Product Detail	Shop Scraper

---

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"
}

---

Sample Output

Default — one product card per row

Each item in the dataset looks like this:

{
  "shop_id": 12345678,
  "item_id": 98765432100,
  "name": "Laptop Gaming ASUS ROG Strix G15 Ryzen 7 16GB 512GB RTX3060",
  "url": "https://shopee.co.id/Laptop-Gaming-ASUS-ROG-i.12345678.98765432100",
  "image_url": "https://down-id.img.susercontent.com/file/id-11134207-xxx",
  "price": 14999000,
  "original_price": 17500000,
  "discount_pct": 14,
  "rating": 4.9,
  "rating_count": 312,
  "sold_count": 1200,
  "location": "Jakarta Barat",
  "is_mall": false,
  "currency": "IDR"
}

Field	Type	Description
shop_id / item_id	integer	Shopee internal IDs (combine to rebuild the product URL)
name	string	Product title
url	string	Full product URL
image_url	string	Primary thumbnail
price	number	Current displayed price in local currency
original_price	number	Price before discount (if on sale)
discount_pct	integer	Discount percentage (e.g. 14 = 14% off)
rating	number	Average star rating (0–5)
rating_count	integer	Number of reviews
sold_count	integer	Best-effort sold count (may be null)
location	string	Seller location (city / province)
is_mall	boolean	true if seller is a Shopee Mall verified shop
currency	string	Local currency code (IDR, SGD, MYR, etc.)

When fetchDetail: true — full product detail per row

{
  "shop_id": 196846900,
  "item_id": 11089699432,
  "title": "Laptop Lenovo Thinkpad X1 Carbon 6th Intel Core i5 Gen8 16GB 256GB",
  "currency": "IDR",
  "description": "Laptop bekas berkualitas premium, sudah dicek dan bersih...",
  "brand": "Lenovo",
  "brand_id": 52756,
  "condition": 4,
  "cat_id": 11044440,
  "price": 3570000.0,
  "price_min": 3200000.0,
  "price_max": 8370000.0,
  "price_before_discount": null,
  "discount_pct": null,
  "availability": "InStock",
  "stock": 31,
  "is_hide_stock": false,
  "rating_star": 4.87,
  "rating_count": [55, 0, 0, 1, 5, 49],
  "total_ratings": 55,
  "images": [
    "https://down-id.img.susercontent.com/file/id-11134207-7ra0n-xxx",
    "https://down-id.img.susercontent.com/file/id-11134207-7ra0n-yyy"
  ],
  "attributes": [
    { "name": "Screen Size", "value": "14 inches" },
    { "name": "Operating System", "value": "Windows" },
    { "name": "Processor Type", "value": "Intel Core i5" }
  ],
  "models": [
    {
      "model_id": 227787022248,
      "name": "i5 Gen8 RAM 16GB / 256GB SSD",
      "price": null,
      "stock": null,
      "has_stock": true
    }
  ],
  "tier_variations": [
    { "name": "Configuration", "options": ["i5 Gen8 16GB/256GB", "i7 Gen8 16GB/512GB"] }
  ],
  "categories": [
    { "catid": 11044364, "name": "Computers & Accessories" },
    { "catid": 11044440, "name": "Laptops" }
  ],
  "breadcrumb": [
    { "position": 1, "name": "Shopee" },
    { "position": 2, "name": "Computers & Accessories" },
    { "position": 3, "name": "Laptops" }
  ],
  "shop": {
    "shopid": 196846900,
    "name": "RASYIDJAYA COMPUTER",
    "username": "rasyidjaya_computer",
    "location": "KOTA BANDUNG",
    "rating_star": 4.84,
    "item_count": 120,
    "follower_count": 2248,
    "response_rate": 98,
    "response_time": 2
  }
}

Fields available depend on the country and where the request comes from — see the support matrix above. For countries marked Light, only shop_id, item_id, title, currency, price, images (primary), rating_star, sold, shop_location, and shop are returned.

---

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.

  Tip — to collect more varied results, run several related keywords instead of relying on one broad term. For example, rather than only laptop, run separate searches for laptop, laptop gaming, laptop bekas, laptop asus, notebook, etc., then merge the datasets. Each keyword surfaces a different slice of Shopee's catalog, so combining them yields far broader coverage than a single search.

• 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).