Shopee Product Search
Search Shopee product data for product research and shortlisting, sorted by monthly sales volume from highest to lowest. Filter by site (VN, ID, SG, TH, MY, TW, PH, or BR; the default is Unknown), category, shop type, and local or cross-border shops. Optional minimum and maximum filters cover star rating, selling price, comment count, variation count, monthly sales volume, and listing date. Dates use yyyy-MM-dd. Category searches are not limited to subcategories. Shop types are 1 = ordinary, 2 = preferred, and 3 = flagship; shop locations are 1 = local and 2 = cross-border. Pagination starts at page 1, the default, with up to 20 products per page. Keyword search and custom sorting are not supported by this input contract. Returned fields are not specified by the provider.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.05 credits/call |
Each call has a fixed fee of 1.05 credits.
Retrieving another page requires a separate call, charged at the same per-call rate.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Page query, max 20 products per page. Defaults to 1 (pages start from 1, not 0). | 1 |
site | enum (Unknown | VN | ID | SG | TH | MY | TW | PH | BR) | No | Shopee site. | Unknown |
node_id | string | No | Optional. If specified: query within a category (not limited to sub-categories). | — |
shop_type | integer | No | Optional. Shop type: 1 = ordinary store, 2 = preferred store, 3 = flagship store. | 0 |
shop_location | integer | No | Optional. Shop location type: 1 = local store, 2 = cross-border store. | 0 |
star_range_max | number | No | Optional. If specified: limit maximum star rating. | 0 |
star_range_min | number | No | Optional. If specified: limit minimum star rating. | 0 |
price_range_max | number | No | Optional. If specified: limit maximum selling price (val <= setting value). | 0 |
price_range_min | number | No | Optional. If specified: limit minimum selling price (val >= setting value). | 0 |
online_date_range_max | string | No | Optional. If specified: limit listing end date (yyyy-MM-dd). | — |
online_date_range_min | string | No | Optional. If specified: limit listing start date (yyyy-MM-dd). | — |
comment_count_range_max | integer | No | Optional. If specified: limit maximum comment count. | 0 |
comment_count_range_min | integer | No | Optional. If specified: limit minimum comment count. | 0 |
variation_count_range_max | integer | No | Optional. If specified: limit maximum variation count. | 0 |
variation_count_range_min | integer | No | Optional. If specified: limit minimum variation count. | 0 |
month_sale_volume_range_max | integer | No | Optional. If specified: limit maximum monthly sales volume (val <= setting value). | 0 |
month_sale_volume_range_min | integer | No | Optional. If specified: limit minimum monthly sales volume (val >= setting value). | 0 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_shopee_product_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"node_id": "11041088",
"price_range_max": 450,
"price_range_min": 250,
"site": "TW"
}
}'"No relevant data."Guides using this tool
See how this tool fits into real workflows

