Shopee Product Search Crawler

Extract product listings from Shopee by keyword or search URL across multiple regions. 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
• Supports 11 Shopee regions (BR, SG, TH, PH, ID, MY, VN, TW, MX, CO, CL)
• 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
country	String		Shopee region. Default: BR. See supported regions below.

Supported regions

Code	Country
BR	Brazil
SG	Singapore
TH	Thailand
PH	Philippines
ID	Indonesia
MY	Malaysia
VN	Vietnam
TW	Taiwan
MX	Mexico
CO	Colombia
CL	Chile

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.

Output

Each item in the dataset:

{
  "itemId": "10000000001",
  "shopId": "20000000001",
  "name": "Product Name Example - 128GB Blue",
  "price": {
    "raw": 20990000,
    "value": 209.90,
    "formatted": "R$ 209,90"
  },
  "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: price.raw is the value as returned by Shopee's API (micro-units). price.value is the human-readable amount. price.formatted is the locale-aware formatted string (e.g. R$ 209,90 for Brazil, S$15.90 for Singapore).

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

• Results are for the selected Shopee region only — cross-region searches require separate runs

Free trial

This actor includes 10 free trial runs. During the trial, no configuration is needed — just provide a keyword and run.

Each run shows your remaining trial count in the logs:

Free trial: run 3/10 used. 7 free runs remaining after this one.

On your last free run:

This is your last free run. After this, paste your Shopee session cookies into the "cookieHeader" input — see the README for details.

When the trial is exhausted:

Free trial exhausted (10/10 runs used). To keep using this actor, paste your Shopee session cookies into the "cookieHeader" input field.

Continuing after the free trial

Once the trial runs out, you need to provide your own Shopee session cookies. This is free — you just need a Shopee account.

How to get your session cookies

1. Open shopee.com.br in Chrome and log in to your account
2. Open DevTools — press F12 (Windows/Linux) or Cmd+Option+I (Mac)
3. Go to the Network tab and reload the page (F5)
4. Click on any request to shopee.com.br in the list
5. In the Headers panel, scroll to Request Headers and find the cookie header
6. Copy the entire value — it's a long string starting with something like SPC_F=...
7. Paste it into the Session Cookies (cookieHeader) input field

Tip: Cookies expire after approximately 30 days. When they do, the actor will return a session error — just repeat the steps above to refresh them.

Why cookies instead of automatic?

The actor uses cookies to authenticate requests to Shopee on your behalf. Without them, Shopee's bot protection blocks the requests. On a paid Apify plan, the actor handles authentication automatically with no setup required.