淘宝联盟API
京东联盟API
拼多多API
唯品会API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
点击获取APKEY

正常 多多进宝商品推荐API 接口测试

本接口用于查询进宝频道推广商品

接口地址: http://api.web.ecapi.cn/pinduoduo/getRecommendGoodsList
接口实例: http://api.web.ecapi.cn/pinduoduo/getRecommendGoodsList?apkey=登录会员中心查看
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围: 付费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

暂无说明

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)*必要
channel_typeNumber00-1.9包邮, 1-今日爆款, 2-品牌好货,3-相似商品推荐,4-猜你喜欢,5-实时热销,6-实时收益,7-今日畅销,8-高佣榜单,默认1
custom_parametersString{"uid":"11111","sid":"22222&q自定义参数,为链接打上自定义标签;自定义参数最长限制64个字节;格式为: {"uid":"11111","sid":"22222"} ,其中 uid 用户唯一标识,可自行加密后传入,每个用户仅且对应一个标识,必填; sid 上下文信息标识,例如sessionId等,非必填。该json字符串中也可以加入其他自定义的key
limitNumber50请求数量;默认值 : 50
list_idString翻页时建议填写前页返回的list_id值
offsetString从多少位置开始请求;默认值 : 0,offset需是limit的整数倍,仅支持整页翻页
pidString推广位id
cat_idNumber20100猜你喜欢场景的商品类目,20100-百货,20200-母婴,20300-食品,20400-女装,20500-电器,20600-鞋包,20700-内衣,20800-美妆,20900-男装,21000-水果,21100-家纺,21200-文具,21300-运动,21400-虚拟,21500-汽车,21600-家装,21700-家具,21800-医药;
goods_idsString相似商品推荐场景时必传。商品Id,请求相似商品时,仅取数组的第一位

返回参数

返回参数类型参数说明扩展说明
listJson返回数据列表
 ├ category_idString类目id
 ├ category_nameString分类名称
 ├ cat_idString商品类目id
 ├ cat_idsJson商品一~四级类目ID列表
 ├ coupon_discountNumber优惠券面额单位为分
 ├ coupon_end_timeNumber优惠券失效时间UNIX时间戳
 ├ coupon_min_order_amountString优惠券门槛价格单位为分
 ├ coupon_priceNumber优惠券金额
 ├ coupon_remain_quantityNumber优惠券剩余数量
 ├ coupon_start_timeNumber优惠券生效时间UNIX时间戳
 ├ coupon_total_quantityNumber优惠券总数量
 ├ create_atNumber创建时间
 ├ desc_txtString描述分
 ├ goods_descString商品描述
 ├ goods_gallery_urlsString商品详情图列表
 ├ goods_idNumber商品id
 ├ goods_image_urlString商品主图
 ├ goods_nameString商品名称
 ├ goods_rateNumber商品等级
 ├ goods_thumbnail_urlString商品缩略图
 ├ goods_typeNumber商品类型
 ├ has_couponString商品是否带券,true-带券,false-不带券
 ├ lgst_txtString物流分
 ├ mall_idNumber商家id
 ├ mall_nameString店铺名称
 ├ market_feeNumber市场服务费
 ├ merchant_typeString商家类型
 ├ min_group_priceNumber最小成团价格单位为分
 ├ min_normal_priceNumber最小单买价格单位为分
 ├ opt_idString商品标签类目ID
 ├ opt_idsJson商品一~四级标签类目ID列表
 ├ opt_nameString商品标签名
 ├ promotion_rateNumber佣金比例千分比
 ├ qr_code_image_urlString二维码主图
 ├ sales_tipString销售量
 ├ search_idString搜索id,建议生成推广链接时候填写,提高收益。
 ├ serv_txtString服务分
 ├ share_descString分享描述
totalNumber总数量
search_idString搜索id,建议生成推广链接时候填写,提高收益。
list_idString翻页时必填前页返回的list_id值

Json返回示例

{"code":200,"data":{"list":[{"coupon_remain_quantity":0,"promotion_rate":1,"cat_ids":[6536,7520,7523],"coupon_min_order_amount":0,"mall_id":970068671,"mall_name":"农夫山泉官方旗舰店","coupon_total_quantity":0,"merchant_type":"3","lgst_txt":"高","goods_name":"农夫山泉 NFC新疆苹果汁300mlx10瓶果汁饮料","sales_tip":"1.6万","goods_id":158588255983,"desc_txt":"高","goods_desc":"农夫山泉 NFC新疆苹果汁300mlx10瓶果汁饮料","opt_name":"食品","goods_thumbnail_url":"https://img.pddpic.com/oms_img/2020-08-09/738db62c881c52a03665004c676c6a8b.jpeg","opt_id":"1","opt_ids":[1,10724,230,8584,10696,11816,8585,8586,683,10700,12,6541,22926,11120,10038,22934,9975,8569,11833,8570,8571,219,22939,9982],"search_id":"435c11e97580149cba97b886ee64816682a","goods_image_url":"https://img.pddpic.com/oms_img/2020-08-09/116767a1-63e5-4d06-a738-32af78807e30.jpeg","has_coupon":false,"min_normal_price":7500,"serv_txt":"高","coupon_start_time":0,"min_group_price":6990,"coupon_discount":0,"coupon_end_time":0}],"total":2545,"request_id":"15970249023569971","search_id":"435c11e97580149cba97b886ee64816682a","list_id":"arwen_1755220_e38a3b42f59caf6dc2ba129c48576c76"},"msg":"success"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对