抖音店铺商品 API

按 shop_id 逐页读一家抖音商城店铺的商品,每行带 title、price_cny、monthly_sales,另有 shop_product_count 和 shop_page_count,每千次 $8。

  • shop_product_count 是整家店的商品数,shop_page_count 是总页数
  • shop_id 取自 product_search 或 product_detail,不是店铺名
  • 失败和空结果不收费
免费开始

接口健康状态

24h 健康值
正常
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "shop_products",
      "params": {
        "shop_id": "84535208"
      }
    }
  2. 2JSON 响应

    {
      "results": [
        {
          "next_page_token": string,
          "product_id": string,
          "promotion_id": string,
          "title": string
        },
        …
      ]
    }
  3. 3行

    next_page_tokenproduct_idpromotion_idtitle
    stringstringstringstring
  4. 4CSV

    douyin-shop_products-sample.csv next_page_token,product_id,promotion_id,title,url,image_url,price_cny,price_cny_minor,monthly_sales,tags,shop_id,shop_product_count,shop_page_count,platform

请求带 shop_id,返回这家店的一页商品,results 里每行是一件商品,列成字段表,也可下载为 CSV。

能拿到什么数据

这个能力还没有公开的真实样本。下表列出每行会返回的字段、类型和含义,不放值。

字段类型含义
next_page_tokenstring翻页令牌(search / product_search / shop_products / user_posts / comments / comment_replies / billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion / billboard_account_search / music_search / billboard_rise_list / billboard_topic_hot):作为下一次请求的 page_token 原样传回取下一页(其余参数不变,24 小时内有效);同一页每行的值相同,响应顶层也有同一个 next_page_token。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
product_idstring抖音商城商品稳定 ID。
promotion_idstring抖音带货计划中的推广 ID。
titlestring标题。平台无标题概念时(如纯文本帖)为 null。
urlstring该记录在原平台上的可访问链接。
image_urlstring图片链接。多图能力可能返回 image_urls 数组。
price_cnynumber商品展示价格,人民币元。
price_cny_minornumber商品展示价格,人民币分的整数值。
monthly_salesnumber商品近 30 天销量。
tagsarray标签数组。无标签时为空数组,不是 null。
shop_idstring抖音商城店铺 ID。
shop_product_count—这家店一共有多少件商品(shop_products);每行相同。
shop_page_count—这家店的商品一共多少页(shop_products,一页 10 件);每行相同。
platformstring数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

用途

  • 盘一家店的全部商品

    按 next_page_token 一页页往下读,读到没有 next_page_token 就是最后一页。

  • 估算店铺规模

    读 shop_product_count 和 shop_page_count,不必翻完就知道这家店挂了多少商品、要翻几页。

  • 盯竞品店铺的价格

    按期读同一家店,比较各商品的 price_cny 和 monthly_sales 变化。

  • 从搜索结果深入一家店

    product_search 搜出感兴趣的商品,取它的 shop_id,再来读这家店的其他商品。

抖店开放平台 与 EveryInfra 对比

下面从查谁的店铺商品看,比较抖店开放平台文档和 EveryInfra shop_products。

对比项抖店开放平台EveryInfra
查谁的店铺"批量查询商家抖店商品信息"shop_id 指定一家抖音商城店铺,请求里只有 EveryInfra API Key 和 shop_id,读到的是这家店公开展示的商品。

引文出自抖店开放平台文档,2026-11-22 核对;更新日期是页面自己标的。 官方出处: product/listV2 批量查询商品列表 (更新于 2026-11-05)

限制和注意事项

  • shop_id 必填,是抖音商城店铺的数字 ID,不能填店铺名。
  • 按页读取:带 page 直接取这一页;翻页时把返回的 next_page_token 原样作为 page_token 传回,其余参数不变,令牌 24 小时内有效。
  • 同时传了 page 和 page_token 时以令牌为准。
  • 翻到最后一页没有 next_page_token;总页数看 shop_page_count。
  • shop_product_count 和 shop_page_count 每行相同,是整家店的数,不是当前页的行数。
  • monthly_sales 是商品近 30 天销量,不是买家人数。

价格

每次调用 $0.008,按次计费,不按条数算;翻一页算一次调用。失败和空结果不收费。

调用次数费用
10,000$80.00
100,000$800.00
1,000,000$8,000.00

合计按每次调用的标价算。

代码示例

#
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": "shop_products",
  "params": {
    "shop_id": "84535208"
  }
}'

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

