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.

---

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)

---

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)
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 full detail for a single product: description, all attributes, variants (names + stock availability), seller info, breadcrumb, and pricing when available. 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.

---

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": 196846900,
  "item_id": 11089699432,
  "title": "Laptop Lenovo Thinkpad X1 Carbon 6th Intel Core i5 Gen8 Ram 16gb Ssd 256gb Bergaransi",
  "currency": "IDR",
  "brand": "Lenovo",
  "condition": 4,
  "price": 3570000.0,
  "price_min": 3200000.0,
  "price_max": 8370000.0,
  "availability": "InStock",
  "rating_star": 4.87,
  "total_ratings": 55,
  "stock": 31,
  "is_hide_stock": false,
  "images": [
    "https://down-id.img.susercontent.com/file/id-11134207-7ra0n-xxx"
  ],
  "attributes": [
    { "name": "Ukuran Layar", "value": "14 inci" },
    { "name": "Sistem Operasi", "value": "Windows" }
  ],
  "models": [
    {
      "model_id": 227787022248,
      "name": "Carbon 6th i5 Gen8,RAM 16GB/256GB SSD",
      "price": null,
      "stock": null,
      "has_stock": true
    }
  ],
  "tier_variations": [],
  "breadcrumb": [
    { "position": 1, "name": "Shopee", "url": "https://shopee.co.id" },
    { "position": 2, "name": "Komputer & Aksesoris" },
    { "position": 3, "name": "Laptop" }
  ],
  "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
  }
}

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 are not always available. Shopee does not expose per-model pricing without authenticated browser sessions. For products with multiple variants (size/color/spec), individual model prices will appear as null. An overall price range (price_min / price_max) is available for most products.

• Sold count is unreliable. Shopee intentionally hides sold count in most data sources - it is not available via API or page data. The actor makes a best-effort attempt to parse it from rendered page text, with partial (~30-50%) coverage. Many products will return null for sold_count / sold.

• Search is capped at ~40 results per page. Shopee’s SEO-rendered search returns at most 40 products per request. Because this actor uses HTTP-only requests (no authenticated browser session), deeper pagination is not available. The actor can exceed this limit by rotating sort orders, but some overlap may occur and the total unique results can be lower than maxProducts for smaller queries.

• Search pagination beyond page 1 is not supported for category pages Only the first page of category results is accessible without an authenticated browser session. Since this actor does not use browser automation or login, it cannot retrieve deeper pages that require client-side navigation or authenticated requests.

• Not suitable for real-time flash sale pricing. Flash sale and voucher prices require an authenticated browser session and cannot be obtained via HTTP-only methods.