抖音商品详情api接口

调用入口

接口基础信息

接口名称 ：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&param_json={"product_id":"3558192687276554544"}&timestamp=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 / 商品管理：同步抖店商品信息、上下架、库存
导购 / 选品：聚合商品详情、价格、销量做推荐
数据分析：监控商品价格、销量、库存变化
直播 / 短视频：自动挂载商品、展示详情