获取爆款热销排行商品接口
需要授权
4692人使用

获取爆款热销排行商品

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

p_id

STRING

推广位id

offset

INTEGER

从多少位置开始请求;默认值 : 0 offset是limit的整数倍。 比如 10,20,30,40

sort_type

INTEGER

1-实时热销榜;2-实时收益榜

limit

INTEGER

10

请求数量;默认值 : 400

list_id

STRING

翻页时建议填写前页返回的list_id值

custom_parameters

STRING

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

返回参数说明

标记

类型

例子

说明

total

LONG

返回商品总数

goods_id

LONG

商品id

goods_name

STRING

商品名称

goods_desc

STRING

商品描述

goods_thumbnail_url

STRING

商品缩略图

goods_image_url

STRING

商品主图

goods_gallery_urls

STRING[]

商品轮播图

sales_tip

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,使用pdd.goods.opts.get接口获取

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_score

DOUBLE

商品评价分

goods_eval_count

LONG

商品评价数量

desc_txt

STRING

描述分

lgst_txt

STRING

服务分

serv_txt

STRING

物流分

list_id

STRING

翻页时建议填写前页返回的list_id值

search_id

STRING

搜索id,建议生成推广链接时候填写,提高收益

predict_promotion_rate

LONG

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

返回示例

{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "total":300,
        "list_id":"arwen_8735184_4e8be81fe5d0dab7dcaa4aa53d058536",
        "list":[
            {
                "lgst_txt":"高",
                "goods_name":"正宗四川攀枝花凯特芒果 新鲜热带水果 芒果 青芒当季新鲜批发",
                "sales_tip":"3209",
                "coupon_remain_quantity":12000,
                "goods_id":930259629,
                "promotion_rate":200,
                "desc_txt":"高",
                "goods_desc":"正宗四川攀枝花凯特芒果 新鲜热带水果 芒果 青芒当季新鲜批发",
                "opt_name":"海淘",
                "goods_thumbnail_url":"https://t00img.yangkeduo.com/goods/images/2020-08-09/343daff235ae877745104109637c75ad.jpeg",
                "opt_id":10696,
                "opt_ids":[
                    10723,
                    163,
                    22884,
                    1254,
                    10696,
                    22280,
                    22281,
                    22922,
                    9419,
                    10700,
                    140,
                    9420,
                    13,
                    12402,
                    9426,
                    1267,
                    22879
                ],
                "search_id":"41980f5b5f3bd440a941a7c3ad71db2b5aa",
                "cat_ids":[
                    8172,
                    8182,
                    8263
                ],
                "coupon_min_order_amount":700,
                "goods_image_url":"https://img.pddpic.com/mms-material-img/2020-08-09/d69636ff-649a-4792-b9f4-6a1a724b6424.jpg.a.jpeg",
                "min_normal_price":3300,
                "serv_txt":"高",
                "mall_name":"土家原味",
                "coupon_total_quantity":20000,
                "min_group_price":1390,
                "coupon_start_time":1597075200,
                "coupon_discount":700,
                "coupon_end_time":1597593599
            }
        ],
        "request_id":"15972327170182028",
        "search_id":"41980f5b5f3bd440a941a7c3ad71db2b5aa"
    }
}

			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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