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

获取爆款热销排行商品

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

signature

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值

返回参数说明

标记

类型

例子

说明

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

商品评价数量

avg_desc

LONG

描述评分

avg_lgst

LONG

物流评分

avg_serv

LONG

服务评分

desc_pct

DOUBLE

描述分击败同类店铺百分比

lgst_pct

DOUBLE

物流分击败同类店铺百分比

serv_pct

DOUBLE

服务分击败同类店铺百分比

list_id

STRING

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

search_id

STRING

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

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "total":2304,
        "list":[
            {
                "avg_desc":483,
                "coupon_remain_quantity":24000,
                "avg_serv":483,
                "avg_lgst":483,
                "serv_pct":0.7767,
                "promotion_rate":300,
                "cat_ids":[
                    8730,
                    8818,
                    9122
                ],
                "coupon_min_order_amount":13800,
                "lgst_pct":0.7782,
                "goods_eval_score":0,
                "mall_name":"芒果TV会员旗舰店",
                "coupon_total_quantity":50000,
                "desc_pct":0.7619,
                "goods_name":"【券后3折/冲榜赢门票/华为P30】芒果tv移动影视会员12个月年卡",
                "sales_tip":"100+",
                "goods_id":21507593295,
                "opt_name":"充值",
                "goods_thumbnail_url":"https://t00img.yangkeduo.com/goods/images/2019-07-10/ef2745f4dc338d56f01abce7aeba594b.jpeg",
                "opt_id":590,
                "opt_ids":[
                    1837,
                    590,
                    1839
                ],
                "goods_image_url":"https://t00img.yangkeduo.com/goods/images/2019-07-04/eb978824-da7d-4b93-a14b-747c88166016.jpeg",
                "min_normal_price":19840,
                "min_group_price":19740,
                "coupon_start_time":1562688000,
                "coupon_discount":13800,
                "coupon_end_time":1563033599
            }
        ],
        "request_id":"15627713980221737"
    }
}

			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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