# Shopee Search Scraper | Products, Prices & Categories (`genial_candlestand/shopee-product-search-scraper`) Actor

Get Shopee products by keyword, category or shop URL: title, price, original price, discount, rating, seller location, promo labels, image and URL. 9 markets (SG, MY, ID, TH, VN, PH, TW, BR, MX), all sort orders merged, price, rating and ship-from filters. No login.

- **URL**: https://apify.com/genial_candlestand/shopee-product-search-scraper.md
- **Developed by:** [Flowo](https://apify.com/genial_candlestand) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 87.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.82 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Shopee Search Scraper | Products, Prices & Categories

![Shopee Search Scraper | Products, Prices & Categories](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/shopee-com-product-search-category-listings-banner-52d2f691.png)

Get Shopee product listings from category and shop pages in 9 markets: product title, price as a number, original price, discount percent, product rating, seller location, promo labels, image and product URL, plus the item and shop ids. Each row also carries the market and its currency, the category it was found for and the listing order. No login, no cookies, no browser.

### What does Shopee Search Scraper do?

You give it a Shopee category ID or Shopee category and shop URLs. It returns one flat row per unique product for each URL or category. The markets are Singapore, Malaysia, Indonesia, Thailand, Vietnam, Philippines, Taiwan, Brazil and Mexico. Sellers, brands, market researchers and dropshippers use it to track Shopee prices and see what a category offers.

**Market limits (since November 2026):** Shopee no longer serves keyword search to anonymous visitors in any of the 9 markets (closed in SG, MY, ID and PH on 19 November, in TH, TW, VN, BR and MX on 20 November). Category URLs, Category ID and shop URLs work in all 9 markets. Keyword input (Search keywords or a search URL with a keyword) is rejected before any request, so such a run costs nothing.

### How to scrape Shopee products by category or shop

![How Shopee Search Scraper works: Requests Shopee's server-rendered category or shop page; Retries a blocked req](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/shopee-com-product-search-category-listings-how-934eb407.png)

1. Open the actor in Apify Console.
2. Paste Shopee category or shop **Start URLs** (e.g. `https://shopee.sg/Mobile-Gadgets-cat.11013350`), or enter a **Category ID** and choose its **Market**.
3. Optionally set **Max products per URL or category**.
4. Click **Start**. When the run finishes, download the products as JSON, CSV or Excel from the Output tab.

### How much does it cost to scrape Shopee?

Price per event by Apify plan:

| Event | Free | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| Actor start | $0.00005 | $0.00005 | $0.00005 | $0.00005 |
| Product | $4.50 per 1,000 | $4.275 per 1,000 | $4.05 per 1,000 | $3.825 per 1,000 |

A category page gives 24 products per run.

You pay for each **product**: one unique Shopee product saved to the dataset. A URL or category that finds no products costs nothing. There is also a small **Actor start** fee of $0.00005 per run. On the Free plan a product costs $0.0045, so $4.50 per 1,000 products.

| Scenario | Products | Cost on the Free plan |
|---|---|---|
| Default input: 1 category URL (24 products) | 24 | ≈ $0.11 |
| 10 categories × 24 products | 240 | ≈ $1.08 |
| 100 categories × 24 products | 2,400 | ≈ $10.80 |

Costs include the start fee. A category page gives its 24 products, a shop page 3–12.

### Input

![Shopee Search Scraper input example: Start URLs, Market, Max products per URL or category](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/shopee-com-product-search-category-listings-input-20365e53.png)

At least one of **Start URLs** (`startUrls`) or **Category ID** (`categoryId`) is required (`queries` is kept for compatibility but rejected). An empty input is rejected before any request.

| Field | What it does |
|---|---|
| `queries` | No longer served: Shopee closed keyword search to anonymous visitors in every market, so keywords are rejected before any request. Use category or shop URLs or `categoryId`. |
| `country` | Market for the category ID: `sg`, `my`, `id`, `th`, `vn`, `ph`, `tw`, `br`, `mx` (default `sg`). Start URLs ignore this setting, because the URL's site decides the market. |
| `startUrls` | Shopee listing URLs from the 9 markets: a category URL (`…/Mobile-Gadgets-cat.11013350`), a category-scoped search URL without keyword (`…/search?category=11013350`) or a shop URL (`…/shop/487895465`). Keyword search URLs, product pages, Shopee Colombia/Chile, `shopee.com` and other sites are rejected. |
| `categoryId` | Numeric category id of the chosen market (the number after `-cat.` in a category URL; for a subcategory, the last number). Lists that category. |
| `sortBy` | Kept for compatibility, no effect: category and shop pages come in Shopee's own order. |
| `maxItemsPerQuery` | Unique products per URL or category, 1–1000 (default 100). |
| `maxItems` | Optional cap on all products of the run together. |
| `minPrice`, `maxPrice` | Kept for compatibility (they applied to keyword searches). Min must not be higher than max. No effect on category and shop pages. |
| `minRating` | Kept for compatibility (keyword searches only); no effect on category and shop pages. |
| `location` | Kept for compatibility (keyword searches only); no effect on category and shop pages. |
| `proxyConfiguration` | Apify datacenter proxy by default, for category and shop pages; blocked requests are retried through a residential proxy in the market's country. |

Filters and sort are not applied to category and shop pages.

Example: two categories and a shop from different markets:

```json
{
  "startUrls": [
    { "url": "https://shopee.com.br/category-cat.11059983" },
    { "url": "https://shopee.co.th/category-cat.11044959" },
    { "url": "https://shopee.sg/shop/487895465" }
  ]
}
```

### What data can you extract from Shopee?

![Shopee Search Scraper output example: Image, Product, Price, Discount %, Currency, Rating](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/shopee-com-product-search-category-listings-output-6a2946c1.png)

| Field | Description |
|---|---|
| `itemId`, `shopId` | Shopee item id and seller's shop id (digits, as strings) |
| `url` | Product page, `https://<market host>/product/<shopId>/<itemId>` |
| `title` | Product name as shown on the card |
| `imageUrl` | Main product image |
| `price` | Current (promotion) price as a number, thousands separators removed |
| `originalPrice` | Price before the discount, when the card shows it |
| `discountPercent` | Discount shown on the card, in percent |
| `currency` | ISO currency of the market: SGD, MYR, IDR, THB, VND, PHP, TWD, BRL, MXN |
| `rating` | Average product rating 0–5 |
| `shopRating` | Seller's shop rating 0–5, when the card shows it instead of a product rating |
| `soldCount`, `soldText` | Units sold and the raw text, when the card shows it (rare) |
| `location` | Where the seller ships from, as shown on the card (e.g. `SG`, `Mainland China`) |
| `promoLabels` | Promotion labels in the market's language (e.g. `Selling Fast`, `Add-on Deal`, `Free Gift`); empty array when none |
| `country` | Market code: SG, MY, ID, TH, VN, PH, TW, BR, MX |
| `query` | Keyword the product was found for; null for category and shop listings (always null since the keyword search closure) |
| `categoryId` | Category the listing was limited to; null otherwise |
| `sortBy` | `page` for category and shop pages (rows found by keyword search before its closure had `relevancy`, `sales`, `newest`, `priceAsc` or `priceDesc`) |
| `position` | 1-based position on the result page where the product was first found |
| `sourceUrl` | The start URL as given, or the category URL built from a Category ID |
| `scrapedAt` | When the product was extracted (ISO 8601) |

Example row (keyword `fone bluetooth` on shopee.com.br, recorded before Shopee closed keyword search; category rows have `query`, `rating` and `location` null):

```json
{
  "itemId": "58214853079",
  "shopId": "1896459373",
  "url": "https://shopee.com.br/product/1896459373/58214853079",
  "title": "Fone De Ouvido Sem Fio M10 TWS Bluetooth 5.3 display Led Touch",
  "imageUrl": "https://down-br.img.susercontent.com/file/sg-11134201-8259r-mr0fiba8n1mo49",
  "price": 18.99,
  "originalPrice": 70,
  "discountPercent": 73,
  "currency": "BRL",
  "rating": 4.7,
  "shopRating": null,
  "soldCount": null,
  "soldText": null,
  "location": "São Paulo",
  "promoLabels": [],
  "country": "BR",
  "query": "fone bluetooth",
  "categoryId": null,
  "sortBy": "relevancy",
  "position": 1,
  "sourceUrl": "https://shopee.com.br/search?keyword=fone+bluetooth",
  "scrapedAt": "2026-11-19T12:00:00.000Z"
}
```

### Use cases

- **Price checks by category:** see what the products of a Shopee Brazil or Thailand category cost, with discount and original price.
- **Category assortment:** sample a category such as `Sepatu-Flat-cat.11042604.11042610` on shopee.co.id (the 24 products of the category page).
- **Cross-market comparison:** run category URLs from several markets (e.g. shopee.com.br and shopee.com.mx) in one run. Each row carries `country` and `currency`.
- **Shop showcase:** list the products Shopee shows publicly for a shop.

### Limitations

- **No page 2, no sort.** A category page gives its 24 products in Shopee's own order; Shopee rejects page numbers and sort orders. A target stops after 3 requests in a row bring no new products.
- **Shop pages** give only the 3–12 products Shopee shows publicly, without sort or filters.
- **Not on the listing card, so not in the output:** shop name, review count, description, brand, variants and the Mall badge. Sold counts are mostly hidden from anonymous visitors, so `soldCount` and `soldText` are usually null.
- **Fields that can be empty (null):** `imageUrl`, `price`, `originalPrice`, `discountPercent`, `rating`, `shopRating`, `soldCount`, `soldText`, `location`, `query`, `categoryId`. `promoLabels` can be an empty array. `originalPrice` is often missing on SG, PH and MX cards, which show only the discount percent.
- **No keyword search:** Shopee no longer serves it to anonymous visitors in any market; keyword input is rejected before any request. Use category or shop URLs.
- Shopee Colombia and Chile are closed and not supported.

### Tips and troubleshooting

- **More products:** raise `maxItemsPerQuery`. If the log says Shopee's result pool was exhausted, more requests will not add products, so add more categories instead.
- **0 products for a category:** check that the category ID belongs to the chosen `country`. An id from another market returns nothing. Runs with no products are not charged.
- **Several markets at once:** use start URLs, since `country` applies only to the category ID.
- The default datacenter proxy is enough. Blocked requests fall back to a residential proxy in the market's country automatically.

### API, MCP and integrations

Run the actor from your code with the same JSON input as in Console. Your API token is in [Console → Settings → API & Integrations](https://console.apify.com/settings/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("genial_candlestand/shopee-product-search-scraper").call(run_input={
    "startUrls": [{"url": "https://shopee.com.br/category-cat.11059983"}],
    "maxItemsPerQuery": 60,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**Node.js** (`npm install apify-client`):

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('genial_candlestand/shopee-product-search-scraper').call({
    "startUrls": [{"url": "https://shopee.com.br/category-cat.11059983"}],
    "maxItemsPerQuery": 60,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**HTTP** — one request runs the actor and returns the results (runs up to 5 minutes; longer ones: [run asynchronously](https://docs.apify.com/api/v2/act-runs-post)):

```bash
curl -X POST "https://api.apify.com/v2/acts/genial_candlestand~shopee-product-search-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls":[{"url":"https://shopee.com.br/category-cat.11059983"}],"maxItemsPerQuery":60}'
```

**AI agents (MCP).** Add the actor as a tool of the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Claude Code:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=genial_candlestand/shopee-product-search-scraper"
```

Claude Desktop, Cursor or VS Code: `{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=genial_candlestand/shopee-product-search-scraper"}}}`. Then ask, for example:

- "List 100 products from Shopee Brazil category 11059983 with price and discount"
- "List up to 300 products from Shopee Indonesia category 11042610 with prices and discounts"
- "Show the products of Shopee Singapore shop 487895465 with prices"

**Integrations.** Run it on a schedule with [Apify Schedules](https://docs.apify.com/platform/schedules) and send the results to Google Sheets, Slack, Zapier, Make, n8n or your webhook — see [Apify integrations](https://docs.apify.com/platform/integrations).

### FAQ

**Is it legal to scrape Shopee?**<br>
The actor reads only public listing pages that anyone can open without logging in. It does not collect personal data beyond what Shopee shows publicly on product cards. You are responsible for how you use the data and for following the laws and terms that apply to you.

**Do I need a Shopee account, cookies or an API key?**<br>
No. The actor works without login, cookies or a browser.

**Why are prices numbers in every market?**<br>
Formats like `Rp2.775.000` (Indonesia) and `R$19,90` (Brazil) are parsed into 2775000 and 19.9. The currency comes from the market, so `$` on SG, TW and MX becomes SGD, TWD and MXN.

**Does the same product appear twice?**<br>
Within one URL or category, each product appears once. If two inputs list the same product, it appears once for each, with its own `sourceUrl`.

**How is it different from other Shopee scrapers?**<br>
It costs $4.50 per 1,000 products, against $9 for the most used Shopee search actor. It reads category pages in all 9 markets, and rejects keyword input, which Shopee closed, instead of returning nothing. Product rating and shop rating are kept in separate fields.

### Also useful

- [Shopee Product Details Scraper](https://apify.com/genial_candlestand/shopee-product-details-scraper) — add brand, attributes, category path, variations and seller stats for the products you found
- [AliExpress Search Scraper](https://apify.com/genial_candlestand/aliexpress-search-scraper) — compare the same products on AliExpress: prices, sold count and shipping
- [1688 Product Search Scraper](https://apify.com/genial_candlestand/1688-product-search-scraper) — find wholesale prices, MOQ and suppliers on 1688.com for products you sell on Shopee
- [Amazon Search Scraper](https://apify.com/genial_candlestand/amazon-search-scraper) — compare Shopee prices with Amazon search results and rankings
- [Etsy Search Scraper](https://apify.com/genial_candlestand/etsy-search-scraper) — check prices, shops and rankings of similar products on Etsy

# Actor input Schema

## `queries` (type: `array`):

No longer served: since November 2026 Shopee does not serve keyword search to anonymous visitors in any market, so keywords are rejected before the run starts and cost nothing. Use Start URLs (category or shop pages) or a Category ID instead; they work in all 9 markets.

## `country` (type: `string`):

Shopee market for the Category ID. Ignored for Start URLs: the URL's own site decides the market (shopee.co.id → ID). Shopee Colombia and Chile are closed and not offered.

## `startUrls` (type: `array`):

Shopee listing URLs from any of the 9 markets: a category URL (…/Mobile-Gadgets-cat.11013350), a category-scoped search URL without keyword (…/search?category=11013350) or a shop URL (…/shop/487895465; only the 3–12 products Shopee shows publicly). Keyword search URLs (…/search?keyword=…), product pages, shopee.com and other sites are rejected before the run starts.

## `categoryId` (type: `string`):

Numeric Shopee category id of the chosen Market: the number after -cat. in a category URL (e.g. 11013350; for a subcategory the last number). Lists that category's page.

## `sortBy` (type: `string`):

Kept for compatibility: Shopee no longer serves keyword search, and category and shop pages come in Shopee's own order, so this setting has no effect.

## `maxItemsPerQuery` (type: `integer`):

Stop each Start URL or category after this many unique products (1–1000). A category page shows 24 products and a shop page 3–12, so the run reports when a page is exhausted earlier.

## `maxItems` (type: `integer`):

Optional cap on all products of the run together. Empty = no total cap.

## `minPrice` (type: `number`):

Only products from this price, in the market's currency units (e.g. 20 for R$20, 100000 for ₫100.000). Applied only to keyword searches, which Shopee no longer serves: no effect on category and shop pages.

## `maxPrice` (type: `number`):

Only products up to this price, in the market's currency units. Must not be lower than Min price. Applied only to keyword searches, which Shopee no longer serves: no effect on category and shop pages.

## `minRating` (type: `integer`):

Only products rated at least 3, 4 or 5 stars (5 = only 5.0). Applied only to keyword searches, which Shopee no longer serves: no effect on category and shop pages.

## `location` (type: `string`):

Only sellers shipping from this place, written exactly as in the market's Shopee Shipped From filter, e.g. São Paulo on shopee.com.br, Extranjero on shopee.com.mx. An unknown name returns no products. Applied only to keyword searches, which Shopee no longer serves: no effect on category and shop pages.

## `proxyConfiguration` (type: `object`):

Used for category and shop pages: Apify datacenter proxy works for all markets (default); blocked requests are retried through residential proxy of the market's country.

## Actor input object example

```json
{
  "country": "sg",
  "startUrls": [
    {
      "url": "https://shopee.sg/Mobile-Gadgets-cat.11013350"
    }
  ],
  "sortBy": "auto",
  "maxItemsPerQuery": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with one row per unique product per URL or category

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "country": "sg",
    "startUrls": [
        {
            "url": "https://shopee.sg/Mobile-Gadgets-cat.11013350"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("genial_candlestand/shopee-product-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "country": "sg",
    "startUrls": [{ "url": "https://shopee.sg/Mobile-Gadgets-cat.11013350" }],
}

# Run the Actor and wait for it to finish
run = client.actor("genial_candlestand/shopee-product-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "country": "sg",
  "startUrls": [
    {
      "url": "https://shopee.sg/Mobile-Gadgets-cat.11013350"
    }
  ]
}' |
apify call genial_candlestand/shopee-product-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,genial_candlestand/shopee-product-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/1IOYA62ibipbU5guv/builds/H7mBKD4YQhygDc5th/openapi.json
