Shopee Product Search

1.05 credits/call
ae_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.

Productivity
1.05 credits/call

Pricing

1.05 credits/call
ConditionCharge
Each call1.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.

ParameterTypeRequiredDescriptionDefault
pageintegerNoPage query, max 20 products per page. Defaults to 1 (pages start from 1, not 0).1
siteenum (Unknown | VN | ID | SG | TH | MY | TW | PH | BR)NoShopee site.Unknown
node_idstringNoOptional. If specified: query within a category (not limited to sub-categories).—
shop_typeintegerNoOptional. Shop type: 1 = ordinary store, 2 = preferred store, 3 = flagship store.0
shop_locationintegerNoOptional. Shop location type: 1 = local store, 2 = cross-border store.0
star_range_maxnumberNoOptional. If specified: limit maximum star rating.0
star_range_minnumberNoOptional. If specified: limit minimum star rating.0
price_range_maxnumberNoOptional. If specified: limit maximum selling price (val <= setting value).0
price_range_minnumberNoOptional. If specified: limit minimum selling price (val >= setting value).0
online_date_range_maxstringNoOptional. If specified: limit listing end date (yyyy-MM-dd).—
online_date_range_minstringNoOptional. If specified: limit listing start date (yyyy-MM-dd).—
comment_count_range_maxintegerNoOptional. If specified: limit maximum comment count.0
comment_count_range_minintegerNoOptional. If specified: limit minimum comment count.0
variation_count_range_maxintegerNoOptional. If specified: limit maximum variation count.0
variation_count_range_minintegerNoOptional. If specified: limit minimum variation count.0
month_sale_volume_range_maxintegerNoOptional. If specified: limit maximum monthly sales volume (val <= setting value).0
month_sale_volume_range_minintegerNoOptional. If specified: limit minimum monthly sales volume (val >= setting value).0

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSON
"No relevant data."

Guides using this tool

See how this tool fits into real workflows