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"
}
}工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
page | integer | 否 | 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) | 否 | TikTok site. | Unknow |
brand | string | 否 | Optional. If specified: query best-selling products of the brand. Example: Anker. | — |
node_id | string | 否 | 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 | 否 | Optional. If specified: filter products whose star rating is less than or equal to this value. Example: 4.8. | 0 |
star_min | number | 否 | Optional. If specified: filter products whose star rating is greater than or equal to this value. Example: 4.0. | 0 |
price_max | number | 否 | Optional. If specified: filter products whose selling price is less than or equal to this value. Example: 50.00. | 0 |
price_min | number | 否 | Optional. If specified: filter products whose selling price is greater than or equal to this value. Example: 20.00. | 0 |
seller_id | string | 否 | Optional. If specified: query best-selling products by seller ID. | — |
shop_type | integer | 否 | Shop type: 1=Gold-star seller, 2=Silver-star seller, 3=official store, 4=regular seller. | 0 |
seller_name | string | 否 | Optional. If specified: query best-selling products by seller name. | — |
ship_location | integer | 否 | Shipping origin: 1=local, 2=overseas. | 0 |
review_count_max | integer | 否 | Optional. If specified: filter products whose review count is less than or equal to this value. Example: 500. | 0 |
review_count_min | integer | 否 | Optional. If specified: filter products whose review count is greater than or equal to this value. Example: 50. | 0 |
exposure_time_max | string | 否 | 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 | 否 | 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 | 否 | Optional. If specified: filter products whose variation count is less than or equal to this value. Example: 10. | 0 |
variation_count_min | integer | 否 | Optional. If specified: filter products whose variation count is greater than or equal to this value. Example: 1. | 0 |
month_sale_count_max | integer | 否 | 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 | 否 | 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 | 否 | 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 | 否 | 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 | 否 | 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 | 否 | 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 | 否 | 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 | 否 | Optional. If specified: filter products whose affiliate creator count is greater than or equal to this value. Example: 1. | 0 |
使用该工具的指南
看看真实工作流里怎么用这个工具

