TikTok Shop Search
Search TikTok Shop sellers with multiple optional filters for seller discovery and comparison. Filter by site, category, shop type, rating, followers, reviews, seller product count, cumulative sales count, and Top-300 product performance. Supported site values are Unknow (default), US, MY, PH, VN, TH, ID, GB, and JP. Category IDs may identify non-leaf categories. Shop types are 1 = Gold Star Seller, 2 = Silver Star Seller, 3 = Official Shop, and 4 = Regular Seller. Minimum and maximum filters are inclusive. Top-300 product count means products ranked in leaf-category Top-300 and differs from the seller's product count. Weekly and monthly sales counts and amounts filter the seller's Top-300 products, not necessarily the entire shop. Page numbering starts at 1, defaults to 1, and supports up to 20 sellers per page. The returned content follows the provider response; a structured output schema is not specified.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
For paginated searches, each call is charged separately.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Pagination, up to 20 sellers 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 |
node_id | string | No | Optional. If specified: query sellers by category (not limited to leaf categories). Example: 601281. | — |
star_max | number | No | Optional. If specified: filter sellers whose rating is less than or equal to this value (val <= setting value). Example: 4.9. | 0 |
star_min | number | No | Optional. If specified: filter sellers whose rating is greater than or equal to this value (val >= setting value). Example: 4.0. | 0 |
shop_type | integer | No | Optional. If specified: Shop type: 1 = Gold Star Seller, 2 = Silver Star Seller, 3 = Official Shop, 4 = Regular Seller. | 0 |
fans_count_max | integer | No | Optional. If specified: filter sellers whose follower count is less than or equal to this value (val <= setting value). Example: 1000000. | 0 |
fans_count_min | integer | No | Optional. If specified: filter sellers whose follower count is greater than or equal to this value (val >= setting value). Example: 1000. | 0 |
product_count_max | integer | No | Optional. If specified: maximum number of the seller's products ranked in leaf-category Top-300 (val <= setting value). Example: 50. | 0 |
product_count_min | integer | No | Optional. If specified: minimum number of the seller's products ranked in leaf-category Top-300 (val >= setting value). Example: 1. | 0 |
weekly_sale_count_max | integer | No | Optional. If specified: maximum weekly sales count of the seller's Top-300 products (val <= setting value). Example: 10000. | 0 |
weekly_sale_count_min | integer | No | Optional. If specified: minimum weekly sales count of the seller's Top-300 products (val >= setting value). Example: 100. | 0 |
monthly_sale_count_max | integer | No | Optional. If specified: maximum monthly sales count of the seller's Top-300 products (val <= setting value). Example: 50000. | 0 |
monthly_sale_count_min | integer | No | Optional. If specified: minimum monthly sales count of the seller's Top-300 products (val >= setting value). Example: 500. | 0 |
weekly_sale_amount_max | number | No | Optional. If specified: maximum weekly sales amount of the seller's Top-300 products (val <= setting value). Example: 100000.00. | 0 |
weekly_sale_amount_min | number | No | Optional. If specified: minimum weekly sales amount of the seller's Top-300 products (val >= setting value). Example: 1000.00. | 0 |
monthly_sale_amount_max | number | No | Optional. If specified: maximum monthly sales amount of the seller's Top-300 products (val <= setting value). Example: 500000.00. | 0 |
monthly_sale_amount_min | number | No | Optional. If specified: minimum monthly sales amount of the seller's Top-300 products (val >= setting value). Example: 5000.00. | 0 |
seller_review_count_max | integer | No | Optional. If specified: filter sellers whose review count is less than or equal to this value (val <= setting value). Example: 10000. | 0 |
seller_review_count_min | integer | No | Optional. If specified: filter sellers whose review count is greater than or equal to this value (val >= setting value). Example: 100. | 0 |
seller_product_count_max | integer | No | Optional. If specified: filter sellers whose product count is less than or equal to this value (val <= setting value). Example: 1000. | 0 |
seller_product_count_min | integer | No | Optional. If specified: filter sellers whose product count is greater than or equal to this value (val >= setting value). Example: 10. | 0 |
seller_cumulative_sale_count_max | integer | No | Optional. If specified: filter sellers whose cumulative sales count is less than or equal to this value (val <= setting value). Example: 500000. | 0 |
seller_cumulative_sale_count_min | integer | No | Optional. If specified: filter sellers whose cumulative sales count is greater than or equal to this value (val >= setting value). Example: 5000. | 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_shop_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"monthly_sale_amount_min": 15000,
"node_id": "601374",
"page": 1,
"site": "MY"
}
}'"No data available."
