Shopee Scraper

Extract product data from Shopee across 11 countries - keyword search, category browsing, product detail, and shop listings. No browser automation, no proxy required for most regions.

---

Related Actors

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

---

Why Use This Actor?

Shopee does not provide a public API. Most scraping solutions rely on full browser automation (Playwright/Puppeteer), which is slow, expensive, and fragile. This actor works without launching a browser at all, making it:

• Fast - lightweight HTTP requests instead of rendering a full browser
• Cost-efficient - lower compute unit consumption
• Stable - no dependency on browser fingerprinting or JS rendering pipelines

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)

---

⚠️ Important: product detail is now partial for ALL countries (Shopee change, mid-2026)

Full product detail — description, brand, per-variant models, attributes, tier variations, full image gallery — is no longer obtainable via HTTP scraping for any Shopee country.

In mid-2026 Shopee migrated every product page to a client-rendered SPA, including shopee.co.id, which used to be the one region that server-rendered full data. The product data now loads from an internal API guarded by a JavaScript-signed anti-bot token, so it can't be reached without running a real browser. This is a Shopee platform change, not an actor bug.

No proxy fixes this. The block is token-based, not IP-based — a residential proxy in the target country (or any other proxy) changes the IP but never supplies the required token. Residential proxy still helps avoid IP blocks on listing pages, which is a separate thing.

What detail and fetchDetail: true return today (every country): title, price / price_min / price_max, original price, discount, primary image, rating, sold count, categories + cat_id + breadcrumb, and full seller/shop info.

What they no longer return: description, brand, per-variant models, attributes, tier variations, per-model stock, and the full image gallery. Those require a browser-based approach that is out of scope for this HTTP-only actor.

What you get per country × mode

Country	keyword	category	shop	detail	fetchDetail: true
id	✅	✅	✅	⚠️ Partial	⚠️ Partial
sg	✅	✅	✅	⚠️ Partial	⚠️ Partial
my	✅	✅	✅	⚠️ Partial	⚠️ Partial
th	✅	✅	✅	⚠️ Partial	⚠️ Partial
ph	✅	✅	✅	⚠️ Partial	⚠️ Partial
vn	✅	✅	✅	⚠️ Partial	⚠️ Partial
br	✅	✅	✅	⚠️ Partial	⚠️ Partial
tw	✅	✅	✅	⚠️ Partial	⚠️ Partial
mx	✅ (60–70% have a price)	✅	✅	⚠️ Partial	⚠️ Partial
co	✅	❌ Not available	✅	⚠️ Partial	⚠️ Partial
cl	✅	❌ Not available	✅	⚠️ Partial	⚠️ Partial

Legend:

• ✅ = works and returns the fields documented for that mode.
• ⚠️ Partial = title + price (price / price_min / price_max) + original price + discount + primary image + rating + sold count + categories + cat_id + breadcrumb + seller/shop info. Does not include description, brand, variants/models, attributes, tier variations, per-model stock, or the full image gallery (see the note above — Shopee removed these from HTTP-reachable data mid-2026). Same for every country now, including id.
• ❌ Not available = the mode is rejected with a clear error message in the run log. Use keyword or shop mode for these regions instead.

---

Use Cases

• Price monitoring - track price changes across products or categories over time
• Competitor research - analyze competitor shop listings, pricing tiers, and discount strategies
• Market research - discover bestselling products in a category or keyword segment
• Product catalog extraction - pull product titles, images, attributes, and variants from a shop or search result
• Lead generation - collect seller info (shop name, location, rating, follower count, response rate)

---

Input

Field	Type	Required	Description
country	select	No (default: id)	Shopee regional domain to scrape
mode	select	Yes	Scraping mode (see below)
keyword	string	mode=keyword	Search term, e.g. "laptop gaming"
url	string	mode=url	Any Shopee URL - product, search, category, or shop page
shopId	integer	mode=detail	Seller's numeric shop ID
itemId	integer	mode=detail	Product's numeric item ID
category	string	mode=category	Category slug, e.g. /Laptop-cat.11044364.11044440
shop	string	mode=shop	Shop username or numeric shop ID
sort	select	No (default: relevancy)	Sort order for search/category results
maxProducts	integer	No (default: 40)	Maximum products to return
minPrice	integer	No	Minimum price filter in local currency (keyword mode only)
maxPrice	integer	No	Maximum price filter in local currency (keyword mode only)
fetchDetail	boolean	No (default: false)	If true, each product card in keyword/category/shop/url modes is enriched with the extra detail fields still reachable over HTTP: price_min/price_max, availability, categories + cat_id + breadcrumb, and full seller/shop info. Slower — each product adds up to 3 HTTP requests. Recommended for ≤ 20 products. (Does not add description/brand/variants/attributes — those are browser-only since mid-2026.)
delay	number	No (default: 1.0)	Delay in seconds between requests

Modes Explained

keyword - Search by keyword

Searches Shopee for a keyword and returns product cards (name, price, discount, images, IDs, location).

Note: Results are capped at ~40 products per sort variant. To get more products, increase maxProducts - the actor will automatically cycle through additional sort orders (sales, newest, price_asc, price_desc) to surface more unique results.

