拼多多查询店铺商品接口
3162人使用

查询店铺商品

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

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

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

mall_id

LONG

178983649

店铺ID

page_number

INTEGER

1

分页数

page_size

INTEGER

10

每页商品数量

pid

STRING

推广位id

custom_parameters

STRING

自定义参数,为链接打上自定义标签;自定义参数最长限制64个字节;格式为: {"uid":"11111","sid":"22222"} ,其中 uid 用户唯一标识,可自行加密后传入,每个用户仅且对应一个标识,必填; sid 上下文信息标识,例如sessionId等,非必填。该json字符串中也可以加入其他自定义的key

返回参数说明

标记

类型

例子

说明

category_id

LONG

商品类目id

category_name

STRING

商品类目名

cat_id

LONG

商品类目ID

cat_ids

LONG[]

商品标签ID(多级)

coupon_discount

LONG

优惠券面额(单位为分)

coupon_end_time

LONG

优惠券结束时间(unix时间戳)

coupon_min_order_amount

LONG

优惠券最小门槛价(单位为分)

coupon_price

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_fact_price

LONG

商品实际价格(单位为分)

goods_gallery_urls

STRING

商品轮播图

goods_id

LONG

商品id

goods_image_url

STRING

商品主图

goods_mark_price

LONG

商品市场价(单位为分)

goods_name

STRING

商品名称

goods_rate

LONG

商品佣金比(千分比)

goods_thumbnail_url

STRING

商品缩略图

goods_type

INTEGER

商品类型,1-普通商品,2-进口商品,3-直供,4-直邮

has_coupon

BOOLEAN

是否有优惠券

lgst_txt

STRING

物流分

mall_cps

INTEGER

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

mall_id

LONG

店铺id

mall_name

STRING

店铺名称

mall_rate

LONG

全店推广店铺佣金比(千分比)

market_fee

LONG

佣金(单位为分)

merchant_type

INTEGER

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

min_group_price

LONG

商品拼团价(单位为分)

min_normal_price

LONG

商品单买价(单位为分)

opt_id

LONG

商品标签id

opt_ids

LONG[]

商品标签ID

opt_name

STRING

商品标签名

promotion_rate

LONG

佣金比(千分比)

qr_code_image_url

STRING

聊天二维码图片url

sales_tip

STRING

已售卖件数

serv_txt

STRING

服务分

share_desc

STRING

分享文案

predict_promotion_rate