API 参考

下面是 shop_products 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。

POST

AI 提示词

#
请帮我用 EveryInfra 的「抖音店铺商品」接口(douyin/shop_products)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 douyin,action 填 shop_products,参数放在 params 里。
- 必填参数:
  - shop_id:抖音商城店铺的数字 ID,取自 product_search 或 product_detail 返回行的 shop_id;不是店铺名。
- 可选参数:
  - page:页码,从 1 开始,一页 10 件商品;总页数看返回行的 shop_page_count。带 page 直接取这一页、算一次调用;同时传了 page_token 以令牌为准。
  - page_token:翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数不变。一页 10 件商品、算一次调用;令牌 24 小时内有效。
- 返回一组记录,每条记录的主要字段:next_page_token(翻页令牌(search / pro…)、product_id(抖音商城商品稳定 ID)、promotion_id(抖音带货计划中的推广 ID)、title、url、image_url、price_cny(商品展示价格)、price_cny_minor(商品展示价格)、monthly_sales(商品近 30 天销量)、tags、shop_id(抖音商城店铺 ID)、shop_product_count(这家店一共有多少件商品(shop_…);一共 13 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=douyin。
- 示例请求体:
{
  "platform": "douyin",
  "action": "shop_products",
  "params": {
    "shop_id": "84535208"
  }
}
- 计费:$8 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

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

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是douyin平台标识,固定值。
actionbodystring是shop_products能力标识,固定值。
shop_idbody.paramsstring是-抖音商城店铺的数字 ID,取自 product_search 或 product_detail 返回行的 shop_id;不是店铺名。
pagebody.paramsinteger否-页码,从 1 开始,一页 10 件商品;总页数看返回行的 shop_page_count。带 page 直接取这一页、算一次调用;同时传了 page_token 以令牌为准。
page_tokenbody.paramsstring否-翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数不变。一页 10 件商品、算一次调用;令牌 24 小时内有效;翻到最后一页时没有 next_page_token。

响应示例

#
这组示例参数还没有真实样例:这里只按接口定义列出响应结构和字段,值用 … 占位,不是一次真实调用的结果。
json
{  "id": "req_…",  "platform": "douyin",  "action": "shop_products",  "results": [    {      "next_page_token": …,      "product_id": …,      "promotion_id": …,      "title": …,      "url": …,      "image_url": …,      "price_cny": …,      "price_cny_minor": …,      "monthly_sales": …,      "tags": …,      "shop_id": …,      "shop_product_count": …,      "shop_page_count": …,      "platform": …    }  ],  "next_page_token": …,  "pagination": { … },  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

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

字段含义
next_page_token翻页令牌(search / product_search / shop_products / user_posts / comments / comment_replies / billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion / billboard_account_search / music_search / billboard_rise_list / billboard_topic_hot):作为下一次请求的 page_token 原样传回取下一页(其余参数不变,24 小时内有效);同一页每行的值相同,响应顶层也有同一个 next_page_token。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
product_id抖音商城商品稳定 ID。
promotion_id抖音带货计划中的推广 ID。
title标题。平台无标题概念时(如纯文本帖)为 null。
url该记录在原平台上的可访问链接。
image_url图片链接。多图能力可能返回 image_urls 数组。
price_cny商品展示价格,人民币元。
price_cny_minor商品展示价格,人民币分的整数值。
monthly_sales商品近 30 天销量。
tags标签数组。无标签时为空数组,不是 null。
shop_id抖音商城店铺 ID。
shop_product_count这家店一共有多少件商品(shop_products);每行相同。
shop_page_count这家店的商品一共多少页(shop_products,一页 10 件);每行相同。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

错误与计费

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

错误码

常见问题

店铺商品接口返回什么?

这家店一页商品:product_id、promotion_id、title、url、image_url、price_cny、monthly_sales、tags、shop_id,每行还带 shop_product_count、shop_page_count 和 next_page_token。

shop_id 从哪里来?

取自 product_search 或 product_detail 返回行里的 shop_id。它是店铺的数字 ID,不是店铺名。

怎么知道一家店有多少页?

看任意一行的 shop_page_count;也可以一直翻,直到响应里没有 next_page_token。

翻一家店要多少钱?

每页算一次调用,每次 $0.008,每千次 $8。失败和空结果不收费。

同一把 Key 还能调用抖音的其他能力。

Google Analytics 同意才加载 隐私