TikTok Product Search
Search TikTok e-commerce product data for product discovery and market research. Filter by site, brand, category and its subcategories, seller ID or name, shop type, and local or overseas shipping origin. Optional inclusive ranges cover selling price, star rating, review count, exposure date, variation count, weekly and monthly sales, promotional video count, and affiliate creator count. Site options are US, MY, PH, VN, TH, ID, GB, JP, and the default value Unknow. All inputs are optional; page numbering starts at 1, with up to 20 products per page. Exposure dates use yyyy-MM-dd. Result fields are not specified by the provider.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Each call is charged 1 AE credits.
Billing is per call. Filters and the actual number of products returned do not affect the fixed charge per call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Pagination, up to 20 products per page. Defaults to page 1 (page index starts from 1, not 0). | 1 |
site | enum (Unknow | US | MY | PH | VN | TH | ID | GB | JP) | No | TikTok site. | Unknow |
brand | string | No | Optional. If specified: query best-selling products of the brand. Example: Anker. | — |
node_id | string | No | Optional. If specified: limit the search scope to the specified category and its sub-categories (the specified nodeId is not limited to leaf categories). Example: 601281. | — |
star_max | number | No | Optional. If specified: filter products whose star rating is less than or equal to this value. Example: 4.8. | 0 |
star_min | number | No | Optional. If specified: filter products whose star rating is greater than or equal to this value. Example: 4.0. | 0 |
price_max | number | No | Optional. If specified: filter products whose selling price is less than or equal to this value. Example: 50.00. | 0 |
price_min | number | No | Optional. If specified: filter products whose selling price is greater than or equal to this value. Example: 20.00. | 0 |
seller_id | string | No | Optional. If specified: query best-selling products by seller ID. | — |
shop_type | integer | No | Shop type: 1=Gold-star seller, 2=Silver-star seller, 3=official store, 4=regular seller. | 0 |
seller_name | string | No | Optional. If specified: query best-selling products by seller name. | — |
ship_location | integer | No | Shipping origin: 1=local, 2=overseas. | 0 |
review_count_max | integer | No | Optional. If specified: filter products whose review count is less than or equal to this value. Example: 500. | 0 |
review_count_min | integer | No | Optional. If specified: filter products whose review count is greater than or equal to this value. Example: 50. | 0 |
exposure_time_max | string | No | Optional. If specified: filter products whose exposure time is on or before this date, format yyyy-MM-dd. Example: 2026-01-01. | — |
exposure_time_min | string | No | Optional. If specified: filter products whose exposure time is on or after this date, format yyyy-MM-dd. Example: 2025-01-01. | — |
variation_count_max | integer | No | Optional. If specified: filter products whose variation count is less than or equal to this value. Example: 10. | 0 |
variation_count_min | integer | No | Optional. If specified: filter products whose variation count is greater than or equal to this value. Example: 1. | 0 |
month_sale_count_max | integer | No | Optional. If specified: filter products whose monthly sales count is less than or equal to this value. Example: 1000. | 0 |
month_sale_count_min | integer | No | Optional. If specified: filter products whose monthly sales count is greater than or equal to this value. Example: 500. | 0 |
video_count_count_max | integer | No | Optional. If specified: filter products whose promo video count is less than or equal to this value. Example: 10. | 0 |
video_count_count_min | integer | No | Optional. If specified: filter products whose promo video count is greater than or equal to this value. Example: 1. | 0 |
weekly_sale_count_max | integer | No | Optional. If specified: filter products whose weekly sales count is less than or equal to this value. Example: 1000. | 0 |
weekly_sale_count_min | integer | No | Optional. If specified: filter products whose weekly sales count is greater than or equal to this value. Example: 500. | 0 |
author_count_count_max | integer | No | Optional. If specified: filter products whose affiliate creator count is less than or equal to this value. Example: 10. | 0 |
author_count_count_min | integer | No | Optional. If specified: filter products whose affiliate creator count is greater than or equal to this value. Example: 1. | 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_tiktok_product_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"brand": "OPTION",
"page": 1,
"site": "TH"
}
}'{
"data": [
{
"author_count": 0,
"brand_name": "Option",
"category": {
"name": "Beauty & Personal Care",
"node_id": "601450"
},
"cumulative_sale_count": 193837,
"exposure_time": "2026-07-22",
"is_free_shipping": false
}
],
"doc": {
"author_count": "Number of affiliate creators (US site only).",
"brand_name": "Brand name; returns an empty string when unavailable.",
"category": "Top-level category of the product, as a JSON object.",
"category.Name": "Top-level category name.",
"category.NodeId": "Top-level category nodeId.",
"cumulative_sale_count": "Cumulative sales count."
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

