### How to scrape Shopee products
Try 20 mechanical keyboard listings from Brazil, with full product details enabled for variant prices, stock and specifications.
```json
{
"searchTerms": [
"teclado mecanico"
],
"region": "BR",
"maxItems": 20,
"includeEnrichment": true
}
```
Open actor input to choose your keywords and market.
Full product details are a separately billed add-on, available for Brazil and Indonesia. Other markets return the base listing data. The 142-field structure includes optional fields; values depend on the product, market and available promotions. A single keyword returns up to a few hundred products; add keywords for larger collections, up to 5,000 unique products per run.
| Zen Studio · Shopee & Lazada | ||||
 Shopee SearchYou are here |  Shopee DetailFull details from product URLs |  Shopee ReviewsBuyer feedback and seller replies |  Shopee LiveLive-only prices, on air |  Lazada ProductsProduct data across Southeast Asia |
| Event | Price per 1,000 | Charged when |
|---|---|---|
result |
$4.99 | Once per delivered product, base record |
enrichment |
$2.99 add-on | Only when enrichment fields are successfully returned |
iphone 15, running shoes
## `startUrls` (type: `array`):
Paste Shopee search or shop page URLs. Sorting and filtering are controlled by the fields below, not by parameters inside a pasted URL. Single-product URLs are not supported here — use the Shopee Product Detail Scraper for those.
## `shopId` (type: `integer`):
Scrape all products from one shop by its numeric shop ID.
## `region` (type: `string`):
Which Shopee market to scrape. Prices are returned in the market's local currency.
## `maxItems` (type: `integer`):
Maximum unique products to collect — total across all your search terms combined (de-duplicated), shared between them, and per shop. A single search term returns up to a few hundred products, so add more terms for larger runs.
## `sort` (type: `string`):
How to rank results within each context. Relevance and the price sorts reach the most products per search term; Best selling returns about 20 per term and Newest fewer than Relevance, so for a large run pick Relevance or add more search terms. Best selling is ranked by sales by Shopee itself; the units-sold numbers behind it are only reported with full product details.
## `includeEnrichment` (type: `boolean`):
Adds full product description, specifications, brand, category breadcrumb path, units sold, the item-level stock count, and a per-variant breakdown (price + stock per SKU). Products with enrichment are billed at an additional per-product rate.stockStatus says so on each row.
## `priceMin` (type: `integer`):
Keep only products priced at or above this value, in the region's local currency (e.g. SGD, IDR, BRL).
## `priceMax` (type: `integer`):
Keep only products priced at or below this value, in the region's local currency.
## `minRating` (type: `integer`):
Keep only products rated at or above this many stars (1–5).
## `minSold` (type: `integer`):
Keep only products with at least this many total units sold. Shopee reports units sold only with full product details (Brazil and Indonesia, with the enrichment add-on on); without it no product carries a figure to compare, so this filter keeps nothing and the run tells you so.
## `condition` (type: `string`):
Restrict to new or used items.
## `discountedOnly` (type: `boolean`):
Only products that currently have a discount.
## `freeShippingOnly` (type: `boolean`):
Only products eligible for free shipping.
## `officialShopOnly` (type: `boolean`):
Only products from Shopee Mall official brand stores.
## `preferredSellerOnly` (type: `boolean`):
Only products from Preferred / Star sellers.
## `codAvailableOnly` (type: `boolean`):
Only products that support Cash on Delivery.
## `wholesaleOnly` (type: `boolean`):
Only products offering wholesale (bulk) pricing.
## `authenticOnly` (type: `boolean`):
Only products flagged 100% original / authentic.
## `withVideoOnly` (type: `boolean`):
Only products that include a product video.
## `shippedFrom` (type: `string`):
Restrict to items shipped from a location (e.g. a city or state as shown in Shopee's "Shipped From" filter). Leave blank for all locations.
## `brand` (type: `string`):
Restrict to a brand name (as shown in Shopee's brand filter for the category). Leave blank for all brands.
## `language` (type: `string`):
Optional locale code for result text (e.g. en, zh-TW). Defaults to the region's primary language.
## `feedback` (type: `string`):
For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.
## Actor input object example
```json
{
"searchTerms": [
"iphone 15"
],
"region": "SG",
"maxItems": 100,
"sort": "relevance",
"includeEnrichment": false,
"condition": "any",
"discountedOnly": false,
"freeShippingOnly": false,
"officialShopOnly": false,
"preferredSellerOnly": false,
"codAvailableOnly": false,
"wholesaleOnly": false,
"authenticOnly": false,
"withVideoOnly": false
}
```
# Actor output Schema
## `results` (type: `string`):
Dataset of products — one row per unique Shopee product, de-duplicated across all queries in the run.
# 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 '