关键词/商品ID查询优惠券列表接口,拼多多超级搜索接口
4080人使用

关键词/商品ID查询优惠券列表接口,拼多多超级搜索接口

如果在线测试传参数range_list出现参数错误:range_list,是在线测试工具问题,请直接在浏览器测试接口,接口是没有问题的

接口地址: http://api.tbk.dingdanxia.com/pdd/goods_search 在线测试
请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

signature

string

接口签名,查看创建规则,(可在后台开启或关闭,关闭状态可不需要此参数)

keyword

STRING

商品关键词,与opt_id字段选填一个或全部填写

opt_id

LONG

商品标签类目ID

page

INTEGER

默认值1,商品分页数

page_size

INTEGER

默认100,每页商品数量

sort_type

INTEGER

排序方式:0-综合排序;1-按佣金比率升序;2-按佣金比例降序;3-按价格升序;4-按价格降序;5-按销量升序;6-按销量降序;7-优惠券金额排序升序;8-优惠券金额排序降序;9-券后价升序排序;10-券后价降序排序;11-按照加入多多进宝时间升序;12-按照加入多多进宝时间降序;13-按佣金金额升序排序;14-按佣金金额降序排序;15-店铺描述评分升序;16-店铺描述评分降序;17-店铺物流评分升序;18-店铺物流评分降序;19-店铺服务评分升序;20-店铺服务评分降序;27-描述评分击败同类店铺百分比升序,28-描述评分击败同类店铺百分比降序,29-物流评分击败同类店铺百分比升序,30-物流评分击败同类店铺百分比降序,31-服务评分击败同类店铺百分比升序,32-服务评分击败同类店铺百分比降序

with_coupon

BOOLEAN

是否只返回优惠券的商品,false返回所有商品,true只返回有优惠券的商品

range_list

STRING

筛选范围列表 样例:[{"range_id":0,"range_from":1,"range_to":1500},{"range_id":1,"range_from":1,"range_to":1500}] range_id枚举及描述: 0,最小成团价 1,券后价 2,佣金比例 3,优惠券价格 4,广告创建时间 5,销量 6,佣金金额 7,店铺描述分 8,店铺物流分 9,店铺服务分 10, 店铺描述分击败同行业百分比 11, 店铺物流分击败同行业百分比 12,店铺服务分击败同行业百分比 13,商品分 17 ,优惠券/最小团购价 18,过去两小时pv 19,过去两小时销量

cat_id

LONG

商品类目ID

goods_id_list

STRING

5225346,7275691

商品ID列表。例如:123456,123,当入参带有goods_id_list字段,将不会以opt_id、 cat_id、keyword维度筛选商品

merchant_type

INTEGER

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

pid

STRING

推广位id

custom_parameters

STRING

自定义参数

merchant_type_list

NTEGER[]

店铺类型数组

is_brand_goods

BOOLEAN

是否为品牌商品

activity_tags

INTEGER[]

商品标记数组,1-表示双十一商品

返回参数说明

标记

类型

例子

说明

has_mall_coupon

BOOLEAN

是否有店铺券

mall_coupon_id

LONG

店铺券id

mall_coupon_discount_pct

INTEGER

店铺券折扣

mall_coupon_min_order_amount

INTEGER

最小使用金额

mall_coupon_max_discount_amount

INTEGER

最大使用金额

mall_coupon_total_quantity

LONG

店铺券总量

mall_coupon_remain_quantity

LONG

店铺券余量

mall_coupon_start_time

LONG

店铺券开始使用时间

mall_coupon_end_time

LONG

店铺券结束使用时间

create_at

long

创建时间(unix时间戳)

goods_id

LONG

商品id

goods_name

String

商品名称

goods_desc

String

商品描述

goods_thumbnail_url

String

商品缩略图

goods_image_url

String

商品主图

goods_gallery_urls

STRING[]

商品轮播图

min_group_price

LONG

最小拼团价(单位为分)

min_normal_price

LONG

最小单买价格(单位为分)

mall_name

String

店铺名字

merchant_type

INTEGER

店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店

category_id

LONG

商品类目ID,使用pdd.goods.cats.get接口获取

category_name

STRING

商品类目名

opt_id

LONG

商品标签ID

opt_name

STRING

商品标签名

opt_ids

LONG[]

商品标签id

cat_ids

LONG[]

商品类目id

mall_cps

INTEGER

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

has_coupon

BOOLEAN

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

coupon_min_order_amount

LONG

优惠券门槛价格,单位为分

coupon_discount

LONG

优惠券面额,单位为分

coupon_total_quantity

LONG

优惠券总数量

coupon_remain_quantity

LONG

优惠券剩余数量

coupon_start_time

LONG

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

coupon_end_time

LONG

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

promotion_rate

LONG

佣金比例,千分比

goods_eval_count

LONG

商品评价数量

sales_tip

STRING

已售卖件数

activity_type

INTEGER

