TikTok Shop Fetch Search Products List
2.07积分/次
ae_tiktok_shop_fetch_search_products_list
按关键词搜索指定地区的商品。 参数: - search_word(必填):搜索关键词。 - region(可选,默认 US):支持 US、SG、MY、PH、TH、VN、ID、JP、MX;不支持 GB 和 BR。 - offset(可选,默认 0):分页偏移量;首次请求使用默认值。 - page_token(可选,默认为空):分页标记;首次请求留空。 返回结果: - 商品列表位于 data.data.products。商品字段以实际响应为准;image 和 seo_url 为对象。 - data.data.has_more 表示是否还有更多结果。 - 请求下一页时,原样使用 data.data.load_more_params 中的 offset 和 page_token,并保持 search_word、region 不变。每页数量可能变化,请勿根据返回商品数量自行计算 offset。
2.07积分/次
价格说明
2.07积分/次
| 条件 | 费用 |
|---|---|
| 每次调用 | 2.07积分/次 |
每次固定费用为2.07积分。 按查询次数计费。查询成功但未返回结果时,也会扣除积分。
分页获取下一页需再次调用,每次调用单独计费。
API 调用
通过统一工具网关发起同步请求,鉴权和计费由 AgentEarth 处理。
cURL
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_shop_fetch_search_products_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"search_word": "xxx"
}
}'- 请求方式
- 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"
}
}工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
offset | integer | 否 | 偏移量/Offset | 0 |
region | string | 否 | 地区代码/Region code: US, SG, MY, PH, TH, VN, ID, JP, MX。GB 和 BR 暂不支持 / GB and BR are unavailable. | US |
page_token | string | 否 | 分页标记/Page token | "" |
search_word | string | 是 | 搜索关键词/Search keyword | — |

