运营频道商品查询/实时热销/实时收益/今日畅销【最优计划】
需要授权
2040人使用

运营频道商品查询,今日销量榜,相似商品推荐,猜你喜欢(和进宝网站精选一致),实时热销榜,实时收益榜

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

offset

INTEGER

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

limit

INTEGER

10

请求数量;最大50

activity_tags

INTEGER[]

活动商品标记数组,例:[4,7],4-秒杀,7-百亿补贴,10851-千万补贴,10913-招商礼金商品,31-品牌黑标,10564-精选爆品-官方直推爆款,10584-精选爆品-团长推荐,24-品牌高佣,其他的值请忽略

cat_id

LONG

channel_type =4 时候生效,猜你喜欢场景的商品类目,20100-百货,20200-母婴,20300-食品,20400-女装,20500-电器,20600-鞋包,20700-内衣,20800-美妆,20900-男装,21000-水果,21100-家纺,21200-文具,21300-运动,21400-虚拟,21500-汽车,21600-家装,21700-家具,21800-医药;

channel_type

INTEGER

进宝频道推广商品: 1-今日销量榜,3-相似商品推荐,4-猜你喜欢(和进宝网站精选一致),5-实时热销榜,6-实时收益榜。默认值5

pid

STRING

推广位id

custom_parameters

STRING

自定义参数

goods_sign_list

STRING[]

['c9j2jeMJpYdP2PPhwfDY_DYqq8y7_J2wKjiRH3']

相似商品推荐场景时必传。goodsSign,请求相似商品时,仅取数组的第一位

list_id

STRING

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

返回参数说明

标记

类型

例子

说明

total

INTEGER

100

total

sale_num_today

LONG

100

今日成交量

sale_num24

LONG

100

成交量

serv_pct

DOUBLE

100.0

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

lgst_pct

DOUBLE

100.0

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

desc_pct

DOUBLE

100.0

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

avg_serv

LONG

100

服务评分

avg_lgst

LONG

100

物流评分

avg_desc

LONG

100

描述评分

share_desc

STRING

desc

分享描述

cat_id

STRING

1

商品类目id

goods_eval_count

LONG

1

商品评价数量

goods_eval_score

DOUBLE

1

商品评价分

market_fee

LONG

100

市场服务费

goods_rate

LONG

100

商品等级

coupon_price

LONG

100

优惠券金额

promotion_rate

LONG

100

佣金比例,千分比

coupon_end_time

LONG

100

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

coupon_start_time

LONG

100

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

coupon_remain_quantity

LONG

100

优惠券剩余数量

coupon_total_quantity

LONG

100

优惠券总数量

coupon_discount

LONG

100

优惠券面额,单位为分

coupon_min_order_amount

LONG

100

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

coupon_id

LONG

100

优惠券id

has_coupon

BOOLEAN

true

商品是否带券,true-带券,false-不带券

goods_type

INTEGER

1

商品类型

cat_ids

LONG[]

商品一~四级类目ID列表

opt_ids

LONG[]

商品一~四级标签类目ID列表

opt_name

STRING

str

商品标签名

opt_id

STRING

str

商品标签类目ID,使用pdd.goods.opt.get获取

category_name

STRING

str

分类名称

category_id

STRING

str

类目id

merchant_type

STRING

str

商家类型

mall_name

STRING

str

店铺名称

mall_id

LONG

1

商家id

min_normal_price

LONG

1

最小单买价格,单位分

min_group_price

LONG

1

最小成团价格,单位分

sales_tip

STRING

1

销售量

goods_gallery_urls

STRING

str

商品详情图列表

goods_image_url

STRING

str

商品主图

goods_thumbnail_url

STRING

str

商品缩略图

goods_desc

STRING

str

商品描述

goods_name

STRING

str

商品名称

goods_id

LONG

1

商品id

create_at

LONG

1

创建时间

predict_promotion_rate

LONG

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

lgst_txt

STRING

物流分

goods_sign

STRING

商品goods_sign

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "total":2274,
        "list":[
            {
                "category_name":"充值",
                "coupon_remain_quantity":24000,
                "serv_pct":0.7767,
                "promotion_rate":300,
                "coupon_id":1314771162,
                "service_tags":null,
                "mall_id":3649667,
                "mall_name":"芒果TV会员旗舰店",
                "desc_pct":0.7619,
                "mall_coupon_end_time":0,
                "lgst_txt":"高",
                "goods_name":"【券后3折/冲榜赢门票/华为P30】芒果tv移动影视会员12个月年卡",
                "goods_eval_count":null,
                "goods_id":21507593295,
                "goods_gallery_urls":null,
                "goods_desc":null,
                "opt_name":"充值",
                "opt_ids":[
                    1837,
                    590,
                    1839
                ],
                "goods_image_url":"https://t00img.yangkeduo.com/goods/images/2019-07-04/eb978824-da7d-4b93-a14b-747c88166016.jpeg",
                "has_mall_coupon":false,
                "min_group_price":19740,
                "coupon_start_time":1562688000,
                "coupon_discount":13800,
                "coupon_end_time":1563033599,
                "avg_desc":483,
                "mall_coupon_remain_quantity":0,
                "plan_type":2,
                "avg_serv":483,
                "avg_lgst":483,
                "crt_rf_ordr_rto1m":null,
                "cat_ids":[
                    8730,
                    8818,
                    9122
                ],
                "coupon_min_order_amount":13800,
                "lgst_pct":0.7782,
                "category_id":590,
                "mall_coupon_discount_pct":0,
                "goods_eval_score":0,
                "cat_id":null,
                "coupon_total_quantity":50000,
                "mall_coupon_min_order_amount":0,
                "merchant_type":3,
                "sales_tip":"100+",
                "plan_type_all":0,
                "mall_coupon_id":0,
                "desc_txt":"高",
                "goods_thumbnail_url":"https://t00img.yangkeduo.com/goods/images/2019-07-10/ef2745f4dc338d56f01abce7aeba594b.jpeg",
                "opt_id":590,
                "min_normal_price":19840,
                "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
            }
        ],
        "request_id":"15627714308031893"
    }
}

			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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