Shopee Product Search Crawler

Extract product listings from Shopee Brazil by keyword or search URL. Returns structured data including prices, ratings, seller info, and image URLs — ready to use in price trackers, market research tools, and e-commerce analytics.

What it does

• Searches Shopee by keyword or full search URL
• Returns up to 500 products per run with automatic pagination
• Extracts clean, structured data directly from Shopee's internal API (no fragile HTML parsing)
• Results sorted by relevancy

Input

Field	Type	Required	Description
keyword	String	✅	Search keyword (e.g. iphone 15) or full Shopee search URL
maxItems	Number		Max products to return. Default: 40, max: 500
cookieHeader	String		Your Shopee session cookies (see below)

Keyword or URL

Both formats are accepted:

iphone 15 pro

https://shopee.com.br/search?keyword=iphone+15+pro

Passing a full URL is useful when you've applied filters on Shopee (category, price range, shipping, etc.) and want to replicate that exact search.

Session cookies

Shopee requires an authenticated session to return full search results. To get your cookies:

Copy the Cookie header value directly from Chrome DevTools (Network tab → any Shopee request → Headers → Cookie) and paste it as a plain string.

Cookies expire approximately every 30 days. The actor returns an error if the session is expired.

Output

Each item in the dataset:

{
  "itemId": "10000000001",
  "shopId": "20000000001",
  "name": "Product Name Example - 128GB Blue",
  "price": 20990,
  "priceMax": null,
  "currency": "BRL",
  "stock": 142,
  "sold": 3800,
  "rating": 4.8,
  "ratingCount": 256,
  "shopName": "Example Store BR",
  "brand": "ExampleBrand",
  "location": "São Paulo",
  "images": [
    "https://cf.shopee.com.br/file/example-image-hash-1",
    "https://cf.shopee.com.br/file/example-image-hash-2"
  ],
  "url": "https://shopee.com.br/product-name-example-i.20000000001.10000000001"
}

Note on prices: Prices are in centavos (BRL cents). Divide by 100 to get the display value in reais (e.g. 20990 → R$ 209.90).

Why the 500 item limit?

The crawler is capped at 500 results per run. Beyond that, Shopee's relevancy ranking degrades significantly — results become loosely related to the keyword or outright unrelated. The first 100–200 results are where the most relevant, highest-quality listings are found. Fetching beyond 500 adds runtime and cost with little practical value.

Example use cases

• Price monitoring — track price changes for specific products over time
• Market research — analyze which products dominate a category
• Competitor analysis — monitor seller listings and pricing strategies
• Inventory tracking — check stock availability across sellers

Limitations

• Requires valid Shopee session cookies (refreshed every ~30 days)
• Shopee may apply bot detection — residential proxy is recommended for high-volume use
• Results are for Shopee Brazil (shopee.com.br) only