url - Auto-detect from any Shopee URL

Paste any Shopee URL and the actor auto-detects whether it's a product page, search result, category, or shop listing. Country is also auto-detected from the URL domain, so you can paste a shopee.sg URL even when the country input is set to id.

detail - Product detail by Shop ID + Item ID

Fetches the (now partial) detail for a single product: title, pricing, primary image, rating, sold count, categories + cat_id + breadcrumb, and full seller info. Description, brand, variants/models, attributes, tier variations, and the full image gallery are no longer returned for any country — see the "product detail is now partial for all countries" note above. You need the Shop ID and Item ID, which can both be found in the product URL:

https://shopee.co.id/Product-Name-i.{SHOP_ID}.{ITEM_ID}
                                     ↑          ↑

category - Browse a category page

Provide a category slug (e.g. /Laptop-cat.11044364.11044440) or a full category URL. Returns up to maxProducts product cards from that category.

shop - Fetch a shop's product listing

Provide a shop username (e.g. rasyidjaya_computer) or a numeric shop ID. Returns product cards from that shop's storefront.

---

fetchDetail — Rich Enrichment Mode

By default, modes keyword, category, shop, and url return lightweight ProductCard data (name, price, discount, rating, image URL). This is fast and suitable for large-scale discovery.

Set fetchDetail: true to enrich each card with the extra ProductDetail fields still reachable over HTTP: price_min / price_max, availability, categories + cat_id + breadcrumb, and full seller/shop info.

Note: description, brand, variants/models, attributes, tier variations, per-model stock, and the full image gallery are no longer returned for any country — Shopee moved them behind a browser-only anti-bot API in mid-2026. See the "product detail is now partial for all countries" note above. fetchDetail: true is now a modest enrichment (categories/breadcrumb/pricing range/shop), not a full-detail upgrade.

Speed & Cost

Mode	fetchDetail	~Time for 40 products	Requests
keyword	false	~40–60 sec	~2
keyword	true	~6–10 min	~122
detail	—	~5–10 sec	3

Each enriched product requires up to 3 HTTP requests (shop-listing lookup + shop API + fbbot JSON-LD for categories). With the default 1 second delay, expect ~8–12 seconds per product.

Recommendation: Use fetchDetail: false for discovery (large keyword/category runs). Since full PDP fields are no longer HTTP-reachable, fetchDetail: true mainly adds categories/breadcrumb and shop info.

What fetchDetail Adds

Field	ProductCard	ProductDetail (fetchDetail=true)
name / title	✓	✓
price, discount_pct	✓	✓
rating, sold_count	✓	✓
image_url (1 image)	✓	✓
price_min, price_max	✗	✓
availability	✗	✓
categories[], cat_id	✗	✓
breadcrumb[]	✗	✓
shop{} (seller detail)	✗	✓
description	✗	✗ (browser-only since mid-2026)
brand, brand_id	✗	✗ (browser-only since mid-2026)
images[] (full gallery)	✗	✗ (browser-only since mid-2026)
models[] (variants)	✗	✗ (browser-only since mid-2026)
tier_variations[]	✗	✗ (browser-only since mid-2026)
attributes[]	✗	✗ (browser-only since mid-2026)
stock, historical_sold	✗	✗ (browser-only since mid-2026)

Example — fetchDetail enabled

Input:

{
  "country": "id",
  "mode": "keyword",
  "keyword": "laptop gaming",
  "maxProducts": 5,
  "fetchDetail": true
}

Output (one item, enriched):

{
  "shop_id": 250649369,
  "item_id": 10547676232,
  "title": "ASUS VIVOBOOK GO 14 E1404FA RYZEN 3 7320 8GB 512GB W11+OHS 14.0FHD",
  "currency": "IDR",
  "price": 11648000.0,
  "price_min": 11648000.0,
  "price_max": 11648000.0,
  "discount_pct": 49,
  "rating_star": 5.0,
  "sold": 280,
  "images": ["https://down-id.img.susercontent.com/file/id-11134207-7ra0o-xxx"],
  "cat_id": 11044443,
  "categories": [
    { "catid": 11044364, "name": "Komputer & Aksesoris", "url": "https://shopee.co.id/Komputer-Aksesoris-cat.11044364" },
    { "catid": 11044440, "name": "Laptop", "url": "https://shopee.co.id/Laptop-cat.11044364.11044440" },
    { "catid": 11044443, "name": "Laptop Gaming", "url": "https://shopee.co.id/Laptop-Gaming-cat.11044364.11044440.11044443" }
  ],
  "breadcrumb": [
    { "position": 1, "name": "Shopee", "url": "https://shopee.co.id/" },
    { "position": 2, "name": "Komputer & Aksesoris", "url": "https://shopee.co.id/Komputer-Aksesoris-cat.11044364" },
    { "position": 3, "name": "Laptop", "url": "https://shopee.co.id/Laptop-cat.11044364.11044440" },
    { "position": 4, "name": "Laptop Gaming", "url": "https://shopee.co.id/Laptop-Gaming-cat.11044364.11044440.11044443" }
  ],
  "shop": {
    "shopid": 250649369,
    "name": "Agres Official Shop",
    "username": "agresid",
    "rating_star": 4.91,
    "item_count": 2127,
    "follower_count": 191828,
    "is_official_shop": true
  }
}

