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"
  }
}

工具参数

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

参数类型必填说明默认值
offsetinteger否偏移量/Offset0
regionstring否地区代码/Region code: US, SG, MY, PH, TH, VN, ID, JP, MX。GB 和 BR 暂不支持 / GB and BR are unavailable.US
page_tokenstring否分页标记/Page token""
search_wordstring是搜索关键词/Search keyword—