多多进宝商品推荐API,拼多多商品推荐API
2448人使用

多多进宝商品推荐API

可获取 1.9元包邮,今日爆款, 品牌清仓,相似商品推荐,猜你喜欢,实时热销,实时收益,今日畅销,高佣榜

特别注意!特别注意!特别注意!

目前接口里面是按照100%佣金来显示,需要自己计算根据自己的比例!

佣金政策调整:V0等级渠道分成佣金为基础佣金的70%,V1等级渠道分成佣金为基础佣金的85%。账号所处等级及对应的佣金政策可在多多进宝网站(https://jinbao.pinduoduo.com/level-right)查看



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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

channel_type

INTEGER

0-1.9元包邮, 1-今日爆款, 2-品牌清仓,3-相似商品推荐,4-猜你喜欢,5-实时热销,6-实时收益,7-今日畅销,8-高佣榜单,默认1

custom_parameters

STRING

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

limit

INTEGER

请求数量;默认值 : 400

list_id

STRING

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

offset

INTEGER

从多少位置开始请求;默认值 : 0,offset需是limit的整数倍,仅支持整页翻页

pid

STRING

推广位id

cat_id

LONG

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

goods_ids

STRING

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

返回参数说明

标记

类型

例子

说明

category_id

STRING

类目id

category_name

STRING

分类名称

cat_id

STRING

商品类目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

创建时间

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

商品类型

has_coupon

BOOLEAN

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

lgst_txt

STRING

物流分

mall_id

LONG

商家id

mall_name

STRING

店铺名称

market_fee

LONG

市场服务费

merchant_type

STRING

商家类型

min_group_price

LONG

最小成团价格,单位分

min_normal_price

LONG

最小单买价格,单位分

opt_id

STRING

商品标签类目ID

opt_ids

LONG[]

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

opt_name

STRING

商品标签名

promotion_rate

LONG

佣金比例,千分比

qr_code_image_url

STRING

二维码主图

sales_tip

STRING

销售量

search_id

STRING

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

serv_txt

STRING

服务分

share_desc

STRING

分享描述

list_id

STRING

翻页时必填前页返回的list_id值

predict_promotion_rate

LONG

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

total

INTEGER

total

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "total":2863,
        "list_id":"arwen_8516041_74cb5183afcdda1089557df119cdae97",
        "list":[
            {
                "category_name":null,
                "coupon_remain_quantity":14000,
                "promotion_rate":200,
                "cat_ids":[
                    16989,
                    16994,
                    17040
                ],
                "coupon_min_order_amount":2000,
                "goods_fact_price":null,
                "category_id":null,
                "mall_id":939205403,
                "share_desc":null,
                "cat_id":null,
                "coupon_price":null,
                "mall_name":"亿家净健康生活",
                "coupon_total_quantity":50000,
                "goods_rate":null,
                "market_fee":null,
                "merchant_type":"1",
                "lgst_txt":"高",
                "goods_name":"50只一次性含熔喷层防护防尘三层透气口罩男女成人学生",
                "sales_tip":"1.6万",
                "goods_mark_price":null,
                "goods_gallery_urls":null,
                "goods_id":104633631487,
                "qr_code_image_url":null,
                "desc_txt":"高",
                "goods_desc":"50只一次性含熔喷层防护防尘三层透气口罩男女成人学生",
                "opt_name":"海淘",
                "goods_thumbnail_url":"https://t00img.yangkeduo.com/goods/images/2020-04-12/9b2621315579e9a112db69969c06884a.jpeg",
                "opt_id":"12",
                "opt_ids":[
                    294,
                    9831,
                    10696,
                    9832,
                    20712,
                    10729,
                    329,
                    11561,
                    12,
                    8590,
                    10702,
                    8591,
                    15,
                    367,
                    20527,
                    8592,
                    20530,
                    9846,
                    11254,
                    20534,
                    8569,
                    8570,
                    8571,
                    223
                ],
                "search_id":"4275f9521204f4231903235c8d1cbccaac2",
                "goods_image_url":"https://t00img.yangkeduo.com/goods/images/2020-04-12/dec99b94-f84e-407d-b6f9-5b160451b35a.png",
                "has_coupon":true,
                "min_normal_price":3980,
                "serv_txt":"高",
                "goods_type":null,
                "create_at":null,
                "coupon_start_time":1591113600,
                "min_group_price":3780,
                "coupon_discount":2000,
                "coupon_end_time":1591631999
            }
        ],
        "request_id":"15912740022918558",
        "search_id":"4275f9521204f4231903235c8d1cbccaac2"
    }
}
			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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