TikTok Shop Search

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

Social
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

For paginated searches, each call is charged separately.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNoPagination, up to 20 sellers per page. Defaults to page 1 (page index starts from 1, not 0).1
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
node_idstringNoOptional. If specified: query sellers by category (not limited to leaf categories). Example: 601281.—
star_maxnumberNoOptional. If specified: filter sellers whose rating is less than or equal to this value (val <= setting value). Example: 4.9.0
star_minnumberNoOptional. If specified: filter sellers whose rating is greater than or equal to this value (val >= setting value). Example: 4.0.0
shop_typeintegerNoOptional. If specified: Shop type: 1 = Gold Star Seller, 2 = Silver Star Seller, 3 = Official Shop, 4 = Regular Seller.0
fans_count_maxintegerNoOptional. If specified: filter sellers whose follower count is less than or equal to this value (val <= setting value). Example: 1000000.0
fans_count_minintegerNoOptional. If specified: filter sellers whose follower count is greater than or equal to this value (val >= setting value). Example: 1000.0
product_count_maxintegerNoOptional. If specified: maximum number of the seller's products ranked in leaf-category Top-300 (val <= setting value). Example: 50.0
product_count_minintegerNoOptional. If specified: minimum number of the seller's products ranked in leaf-category Top-300 (val >= setting value). Example: 1.0
weekly_sale_count_maxintegerNoOptional. If specified: maximum weekly sales count of the seller's Top-300 products (val <= setting value). Example: 10000.0
weekly_sale_count_minintegerNoOptional. If specified: minimum weekly sales count of the seller's Top-300 products (val >= setting value). Example: 100.0
monthly_sale_count_maxintegerNoOptional. If specified: maximum monthly sales count of the seller's Top-300 products (val <= setting value). Example: 50000.0
monthly_sale_count_minintegerNoOptional. If specified: minimum monthly sales count of the seller's Top-300 products (val >= setting value). Example: 500.0
weekly_sale_amount_maxnumberNoOptional. If specified: maximum weekly sales amount of the seller's Top-300 products (val <= setting value). Example: 100000.00.0
weekly_sale_amount_minnumberNoOptional. If specified: minimum weekly sales amount of the seller's Top-300 products (val >= setting value). Example: 1000.00.0
monthly_sale_amount_maxnumberNoOptional. If specified: maximum monthly sales amount of the seller's Top-300 products (val <= setting value). Example: 500000.00.0
monthly_sale_amount_minnumberNoOptional. If specified: minimum monthly sales amount of the seller's Top-300 products (val >= setting value). Example: 5000.00.0
seller_review_count_maxintegerNoOptional. If specified: filter sellers whose review count is less than or equal to this value (val <= setting value). Example: 10000.0
seller_review_count_minintegerNoOptional. If specified: filter sellers whose review count is greater than or equal to this value (val >= setting value). Example: 100.0
seller_product_count_maxintegerNoOptional. If specified: filter sellers whose product count is less than or equal to this value (val <= setting value). Example: 1000.0
seller_product_count_minintegerNoOptional. 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_maxintegerNoOptional. 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_minintegerNoOptional. 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.

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_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"
  }
}'
Response exampleresponse.json
JSON
"No data available."