拼多多商品详情查询接口
需要授权
14331人使用

本接口用于查询某个商品的详情信息:
商品标题、商品描述、商品分类/标签、最小拼团价、最小单买价、商品历史累计售卖件数(模糊值,string类型,非数值)、优惠券金额、优惠券数量、优惠券剩余数量、优惠券门槛、优惠券有效期、商品评价分、商品评价数量、佣金比例、商品轮播图

接口地址: http://api.tbk.dingdanxia.com/pdd/goods_detail2 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

goods_sign

STRING

c9n2ugZxdDpP2PPhwfDY-mmFDlA7_JKwNYDrDm

商品goodsSign

custom_parameters

STRING

自定义参数

pid

STRING

推广位id

plan_type

INTEGER

佣金优惠券对应推广类型,3:专属 4:招商

search_id

STRING

搜索id,建议填写,提高收益

zs_duo_id

LONG

招商多多客ID

pdd_auth_id

String

授权切换参数

返回参数说明

标记

类型

例子

说明

cat_id

LONG

商品类目ID

cat_ids

INTEGER[]

商品一~四级类目ID列表

clt_cpn_batch_sn

STRING

店铺收藏券id

clt_cpn_discount

LONG

店铺收藏券面额,单位为分

clt_cpn_end_time

LONG

店铺收藏券截止时间

clt_cpn_min_amt

LONG

店铺收藏券使用门槛价格,单位为分

clt_cpn_quantity

LONG

店铺收藏券总量

clt_cpn_remain_quantity

LONG

店铺收藏券剩余量

clt_cpn_start_time

LONG

店铺收藏券起始时间

coupon_discount

LONG

优惠券面额,单位为分

coupon_end_time

LONG

优惠券失效时间,UNIX时间戳

coupon_min_order_amount

LONG

优惠券门槛金额,单位为分

coupon_remain_quantity

LONG

优惠券剩余数量

coupon_start_time

LONG

优惠券生效时间,UNIX时间戳

coupon_total_quantity

LONG

优惠券总数量

create_at

LONG

创建时间(unix时间戳)

desc_txt

STRING

描述分

goods_desc

STRING

参与多多进宝的商品描述

goods_gallery_urls

STRING[]

商品轮播图

goods_id

LONG

参与多多进宝的商品ID

goods_image_url

STRING

多多进宝商品主图

goods_name

STRING

参与多多进宝的商品标题

goods_sign

STRING

商品goodsSign

goods_thumbnail_url

STRING

商品缩略图

has_coupon

BOOLEAN

商品是否有优惠券 true-有,false-没有

has_mall_coupon

BOOLEAN

是否有店铺券

lgst_txt

STRING

物流分

mall_coupon_discount_pct

INTEGER

店铺折扣

mall_coupon_end_time

LONG

店铺券使用结束时间

mall_coupon_max_discount_amount

INTEGER

最大使用金额

mall_coupon_min_order_amount

INTEGER

最小使用金额

mall_coupon_remain_quantity

LONG

店铺券余量

mall_coupon_start_time

LONG

店铺券使用开始时间

mall_coupon_total_quantity

LONG

店铺券总量

mall_cps

INTEGER

该商品所在店铺是否参与全店推广,0:否,1:是

mall_id

LONG

商家id

mall_name

STRING

店铺名称

merchant_type

INTEGER

店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店(未传为全部)

min_group_price

LONG

最低价sku的拼团价,单位为分

min_normal_price

LONG

最低价sku的单买价,单位为分

only_scene_auth

BOOLEAN

快手专享

opt_id

LONG

商品标签ID

opt_ids

INTEGER[]

商品标签ID

opt_name

STRING

商品标签名称

plan_type

INTEGER

推广计划类型

predict_promotion_rate

LONG

比价行为预判定佣金,需要用户备案

promotion_rate

LONG

佣金比例,千分比

sales_tip

STRING

已售卖件数

service_tags

INTEGER[]

服务标签: 4-送货入户并安装,5-送货入户,6-电子发票,9-坏果包赔,11-闪电退款,12-24小时发货,13-48小时发货,17-顺丰包邮,18-只换不修,1可定制化,29-预约配送,1000001-正品发票,1000002-送货入户并安装

serv_txt

STRING

服务分

unified_tags

STRING[]

优惠标签列表

video_urls

STRING[]

商品视频url

zs_duo_id

LONG

