抖音直播商品搜索 API

Q: 一次能拿到几条商品，想多看怎么办？

默认和上限都是 3 条。要看更多商品，就拿几个不同的商品词分别搜一次，汇总时靠 source_keyword 认出每一行是哪个词带出来的，再按 product_id 去掉重复的商品。

Q: is_live_product 为真能说明某个达人带过这个商品吗？

不能。它只表示这一行是当前直播商品搜索明确返回的，不是历史直播归因；keyword 是商品关键词，也不是按达人查询。

Q: product_id 和 sku_id 用哪个做标识？

按商品汇总用 product_id，它是抖音商城商品的稳定 ID；sku_id 是 SKU 的 ID，与 product_id 不是同一个标识，要精确到规格时才用。店铺用 shop_id 区分。

POST

接口健康状态

24h 健康值: 少量可用

健康 / 正常
可用
少量可用
基本不可用

少量可用

24 小时趋势

30 天趋势

直播商品搜索：返回列表，默认 3 条、单次最多 3 条；主要字段 product_id、sku_id、title、image_url、price_cny、shop_id。

请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 douyin，action 填 live_product_search。单价 $0.56 / 千次（每次 $0.000556），失败和空结果都不收费。同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。

抖音直播商品搜索按 keyword 在抖音商城里找商品，只返回采集时带 live 标记和直播间 ID 的那些，默认和单次上限都是 3 条。每行带 product_id、sku_id、title、image_url、以人民币元计的 price_cny、shop_id，以及挂载它的直播间 live_room_id。它回答「这个品类的商品当前有哪些挂在直播间里」，适合品类选品。

live_room_id 只表示采集时那一刻挂载该商品的直播间；is_live_product 表示这行是当前直播商品搜索明确返回的，不是历史直播归因，所以不能用它回答「某位达人以前带过什么货」。source_keyword 记录这一行命中的搜索词。

AI 提示词

请帮我用 EveryInfra 的「抖音直播商品搜索」接口（douyin/live_product_search）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 douyin，action 填 live_product_search，参数放在 params 里。
- 必填参数：
  - keyword：抖音商城商品关键词；只返回采集时带 live 标记和直播间 ID 的商品，不代表指定达人的历史带货记录。
- 可选参数：
  - limit：这次调用最多返回的条数，整数，1–3；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。（默认 3）
- 返回一组记录，每条记录的主要字段：product_id（抖音商城商品稳定 ID）、sku_id（抖音商城 SKU ID）、title、image_url、price_cny（商品展示价格）、shop_id（抖音商城店铺 ID）、live_room_id（采集时挂载该商品的直播间 ID）、is_live_product（是否由当前直播商品搜索明确返回）、source_keyword（本行命中的搜索关键词）。
- 示例请求体：
{
  "platform": "douyin",
  "action": "live_product_search",
  "params": {
    "keyword": "美食"
  }
}
- 计费：$0.56 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "mode": "async"：先拿到 job_id，再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。

写代码前，先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式，再把方案和大概花费讲给我确认。

请求参数

参数名	位置	类型	必填	默认值	说明
`Authorization`	header	`string`	是	-	Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。
`platform`	body	`string`	是	`douyin`	平台标识，固定值。
`action`	body	`string`	是	`live_product_search`	能力标识，固定值。
`keyword`	body.params	`string`	是	-	抖音商城商品关键词；只返回采集时带 live 标记和直播间 ID 的商品，不代表指定达人的历史带货记录。
`limit`	body.params	`integer (1–3)`	否	`3`	这次调用最多返回的条数，整数，1–3；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。

代码示例

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "live_product_search",
  "params": {
    "keyword": "美食"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。

响应示例

json

{  "id": "req_…",  "platform": "douyin",  "action": "live_product_search",  "results": [    {      "product_id": "3758214740665565640",      "sku_id": "3614004672311810",      "title": "法丽兹巧克力夹心曲奇抹茶饼干盒装办公室下午茶零食休闲食品小吃",      "image_url": "https://p3-item.ecombdimg.com/img/ecom-shop-material/jpeg_m_327d8faf8492a4d6722ddbd815f29bdb_sx_412657_www800-800~tplv-5mmsx3fupr-resize:480:480.jpeg?biz_tag=ecom_search&s=PackSource_EcomSearch&sc=ecom_hybrid",      "price_cny": 0.01,      "shop_id": "38484121",      "live_room_id": "7705130303337106202",      "is_live_product": true,      "source_keyword": "美食",      "platform": "douyin"    },    {      "product_id": "3681066470168723459",      "sku_id": "3402912365175042",      "title": "飞旺臭干子辣条正宗湖南长沙臭干子网红校园童年零食麻辣休闲小吃",      "image_url": "https://p26-item.ecombdimg.com/img/ecom-shop-material/jpeg_m_80a5aca284dcf0e715408640274c1278_sx_627143_www800-800~tplv-5mmsx3fupr-resize:480:480.jpeg?biz_tag=ecom_search&s=PackSource_EcomSearch&sc=ecom_hybrid",      "price_cny": 0.01,      "shop_id": "17049985",      "live_room_id": "7705303723047701257",      "is_live_product": true,      "source_keyword": "美食",      "platform": "douyin"    }  ],  "count": 3,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被编造。

字段	含义
`product_id`	抖音商城商品稳定 ID。
`sku_id`	抖音商城 SKU ID；与商品 product_id 不是同一标识。
`title`	标题。平台无标题概念时（如纯文本帖）为 null。
`image_url`	图片链接。多图能力可能返回 image_urls 数组。
`price_cny`	商品展示价格，人民币元。
`shop_id`	抖音商城店铺 ID。
`live_room_id`	采集时挂载该商品的直播间 ID；只表示当前直播搜索命中。
`is_live_product`	是否由当前直播商品搜索明确返回；不是历史直播归因。
`source_keyword`	本行命中的搜索关键词。
`platform`	数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

常见问题

一次能拿到几条商品，想多看怎么办？

默认和上限都是 3 条。要看更多商品，就拿几个不同的商品词分别搜一次，汇总时靠 source_keyword 认出每一行是哪个词带出来的，再按 product_id 去掉重复的商品。

`is_live_product` 为真能说明某个达人带过这个商品吗？

不能。它只表示这一行是当前直播商品搜索明确返回的，不是历史直播归因；keyword 是商品关键词，也不是按达人查询。

`product_id` 和 `sku_id` 用哪个做标识？

按商品汇总用 product_id，它是抖音商城商品的稳定 ID；sku_id 是 SKU 的 ID，与 product_id 不是同一个标识，要精确到规格时才用。店铺用 shop_id 区分。

错误与计费

401: 缺少 Key 或 Key 无效。
402: 余额不足，先充值。
422: 参数名或取值不对，按错误信息给的候选改；不扣费。
429: 超过每分钟请求上限，按 Retry-After 等待后再试。
503: 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
200 空结果: 没有数据，不扣费。

错误码