description, brand, models, attributes, tier_variations, and stock are returned as empty/null — Shopee no longer exposes them over HTTP (see the limitation note above).

---

Sample Input & Output

Example 1 - Keyword Search

Input:

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

Output (one item):

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

Example 2 - Product Detail

Input:

{
  "country": "id",
  "mode": "detail",
  "shopId": 196846900,
  "itemId": 11089699432
}

Output:

{
  "shop_id": 250649369,
  "item_id": 10547676232,
  "title": "ASUS VIVOBOOK GO 14 E1404FA RYZEN 3 7320 8GB 512GB W11+OHS 14.0FHD GRN GRY",
  "currency": "IDR",
  "shop_location": "KOTA JAKARTA UTARA",
  "price": 11648000.0,
  "price_min": 11648000.0,
  "price_max": 11648000.0,
  "discount_pct": 49,
  "rating_star": 5.0,
  "sold": 280,
  "images": [
    "https://down-id.img.susercontent.com/file/id-11134207-7ra0o-xxx"
  ],
  "cat_id": 11044443,
  "categories": [
    { "catid": 11044364, "name": "Komputer & Aksesoris", "url": "https://shopee.co.id/Komputer-Aksesoris-cat.11044364" },
    { "catid": 11044440, "name": "Laptop", "url": "https://shopee.co.id/Laptop-cat.11044364.11044440" },
    { "catid": 11044443, "name": "Laptop Gaming", "url": "https://shopee.co.id/Laptop-Gaming-cat.11044364.11044440.11044443" }
  ],
  "breadcrumb": [
    { "position": 1, "name": "Shopee", "url": "https://shopee.co.id/" },
    { "position": 2, "name": "Komputer & Aksesoris", "url": "https://shopee.co.id/Komputer-Aksesoris-cat.11044364" },
    { "position": 3, "name": "Laptop", "url": "https://shopee.co.id/Laptop-cat.11044364.11044440" },
    { "position": 4, "name": "Laptop Gaming", "url": "https://shopee.co.id/Laptop-Gaming-cat.11044364.11044440.11044443" }
  ],
  "shop": {
    "shopid": 250649369,
    "name": "Agres Official Shop",
    "username": "agresid",
    "location": "KOTA JAKARTA UTARA",
    "rating_star": 4.91,
    "item_count": 2127,
    "follower_count": 191828,
    "response_rate": 100,
    "is_official_shop": true
  }
}

Note: description, brand, models/variants, attributes, tier_variations, and per-item stock are no longer returned for any country (Shopee moved them behind a browser-only API mid-2026). See the limitation note near the top.

Example 3 - URL Auto-detect

Input:

{
  "mode": "url",
  "url": "https://shopee.co.id/search?keyword=mouse+wireless",
  "maxProducts": 20
}

Returns the same format as keyword search. Country is auto-detected from the URL.

---

Known Limitations

• Per-variant prices and stock are hidden by Shopee. For products with multiple variants (size, color, spec), each variant entry will have price: null and stock: null. You receive an overall price range (price_min / price_max) for most products, plus a single aggregate stock value.

• The exact displayed price is hidden in detail mode. Shopee removes it from the data served to crawlers. You usually still receive price_min and price_max. If you need the exact price, scrape the product through keyword / category / shop mode first — the product card always carries a price.

• "Sold count" is missing for most products. Shopee hides this number. The actor recovers it on a best-effort basis from visible page text, succeeding for roughly 30–50% of products. Many products will return null for sold_count / sold.

• Keyword search returns around 40 products per page. The actor rotates through different sort orders (sales, newest, price low, price high) to surface more unique items, but the total can fall short of maxProducts for narrow queries.

  Tip — to collect more varied results, run several related keywords instead of one broad term. For example, rather than only laptop, run separate runs 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 gives far broader coverage than a single search.

• Category pages have only one page of results in category mode. Deeper navigation is not available through public access.

• category mode is not available for Colombia (co) and Chile (cl). These regions do not expose category pages publicly. Use keyword or shop mode for those countries.

• Full product detail is no longer available for any country (Shopee change, mid-2026). Description, brand, per-variant models, attributes, tier variations, per-model stock, and the full image gallery were moved behind a client-rendered SPA + JavaScript-signed anti-bot API that can't be reached over HTTP — including shopee.co.id, previously the one region that served full data. detail and fetchDetail: true now return title, pricing, primary image, rating, sold count, categories + cat_id + breadcrumb, and full seller/shop info for every country. No proxy restores the removed fields — the block is token-based, not IP-based. Recovering them requires a browser-based approach (out of scope for this HTTP-only actor). See the "product detail is now partial for all countries" note near the top.

• Flash sale and voucher prices are not available. These require an authenticated browser session and cannot be obtained through public access