# 获取商品基础详情

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：getproductdetail

你可以在本接口获取最详细的通用商品信息（例如商品销量、价格、图片等）；商品推广相关的参数（如推广链接等）请分别在推客带货和达人带货接口中获取。

• 启用新多级类目树提示：旧的类目树固定为三级类目结构，新的类目树为多级类目结构，过渡期间，新旧类目树兼容使用，请开发者尽快切换到新多级类目树。其中差异请参阅新旧类目差异说明。此接口新增 cats_v2 字段支持新类目树，详见参数。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/league/headsupplier/productdetail/get?access_token=ACCESS_TOKEN

# 云调用

• 本接口不支持云调用。

# 第三方调用

• 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.item Object Payload

商品详情

# Res.item.product_info Object Payload

商品信息

# Res.item.product_info.desc_info Object Payload

商详信息

# Res.item.product_info.skus(Array) Object Payload

sku信息

# Res.item.product_info.skus(Array).sku_attrsObject Payload

sku_attrs

# Res.item.product_info.skus(Array).sku_deliver_info Object Payload

预售信息

# Res.item.product_info.cats_v2(Array) Object Payload

新类目树--类目信息

# Res.item.product_info.extra_service Object Payload

服务保障信息

# Res.item.product_info.product_spring_festival_delivery_config Object Payload

春节不打烊信息

# Res.item.product_info.product_spring_festival_delivery_config.delivery_time_list(Array) Object Payload

春节可发货时段（为空则春节不发货）

# Res.item.product_info.freight_info Object Payload

物流信息

# Res.item.product_info.freight_info.address_info Object Payload

发货地址

# Res.item.product_info.freight_info.condition_free_detail_list(Array) Object Payload

条件包邮详情

# Res.item.product_info.freight_info.condition_free_detail_list(Array).address_infosObject Payload

支持的地址列表

# Res.item.product_info.freight_info.freight_calc_method_list(Array) Object Payload

具体计费方法，默认运费，指定地区运费等

# Res.item.product_info.freight_info.freight_calc_method_list(Array).address_infosObject Payload

支持的地址列表

# Res.item.product_info.freight_info.not_send_area(Array) Object Payload

不发货区域

# Res.item.product_info.head_video_info(Array) Object Payload

商品视频

# Res.item.shop Object Payload

店铺信息

# 4. 枚举信息

# Res.item.product_info.freight_info.send_time Enum

发货时间期限详情

# 5. 注意事项

本接口无特殊注意事项

# 6. 代码示例

请求示例

{
    "shop_appid": "SHOPAPPID",
    "product_id": 1
}

返回示例

{
	"errcode": "0",
	"errmsg": "ok",
	"product": {
		"shop_appid": "test",
		"product_id": 12345,
		"product_info": {
			"title": "test_title",
			"sub_title": "",
			"head_imgs": [
				"https://test.com/0"
			],
			"desc_info": {
				"imgs": [
					"https://test.com/0"
				],
				"desc": ""
			},
			"cats_v2": [{
				"cat_id": "1421"
			}],
			"express_info": {
				"send_time": "",
				"address_info": {
					"postal_code": "",
					"province_name": "",
					"city_name": "",
					"county_name": ""
				},
				"shipping_method": "NO_FREE"
			},
			"extra_service": {
				"seven_day_return": 0,
				"pay_after_use": 0,
				"freight_insurance": 0,
				"fake_one_pay_three": 0,
				"damage_guarantee": 0
			},
			"statistical_data": {
				"good_ratio": 0,
				"sales_in_30_days": 1
			},
			"skus": [{
				"sku_id": "670813472",
				"thumb_img": "",
				"sale_price": 500,
				"stock_num": 998,
				"sku_attrs": [{
					"attr_key": "产地",
					"attr_value": "四川成都"
				}]
			}]
		},
		"shop": {
			"name": "xx",
			"score": 463,
			"icon": "https://xx"
		}
	}
}

# 7. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

# 8. 适用范围

本接口支持「联盟带货机构」账号类型调用。其他账号类型如无特殊说明，均不可调用。

接口变更日志（2条）

2026 年 03 月 09 日

新增 freight_info 、 has_qualification 、 is_hot_brand 、 short_title 、 head_video_info 、 good_evaluation_ratio 等字段，新增「发货时间期限」枚举类型，文档结构及章节编号更新

2026 年 02 月 04 日

API 文档通用更新、新增 cats_v2 字段，新增 extra_service 、 product_spring_festival_delivery_config 等字段