LONG

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

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 2,
	"data": [{
		"category_name": null,
		"clt_cpn_end_time": null,
		"clt_cpn_min_amt": null,
		"coupon_remain_quantity": 0,
		"clt_cpn_remain_quantity": null,
		"promotion_rate": 10,
		"coupon_id": 0,
		"service_tags": [13],
		"mall_id": 178983649,
		"mall_name": "哎呀来啦",
		"mall_coupon_end_time": 0,
		"clt_cpn_batch_sn": null,
		"lgst_txt": "低",
		"goods_name": "(盒装)大众甲壳虫老爷车合金车模仿真玩具车烘焙蛋糕摆件模型",
		"clt_cpn_discount": null,
		"goods_id": 40537045999,
		"goods_gallery_urls": null,
		"goods_desc": "(盒装)大众甲壳虫老爷车合金车模仿真玩具车烘焙蛋糕摆件模型",
		"opt_name": "海淘",
		"opt_ids": [10722, 23010, 11203, 4, 5285, 23015, 10696, 8587, 10699, 8588, 12, 11756, 8589, 5295, 11696, 9907, 9911, 23095, 344, 8569, 9945, 8570, 8571, 220],
		"goods_image_url": "https://t00img.yangkeduo.com/openapi/images/2020-04-23/88d1a0ae2f52f85ca271ecc9d6cf0e86.jpeg",
		"has_mall_coupon": false,
		"min_group_price": 1800,
		"coupon_start_time": 0,
		"coupon_discount": 0,
		"coupon_end_time": 0,
		"zs_duo_id": 0,
		"mall_coupon_remain_quantity": 0,
		"plan_type": 1,
		"clt_cpn_quantity": null,
		"crt_rf_ordr_rto1m": 0.77777777777778,
		"cat_ids": [15083, 15101, 15223],
		"coupon_min_order_amount": 0,
		"category_id": null,
		"mall_coupon_discount_pct": 0,
		"cat_id": null,
		"coupon_total_quantity": 0,
		"mall_coupon_min_order_amount": 0,
		"merchant_type": 1,
		"clt_cpn_start_time": null,
		"sales_tip": "59",
		"plan_type_all": 0,
		"only_scene_auth": null,
		"mall_coupon_id": 0,
		"desc_txt": "低",
		"goods_thumbnail_url": "https://t00img.yangkeduo.com/goods/images/2020-04-23/cf21fc795bdc8a73845d5110edbbf6e0.jpeg",
		"opt_id": 10696,
		"search_id": null,
		"min_normal_price": 2000,
		"has_coupon": false,
		"mall_coupon_start_time": 0,
		"serv_txt": "低",
		"mall_rate": 10,
		"mall_coupon_total_quantity": 0,
		"create_at": null,
		"mall_coupon_max_discount_amount": 0,
		"mall_cps": 1
	}, {
		"category_name": null,
		"clt_cpn_end_time": null,
		"clt_cpn_min_amt": null,
		"coupon_remain_quantity": 0,
		"clt_cpn_remain_quantity": null,
		"promotion_rate": 10,
		"coupon_id": 0,
		"service_tags": [13],
		"mall_id": 178983649,
		"mall_name": "哎呀来啦",
		"mall_coupon_end_time": 0,
		"clt_cpn_batch_sn": null,
		"lgst_txt": "低",
		"goods_name": "(盒装大奔g63车模合金车玩具回力小汽车模型烘焙摆件热卖玩具装饰",
		"clt_cpn_discount": null,
		"goods_id": 40537080349,
		"goods_gallery_urls": null,
		"goods_desc": "(盒装大奔g63车模合金车玩具回力小汽车模型烘焙摆件热卖玩具",
		"opt_name": "车品",
		"opt_ids": [2048, 11632, 2049, 2065, 20721, 20996, 20997, 21013, 10696, 10729, 11675, 10702],
		"goods_image_url": "https://t00img.yangkeduo.com/openapi/images/2020-04-20/7085075425067d1222d4cceab06756f2.jpeg",
		"has_mall_coupon": false,
		"min_group_price": 2200,
		"coupon_start_time": 0,
		"coupon_discount": 0,
		"coupon_end_time": 0,
		"zs_duo_id": 0,
		"mall_coupon_remain_quantity": 0,
		"plan_type": 1,
		"clt_cpn_quantity": null,
		"crt_rf_ordr_rto1m": 0.77777777777778,
		"cat_ids": [7639, 7720, 7887],
		"coupon_min_order_amount": 0,
		"category_id": null,
		"mall_coupon_discount_pct": 0,
		"cat_id": null,
		"coupon_total_quantity": 0,
		"mall_coupon_min_order_amount": 0,
		"merchant_type": 1,
		"clt_cpn_start_time": null,
		"sales_tip": "4",
		"plan_type_all": 0,
		"only_scene_auth": null,
		"mall_coupon_id": 0,
		"desc_txt": "低",
		"goods_thumbnail_url": "https://t00img.yangkeduo.com/goods/images/2020-04-20/f4a5801224708a1514048d4d4f937202.jpeg",
		"opt_id": 2048,
		"search_id": null,
		"min_normal_price": 2400,
		"has_coupon": false,
		"mall_coupon_start_time": 0,
		"serv_txt": "低",
		"mall_rate": 10,
		"mall_coupon_total_quantity": 0,
		"create_at": null,
		"mall_coupon_max_discount_amount": 0,
		"mall_cps": 1
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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