TikTok Product Search

1.05积分/次
ae_tiktok_product_search

查询 TikTok 电商商品数据,用于选品和市场研究。可按站点、品牌、类目及其子类目、卖家 ID 或名称、店铺类型、本地或海外发货进行筛选;也可设置售价、星级评分、评论数、曝光日期、变体数、周销量、月销量、推广视频数和带货达人数的上下限,边界值包含在筛选范围内。站点选项为 US、MY、PH、VN、TH、ID、GB、JP 及默认值 Unknow。所有输入均为可选项,页码从 1 开始,每页最多 20 件商品;曝光日期使用 yyyy-MM-dd 格式。供应方未定义具体返回字段。

社交
1.05积分/次

价格说明

1.05积分/次
条件费用
每次调用1.05积分/次

每次调用固定收取1.05积分。

按调用次数收费,筛选条件及实际返回的商品数量不影响每次调用的固定费用。

API 调用

通过统一工具网关发起同步请求,鉴权和计费由 AgentEarth 处理。

cURL
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": {}
}'
请求方式
POST
接口地址
/agent-api/v1/tool/execute
鉴权方式
X-Api-Key
超时时间
60 秒
响应示例
{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
pageinteger否Pagination, 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)否TikTok site.Unknow
brandstring否Optional. If specified: query best-selling products of the brand. Example: Anker.—
node_idstring否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_maxnumber否Optional. If specified: filter products whose star rating is less than or equal to this value. Example: 4.8.0
star_minnumber否Optional. If specified: filter products whose star rating is greater than or equal to this value. Example: 4.0.0
price_maxnumber否Optional. If specified: filter products whose selling price is less than or equal to this value. Example: 50.00.0
price_minnumber否Optional. If specified: filter products whose selling price is greater than or equal to this value. Example: 20.00.0
seller_idstring否Optional. If specified: query best-selling products by seller ID.—
shop_typeinteger否Shop type: 1=Gold-star seller, 2=Silver-star seller, 3=official store, 4=regular seller.0
seller_namestring否Optional. If specified: query best-selling products by seller name.—
ship_locationinteger否Shipping origin: 1=local, 2=overseas.0
review_count_maxinteger否Optional. If specified: filter products whose review count is less than or equal to this value. Example: 500.0
review_count_mininteger否Optional. If specified: filter products whose review count is greater than or equal to this value. Example: 50.0
exposure_time_maxstring否Optional. If specified: filter products whose exposure time is on or before this date, format yyyy-MM-dd. Example: 2026-01-01.—
exposure_time_minstring否Optional. If specified: filter products whose exposure time is on or after this date, format yyyy-MM-dd. Example: 2025-01-01.—
variation_count_maxinteger否Optional. If specified: filter products whose variation count is less than or equal to this value. Example: 10.0
variation_count_mininteger否Optional. If specified: filter products whose variation count is greater than or equal to this value. Example: 1.0
month_sale_count_maxinteger否Optional. If specified: filter products whose monthly sales count is less than or equal to this value. Example: 1000.0
month_sale_count_mininteger否Optional. If specified: filter products whose monthly sales count is greater than or equal to this value. Example: 500.0
video_count_count_maxinteger否Optional. If specified: filter products whose promo video count is less than or equal to this value. Example: 10.0
video_count_count_mininteger否Optional. If specified: filter products whose promo video count is greater than or equal to this value. Example: 1.0
weekly_sale_count_maxinteger否Optional. If specified: filter products whose weekly sales count is less than or equal to this value. Example: 1000.0
weekly_sale_count_mininteger否Optional. If specified: filter products whose weekly sales count is greater than or equal to this value. Example: 500.0
author_count_count_maxinteger否Optional. If specified: filter products whose affiliate creator count is less than or equal to this value. Example: 10.0
author_count_count_mininteger否Optional. If specified: filter products whose affiliate creator count is greater than or equal to this value. Example: 1.0

使用该工具的指南

看看真实工作流里怎么用这个工具