活动类型,0-无活动;1-秒杀;3-限量折扣;12-限时折扣;13-大促活动;14-名品折扣;15-品牌清仓;16-食品超市;17-一元幸运团;18-爱逛街;19-时尚穿搭;20-男人帮;21-9块9;22-竞价活动;23-榜单活动;24-幸运半价购;25-定金预售;26-幸运人气购;27-特色主题活动;28-断码清仓;29-一元话费;30-电器城;31-每日好店;32-品牌卡;101-大促搜索池;102-大促品类分会场;

service_tags

LONG[]

服务标签: 4-送货入户并安装,5-送货入户,6-电子发票,9-坏果包赔,11-闪电退款,12-24小时发货,13-48小时发货,17-顺丰包邮,18-只换不修,19-全国联保,20-分期付款,24-极速退款,25-品质保障,26-缺重包退,27-当日发货,28-可定制化,29-预约配送,1000001-正品发票,1000002-送货入户并安装

clt_cpn_batch_sn

STRING

店铺收藏券id

clt_cpn_start_time

LONG

店铺收藏券起始时间

clt_cpn_end_time

LONG

店铺收藏券截止时间

clt_cpn_quantity

LONG

店铺收藏券总量

clt_cpn_remain_quantity

LONG

店铺收藏券剩余量

clt_cpn_discount

LONG

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

clt_cpn_min_amt

LONG

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

desc_txt

STRING

描述分

serv_txt

STRING

服务分

lgst_txt

STRING

物流分

plan_type

INTEGER

推广计划类型 3:定向 4:招商

zs_duo_id

LONG

招商团长id

only_scene_auth

BOOLEAN

快手专享

mall_id

LONG

店铺ID

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 172351,
	"data": [{
		"category_name": "汽车",
		"clt_cpn_end_time": null,
		"clt_cpn_min_amt": null,
		"coupon_remain_quantity": 900,
		"clt_cpn_remain_quantity": null,
		"promotion_rate": 100,
		"service_tags": [24, 13],
		"mall_id": 823809424,
		"mall_name": "亨的利车饰",
		"mall_coupon_end_time": 0,
		"clt_cpn_batch_sn": null,
		"lgst_txt": "低",
		"goods_name": "四大桶汽车玻璃水防冻型四季通用雨刮水车用雨刮精清洗液汽车用品",
		"clt_cpn_discount": null,
		"goods_id": 58467466235,
		"goods_gallery_urls": null,
		"goods_desc": "切记:【0度玻璃水为标准型,不防冻】冬季零下地区建议购买-15度至-40度,玻璃水1瓶1.35L,四季通用,冬季防冻玻璃水,分为四种规格:夏季专用【0度】,冬天选用【-15度】【-25度】【-40度】,有效去除鸟屎,虫胶,油膜,灰尘等污渍,冬季使用防冻玻璃水有防冻,化冰,融雪,化霜,(仅限防冻玻璃水),配方:去离子水,润滑剂,乙二醇聚合物,防腐剂,软化剂,防蚀阻垢剂,防油防锈剂多种混合物组成。本款为新研发,比市面上1.8升玻璃水增加多种功效,默认快递为邮政快递!",
		"opt_name": "汽车",
		"opt_ids": [2048, 10305, 20996, 2053, 10696, 19977, 6475, 21003, 12, 12621, 10702, 12691, 19926, 11671, 12696, 19866, 223, 16223, 19871, 6242, 10339, 19875, 12581, 294, 10729, 12586, 16172, 11632, 20720, 16112, 16117, 2105, 16121, 21050, 12731, 10301],
		"goods_image_url": "https://t00img.yangkeduo.com/goods/images/2019-11-07/b1467b5f-c1c6-4901-9575-cb1f177baa62.jpg",
		"has_mall_coupon": false,
		"min_group_price": 650,
		"coupon_start_time": 1574265600,
		"coupon_discount": 300,
		"coupon_end_time": 1574524799,
		"zs_duo_id": 0,
		"mall_coupon_remain_quantity": 0,
		"plan_type": 2,
		"clt_cpn_quantity": null,
		"crt_rf_ordr_rto1m": 0.031199742682535,
		"cps_sign": null,
		"cat_ids": [7639, 7641, 7853, 8064],
		"coupon_min_order_amount": 300,
		"category_id": 2048,
		"mall_coupon_discount_pct": 0,
		"activity_type": null,
		"cat_id": null,
		"coupon_total_quantity": 1000,
		"mall_coupon_min_order_amount": 0,
		"merchant_type": 1,
		"clt_cpn_start_time": null,
		"sales_tip": "2566",
		"only_scene_auth": true,
		"mall_coupon_id": 0,
		"desc_txt": "高",
		"goods_thumbnail_url": "https://t00img.yangkeduo.com/goods/images/2019-11-07/b0e44cb5475d0b8f2d9eb90b96991d15.jpeg",
		"opt_id": 2048,
		"min_normal_price": 750,
		"has_coupon": true,
		"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是否填写,或是否填写正确。