招商团长id

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": [{
		"mall_coupon_remain_quantity": 0,
		"plan_type": 2,
		"category_name": "女装",
		"coupon_remain_quantity": 0,
		"promotion_rate": 70,
		"cat_ids": [
			8439,
			8440,
			8463
		],
		"coupon_min_order_amount": 0,
		"category_id": 17370,
		"service_tags": [
			24,
			13
		],
		"mall_coupon_discount_pct": 0,
		"mall_id": 159451,
		"mall_name": "衣帛云天",
		"coupon_total_quantity": 0,
		"mall_coupon_end_time": 0,
		"mall_coupon_min_order_amount": 0,
		"merchant_type": 1,
		"lgst_txt": "高",
		"goods_name": "100%纯棉镂空短袖t恤女V领上衣2020新款韩版大码绣花百搭修身",
		"sales_tip": "1万",
		"only_scene_auth": false,
		"goods_gallery_urls": [
			"https://img.pddpic.com/mms-material-img/2020-08-02/ffa5ffe6-656c-4b4d-89d5-e59500a7908e.jpg.a.jpeg",
			"https://t00img.yangkeduo.com/goods/images/2020-04-09/b6782f15-2a2e-4f27-91ba-d81cb676f2b4.jpg",
			"https://img.pddpic.com/mms-material-img/2020-08-02/3e35ac4b-453b-4f37-96dc-0264f55bcc6e.jpg.a.jpeg",
			"https://img.pddpic.com/mms-material-img/2020-08-02/7e5b0b6c-8a27-41e7-840e-cb78bf4409e5.jpg.a.jpeg",
			"https://img.pddpic.com/mms-material-img/2020-08-02/2c788917-69a8-41d2-a42f-e628f7a00a0c.jpg.a.jpeg",
			"https://img.pddpic.com/mms-material-img/2020-08-02/75fe717c-3b1b-40a3-aa35-2840ee38b46f.jpg.a.jpeg",
			"https://t00img.yangkeduo.com/goods/images/2020-04-09/a5cd0511e947bbf99affee6ad58ae7c7.jpeg",
			"https://img.pddpic.com/mms-material-img/2020-08-15/d7b968c1-5c40-47c6-ab77-2b89132d139a.jpeg.a.jpeg",
			"https://img.pddpic.com/mms-material-img/2020-08-15/16328d8c-68c0-4bc4-8e22-b284788b4a58.jpeg.a.jpeg",
			"https://img.pddpic.com/mms-material-img/2020-08-15/ea8fa414-996d-45ad-af68-68e7c579024a.jpeg.a.jpeg"
		],
		"goods_id": 104895318702,
		"predict_promotion_rate": 70,
		"desc_txt": "高",
		"goods_desc": "100%纯棉镂空短袖t恤女V领上衣2020新款韩版大码绣花百搭修身",
		"opt_name": "女装",
		"goods_thumbnail_url": "https://t00img.yangkeduo.com/goods/images/2020-08-02/1779c1a064e3f607ab0d05e4c7484af9.jpeg",
		"opt_ids": [
			17536,
			12,
			2701,
			14,
			20494,
			9490,
			17554,
			9491,
			17556,
			9496,
			24217,
			9498,
			17436,
			17565,
			20511,
			17440,
			17443,
			3237,
			13616,
			3376,
			3380,
			9525,
			2870,
			9526,
			2871,
			2872,
			13625,
			2874,
			13626,
			2880,
			13632,
			577,
			13634,
			2884,
			581,
			10696,
			584,
			13769,
			13770,
			13771,
			13773,
			10703,
			24272,
			24273,
			13779,
			3286,
			13782,
			17370,
			347,
			350,
			225,
			17379,
			17380,
			487,
			13800,
			13802,
			17386,
			20586,
			11116,
			17388,
			10733,
			11117,
			11118,
			13682,
			13811,
			17523,
			17524,
			17525,
			13686,
			502,
			17527,
			8569,
			13689,
			8570,
			8571,
			8572,
			8573,
			17533,
			8574
		],
		"opt_id": 17370,
		"goods_image_url": "https://img.pddpic.com/mms-material-img/2020-08-02/ffa5ffe6-656c-4b4d-89d5-e59500a7908e.jpg.a.jpeg",
		"has_mall_coupon": false,
		"has_coupon": false,
		"min_normal_price": 2790,
		"mall_coupon_start_time": 0,
		"serv_txt": "高",
		"unified_tags": [
			"极速退款",
			"满40返4"
		],
		"video_urls": [
			"https://video3.yangkeduo.com/i1/2020-06-14/b4cc6adc749345a2c68d47e8b9d0800c.mp4"
		],
		"mall_coupon_total_quantity": 0,
		"mall_coupon_max_discount_amount": 0,
		"coupon_start_time": 0,
		"min_group_price": 2590,
		"mall_cps": 1,
		"coupon_discount": 0,
		"goods_sign": "c9n2ugZxdDpP2PPhwfDY-mmFDlA7_JKwNYDrDm",
		"coupon_end_time": 0,
		"zs_duo_id": 0
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。