抖音商品详情api接口

1. 接口基础信息

接口名称：product.detail（查询商品详情）

请求方式：GET

请求地址：https://openapi-fxg.jinritemai.com/product/detail

权限要求：需店铺授权 + 应用具备「商品信息查询」权限

2. 公共请求参数（必填）

表格

参数名	类型	说明
method	String	固定为 product.detail
app_key	String	应用分配的 AppKey
access_token	String	店铺授权后获取
param_json	String	业务参数 JSON 字符串
timestamp	String	时间戳（yyyy-MM-dd HH:mm:ss）
v	String	协议版本，固定为 2
sign	String	参数签名（HMAC-SHA256）

3. 业务参数（param_json）

表格

参数名	类型	必填	说明
product_id	String	二选一	抖店商品 ID（19 位）
out_product_id	String	二选一	外部商家自定义编码
show_draft	String	否	是否读取草稿（true/false，默认 false）

4. 核心返回字段（JSON）

基础信息：product_id、name（标题）、description（详情 HTML）、pic（主图列表）、status（上下架）、check_status（审核状态）

价格：market_price（划线价，分）、discount_price（售价，分）、spec_prices（SKU 价格）

规格：specs（规格项）、spec_prices（SKU 详情）

销售：sell_num（销量）、presell_type（预售类型）、delivery_method（发货时效）

其他：category_detail（类目）、logistics_info（物流）、after_sale_service（售后）

5. 请求示例

plaintext

 

https://openapi-fxg.jinritemai.com/product/detail?app_key=xxx&method=product.detail&access_token=xxx¶m_json={"product_id":"3558192687276554544"}×tamp=2026-03-23 10:00:00&v=2&sign=xxx

 

二、抖音开放平台：商品相关接口（非抖店）

1. 生活服务商品模板（goodlife/v1/goods/template/get）抖音开放平台

用途：获取生活服务类商品模板信息

权限：需申请「商品查询」权限 + 商家授权抖音开放平台

参数：product_type（商品类型）、category_id（类目 ID）、product_attrs（属性列表）抖音开放平台

2. 其他场景

达人 / 选品：巨量百应（Buyin）提供 buyin/productSkus/v2 等分销商品查询接口

小程序 / 应用：抖音开放平台提供商品展示、挂载相关能力，需按场景申请权限抖音开放平台

三、接入流程（抖店为例）

入驻：在抖店开放平台注册开发者，创建应用获取 app_key/app_secret

授权：引导抖店商家完成应用授权，获取 access_token

签名：按规则对参数签名（推荐 hmac-sha256）

调用：传入 product_id 或 out_product_id 发起请求

解析：处理 JSON 返回，提取商品详情、价格、SKU 等数据

四、常见错误与注意事项

40004：参数非法（商品 ID 不存在 / 格式错误）

50002：业务失败（限流、权限不足）

20000：系统异常（重试）

限流：接口有调用频率限制，需合理控制并发

数据：价格单位为分，详情为 HTML 格式，主图最多 5 张

五、应用场景

ERP / 商品管理：同步抖店商品信息、上下架、库存

导购 / 选品：聚合商品详情、价格、销量做推荐

数据分析：监控商品价格、销量、库存变化

直播 / 短视频：自动挂载商品、展示详情

审核编辑 黄宇