TikTok Product Search

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

Social
1 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
pageintegerNoPagination, up to 20 products 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
brandstringNoOptional. If specified: query best-selling products of the brand. Example: Anker.—
node_idstringNoOptional. 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_maxnumberNoOptional. If specified: filter products whose star rating is less than or equal to this value. Example: 4.8.0
star_minnumberNoOptional. If specified: filter products whose star rating is greater than or equal to this value. Example: 4.0.0
price_maxnumberNoOptional. If specified: filter products whose selling price is less than or equal to this value. Example: 50.00.0
price_minnumberNoOptional. If specified: filter products whose selling price is greater than or equal to this value. Example: 20.00.0
seller_idstringNoOptional. If specified: query best-selling products by seller ID.—
shop_typeintegerNoShop type: 1=Gold-star seller, 2=Silver-star seller, 3=official store, 4=regular seller.0
seller_namestringNoOptional. If specified: query best-selling products by seller name.—
ship_locationintegerNoShipping origin: 1=local, 2=overseas.0
review_count_maxintegerNoOptional. If specified: filter products whose review count is less than or equal to this value. Example: 500.0
review_count_minintegerNoOptional. If specified: filter products whose review count is greater than or equal to this value. Example: 50.0
exposure_time_maxstringNoOptional. If specified: filter products whose exposure time is on or before this date, format yyyy-MM-dd. Example: 2026-01-01.—
exposure_time_minstringNoOptional. If specified: filter products whose exposure time is on or after this date, format yyyy-MM-dd. Example: 2025-01-01.—
variation_count_maxintegerNoOptional. If specified: filter products whose variation count is less than or equal to this value. Example: 10.0
variation_count_minintegerNoOptional. If specified: filter products whose variation count is greater than or equal to this value. Example: 1.0
month_sale_count_maxintegerNoOptional. If specified: filter products whose monthly sales count is less than or equal to this value. Example: 1000.0
month_sale_count_minintegerNoOptional. If specified: filter products whose monthly sales count is greater than or equal to this value. Example: 500.0
video_count_count_maxintegerNoOptional. If specified: filter products whose promo video count is less than or equal to this value. Example: 10.0
video_count_count_minintegerNoOptional. If specified: filter products whose promo video count is greater than or equal to this value. Example: 1.0
weekly_sale_count_maxintegerNoOptional. If specified: filter products whose weekly sales count is less than or equal to this value. Example: 1000.0
weekly_sale_count_minintegerNoOptional. If specified: filter products whose weekly sales count is greater than or equal to this value. Example: 500.0
author_count_count_maxintegerNoOptional. If specified: filter products whose affiliate creator count is less than or equal to this value. Example: 10.0
author_count_count_minintegerNoOptional. 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.

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_product_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "brand": "OPTION",
    "page": 1,
    "site": "TH"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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