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

正常 查询拼多多推广商品API 接口测试

获取全部拼多多推广商品

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

使用说明

如接口返回此提示:{"code":-1,"data":{"error_response":{"error_msg":"业务服务错误","sub_msg":"关键词搜索, 授权备案参数(pid,parameter)必填, 备案详情:https://jinbao.pinduoduo.com/qa-system?questionId=204,如有问题联系ddjb@pinduoduo.com","sub_code":"60001","error_code":50001,"request_id":"16063615390895523"}},"msg":"业务服务错误"}

解决方法参考:http://dev.21ds.cn/article/546.html

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)*必要
optidNumber1商品标签类目ID,可通过:http://openapi.weimohe.cn/index/index/openapi/id/60.shtml?ptype=3 获取
keywordString衣服商品关键词,与opt_id字段选填一个或全部填写,不支持纯数字(goods_id)搜索
pageNumber1页码
pagesizeNumber100每页数据多少条,10~100
couponStringtrue是否只返含有优惠券的商品,true,是,false,否
sortNumber1排序; 排序方式:0-综合排序;1-按佣金比率升序;2-按佣金比例降序;3-按价格升序;4-按价格降序;5-按销量升序;6-按销量降序;7-优惠券金额排序升序;8-优惠券金额排序降序;9-券后价升序排序;10-券后价降序排序;11-按照加入多多进宝时间升序;12-按照加入多多进宝时间降序;13-按佣金金额升序排序;14-按佣金金额降序排序;15-店铺描述评分升序;16-店铺描述评分降序;17-店铺物流评分升序;18-店铺物流评分降序;19-店铺服务评分升序;20-店铺服务评分降序;27-描述评分击败同类店铺百分比升序,28-描述评分击败同类店铺百分比降序,29-物流评分击败同类店铺百分比升序,30-物流评分击败同类店铺百分比降序,31-服务评分击败同类店铺百分比升序,32-服务评分击败同类店铺百分比降序
range_listString[{"range_id":0,"range_from":1,"range_to范围列表,可选值:[{"range_id":0,"range_from":1,"range_to":1500},{"range_id":1,"range_from":1,"range_to":1500}]
cat_idNumber商品类目ID,使用pdd.goods.cats.get接口获取
goods_id_listString3103875972,4710158125已经废弃,不再支持该功能
zs_duo_idNumber招商多多客ID
merchant_typeNumber3店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店(未传为全部)
pidString推广位id
custom_parametersString自定义参数
activity_tagsString商品活动标记数组,例:[4,7],4-秒杀 7-百亿补贴等
is_brand_goodsString是否为品牌商品
list_idString翻页时建议填写前页返回的list_id值

返回参数

返回参数类型参数说明扩展说明
total_countNumber搜索到符合条件的结果总数
listJson商品列表
 ├ mall_cpsNumber该商品所在店铺是否参与全店推广,0:否,1:是
 ├ category_nameString商品类目名
 ├ category_idString商品类目ID
 ├ opt_idsString商品标签ID
 ├ merchant_typeNumber店铺类型1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店
 ├ serv_txtString服务评分
 ├ lgst_txtString物流评分
 ├ desc_txtString描述评分
 ├ goods_gallery_urlsString商品详情图列表
 ├ opt_nameString商品标签名
 ├ opt_idString商品标签ID格式为:[一级标签ID,二级标签ID,三级标签ID...]使用getpddgoodsopt获取
 ├ cat_idsString商品类目ID使用getpddgoodscats接口获取
 ├ goods_eval_countNumber商品评价数量
 ├ goods_descString商品描述
 ├ promotion_rateString佣金比例千分比
 ├ coupon_end_timeString优惠券失效时间
 ├ coupon_start_timeString优惠券生效时间
 ├ coupon_remain_quantityNumber优惠券剩余数量
 ├ coupon_total_quantityNumber优惠券总数量
 ├ coupon_discountString优惠券面额单位:分
 ├ coupon_min_order_amountString优惠券门槛价格单位:分
 ├ mall_nameString店铺名称
 ├ min_normal_priceString最小单买价格单位:分
 ├ min_group_priceString最小拼团价格
 ├ sales_tipNumber已售卖件数
 ├ goods_image_urlString商品主图
 ├ goods_thumbnail_urlString商品缩略图
 ├ goods_nameString商品标题
 ├ goods_idString参与多多进宝的商品ID
 ├ has_mall_couponString是否有店铺券
 ├ mall_coupon_idString店铺券id
 ├ mall_coupon_discount_pctString店铺券折扣
 ├ mall_coupon_min_order_amountString最小使用金额
 ├ mall_coupon_max_discount_amountString最大使用金额
 ├ mall_coupon_total_quantityNumber店铺券总量
 ├ mall_coupon_remain_quantityString店铺券余量
 ├ mall_coupon_start_timeString店铺券开始使用时间
 ├ mall_coupon_end_timeString店铺券结束使用时间
 ├ create_atNumber创建时间(unix时间戳)
 ├ has_couponString商品是否有优惠券 true-有,false-没有
 ├ activity_typeString活动类型0-无活动;1-秒杀;3-限量折扣;12-限时折扣;13-大促活动;14-名品折扣;15-品牌清仓;16-食品超市;17-一元幸运团;18-爱逛街;19-时尚穿搭;20-男人帮;21-9块9;22-竞价活动;23-榜单活动;24-幸运半价购;25-定金预售;26-幸运人气购;27-特色主题活动;28-断码清仓;29-一元话费;30-电器城;31-每日好店;32-品牌卡;101-大促搜索池;102-大促品类分会场;
 ├ service_tagsString服务标签4-送货入户并安装,5-送货入户,6-电子发票,9-坏果包赔,11-闪电退款,12-24小时发货,13-48小时发货,17-顺丰包邮,18-只换不修,19-全国联保,20-分期付款,24-极速退款,25-品质保障,26-缺重包退,27-当日发货,28-可定制化,29-预约配送,1000001-正品发票,1000002-送货入户并安装
 ├ clt_cpn_batch_snString店铺收藏券id
 ├ clt_cpn_start_timeString店铺收藏券起始时间
 ├ clt_cpn_end_timeString店铺收藏券截止时间
 ├ clt_cpn_quantityString店铺收藏券总量
 ├ clt_cpn_remain_quantityString店铺收藏券剩余量
 ├ clt_cpn_discountString店铺收藏券面额,单位为分
 ├ clt_cpn_min_amtString店铺收藏券使用门槛价格,单位为分
 ├ plan_typeString推广计划类型 3:定向 4:招商
 ├ zs_duo_idString招商团长id
 ├ activity_tagsString商品活动标记数组,例:[4,7],4-秒杀 7-百亿补贴等
 ├ predict_promotion_rateString比价行为预判定佣金,需要用户备案
 ├ share_rateString招商分成服务费比例,千分比
 ├ unified_tagsJson优惠标签列表
 ├ goods_signString商品goodsSign
list_idString翻页时必填前页返回的list_id值
search_idString搜索id,建议生成推广链接时候填写,提高收益

Json返回示例

{"code":200,"data":{"goods_list":[{"create_at":1530885033,"goods_id":2069404750,"goods_name":"【满50减5】内蒙南瓜子500g 新货现炒椒盐生熟原味五香散装","goods_desc":null,"goods_thumbnail_url":"http://t00img.yangkeduo.com/goods/images/2018-08-24/04cc643fa272b846e56616670d49752b.jpeg","goods_image_url":"http://t00img.yangkeduo.com/t03img/images/2018-07-04/0db3735d073263a44bc0a81a7f1a3063.jpeg","goods_gallery_urls":null,"sold_quantity":15,"min_group_price":750,"min_normal_price":850,"mall_name":"悠然干果店","merchant_type":1,"category_id":1,"category_name":"美食","opt_id":1,"opt_name":"美食","opt_ids":[96,1,228,101,219,12,2749,2751],"cat_ids":[6398,6399,6408,0],"mall_cps":0,"has_coupon":false,"coupon_min_order_amount":0,"coupon_discount":0,"coupon_total_quantity":null,"coupon_remain_quantity":null,"coupon_start_time":null,"coupon_end_time":null,"promotion_rate":0,"goods_eval_score":0,"goods_eval_count":0,"cat_id":null,"avg_desc":476,"avg_lgst":480,"avg_serv":479,"desc_pct":0.3787,"lgst_pct":0.6829,"serv_pct":0.6348},{"create_at":1533937917,"goods_id":1708387236,"goods_name":"政融集团吴博士益生菌固体饮料 肠胃肠道益生菌 依江春生命活菌","goods_desc":null,"goods_thumbnail_url":"http://t00img.yangkeduo.com/goods/images/2018-09-01/e4c91d28919fe93b7c57d90a45635c93.jpeg","goods_image_url":"","goods_gallery_urls":null,"sold_quantity":0,"min_group_price":40500,"min_normal_price":40800,"mall_name":"健康屋养生馆","merchant_type":1,"category_id":1,"category_name":"美食","opt_id":1,"opt_name":"美食","opt_ids":[1,227,100,219,1835,12,221,95],"cat_ids":[6785,6817,6822,0],"mall_cps":0,"has_coupon":false,"coupon_min_order_amount":0,"coupon_discount":0,"coupon_total_quantity":null,"coupon_remain_quantity":null,"coupon_start_time":null,"coupon_end_time":null,"promotion_rate":1,"goods_eval_score":null,"goods_eval_count":0,"cat_id":null,"avg_desc":0,"avg_lgst":0,"avg_serv":0,"desc_pct":null,"lgst_pct":null,"serv_pct":null}],"total_count":150706},"msg":"商品获取成功"}

code/http_status说明

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