淘宝客API
京东API
拼多多API
唯品会API
苏宁API
开放平台API
美团平台
文娱餐饮
考拉海购
点击获取APKEY

正常 [新]查询拼多多推广商品API

更新时间:2021-08-31 14:41:49

接口地址: http://api.web.ecapi.cn/pinduoduo/goodsSearch
接口实例: http://api.web.ecapi.cn/pinduoduo/goodsSearch?apkey=登录会员中心查看&pdname=13211111111&page=1&page_size=10
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行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":"业务服务错误"}

解决方法参考:https://www.ecapi.cn/index/article/detail/id/4846776999819282.shtml

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)*必要
pdnameString13211111111在本平台授权的拼多多账户名
pageNumber1页码
page_sizeString10每页数量
activity_tagsString4,7,31活动商品标记数组,例:[4,7],4-秒杀,7-百亿补贴,31-品牌黑标,10564-精选爆品-官方直推爆款,10584-精选爆品-团长推荐,24-品牌高佣,20-行业精选,21-金牌商家,10044-潜力爆品,10475-爆品上新,10666-开年暖心补贴类目,其他的值请忽略
cat_idString商品类目ID,使用pdd.goods.cats.get接口获取
custom_parametersString{"uid":"11111","sid":"22222&q自定义参数,为链接打上自定义标签;自定义参数最长限制64个字节;格式为: {"uid":"11111","sid":"22222"} ,其中 uid 用户唯一标识,可自行加密后传入,每个用户仅且对应一个标识,必填; sid 上下文信息标识,例如sessionId等,非必填。该json字符串中也可以加入其他自定义的key
goods_sign_listStringxxxx,aaaaa,bbbbgoodsSign列表,支持通过goodsSign查询商品,使用说明:https://jinbao.pinduoduo.com/qa-system?questionId=252
is_brand_goodsStringtrue是否为品牌商品
keywordString商品关键词,与opt_id字段选填一个或全部填写。可支持goods_id、拼多多链接(即拼多多app商详的链接)、进宝长链/短链
list_idString翻页时建议填写前页返回的list_id值
merchant_typeString2店铺类型,1-个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店(未传为全部)
merchant_type_listString店铺类型,多个,分隔
opt_idString商品标签类目ID
pidString推广位id
range_fromString筛选范围区间的开始值
range_idString筛选范围,1-券后价;2-佣金比例;5-销量;6-佣金金额
range_toString筛选范围区间的结束值
sort_typeString0排序方式:0-综合排序;2-按佣金比例降序;3-按价格升序;4-按价格降序;6-按销量降序;9-券后价升序排序;10-券后价降序排序;16-店铺描述评分降序
with_couponStringtrue是否只返回优惠券的商品,false返回所有商品,true只返回有优惠券的商品
block_catsStringaaa,bbb,ccc自定义屏蔽一级/二级/三级类目ID,自定义数量不超过20个;使用pdd.goods.cats.get接口获取cat_id
block_cat_packagesString1,2,3屏蔽商品类目包:1-拼多多小程序屏蔽的类目&关键词;2-虚拟类目;3-医疗器械;4-处方药;5-非处方药

返回参数

返回参数类型参数说明扩展说明
total_countNumber返回商品总数
listJson商品列表
 ├ goods_signString商品goodsSign
 ├ unified_tagsJson优惠标签列表
 ├ share_rateString招商分成服务费比例,千分比
 ├ predict_promotion_rateString比价行为预判定佣金,需要用户备案
 ├ activity_tagsString商品活动标记数组,例:[4,7],4-秒杀 7-百亿补贴等
 ├ zs_duo_idString招商团长id
 ├ plan_typeString推广计划类型 3:定向 4:招商
 ├ clt_cpn_min_amtString店铺收藏券使用门槛价格,单位为分
 ├ clt_cpn_discountString店铺收藏券面额,单位为分
 ├ clt_cpn_remain_quantityString店铺收藏券剩余量
 ├ clt_cpn_quantityString店铺收藏券总量
 ├ clt_cpn_end_timeString店铺收藏券截止时间
 ├ clt_cpn_start_timeString店铺收藏券起始时间
 ├ clt_cpn_batch_snString店铺收藏券id
 ├ service_tagsString服务标签4-送货入户并安装,5-送货入户,6-电子发票,9-坏果包赔,11-闪电退款,12-24小时发货,13-48小时发货,17-顺丰包邮,18-只换不修,19-全国联保,20-分期付款,24-极速退款,25-品质保障,26-缺重包退,27-当日发货,28-可定制化,29-预约配送,1000001-正品发票,1000002-送货入户并安装
 ├ 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-大促品类分会场;
 ├ has_couponString商品是否有优惠券 true-有,false-没有
 ├ create_atNumber创建时间(unix时间戳)
 ├ mall_coupon_end_timeString店铺券结束使用时间
 ├ mall_coupon_start_timeString店铺券开始使用时间
 ├ mall_coupon_remain_quantityString店铺券余量
 ├ mall_coupon_total_quantityNumber店铺券总量
 ├ mall_coupon_max_discount_amountString最大使用金额
 ├ mall_coupon_min_order_amountString最小使用金额
 ├ mall_coupon_discount_pctString店铺券折扣
 ├ mall_coupon_idString店铺券id
 ├ has_mall_couponString是否有店铺券
 ├ goods_idString参与多多进宝的商品ID
 ├ goods_nameString商品标题
 ├ goods_thumbnail_urlString商品缩略图
 ├ goods_image_urlString商品主图
 ├ sales_tipNumber已售卖件数
 ├ min_group_priceString最小拼团价格
 ├ min_normal_priceString最小单买价格单位:分
 ├ mall_nameString店铺名称
 ├ coupon_min_order_amountString优惠券门槛价格单位:分
 ├ coupon_discountString优惠券面额单位:分
 ├ coupon_total_quantityNumber优惠券总数量
 ├ coupon_remain_quantityNumber优惠券剩余数量
 ├ coupon_start_timeString优惠券生效时间
 ├ coupon_end_timeString优惠券失效时间
 ├ promotion_rateString佣金比例千分比
 ├ goods_descString商品描述
 ├ goods_eval_countNumber商品评价数量
 ├ cat_idsString商品类目ID使用getpddgoodscats接口获取
 ├ opt_idString商品标签ID格式为:[一级标签ID,二级标签ID,三级标签ID...]使用getpddgoodsopt获取
 ├ opt_nameString商品标签名
 ├ goods_gallery_urlsString商品详情图列表
search_idString搜索id,建议生成推广链接时候填写,提高收益
list_idString翻页时必填前页返回的list_id值

Json返回示例

{"code":200,"data":{"list":[{"mall_coupon_remain_quantity":0,"plan_type":2,"category_name":"洗护","coupon_remain_quantity":42500,"promotion_rate":300,"cat_ids":[17285,17286,17325],"coupon_min_order_amount":2000,"category_id":10110,"service_tags":[24,27],"mall_coupon_discount_pct":0,"mall_id":8280550,"mall_name":"勇闯天涯皮具","coupon_total_quantity":50000,"mall_coupon_end_time":0,"mall_coupon_min_order_amount":0,"merchant_type":1,"lgst_txt":"低","goods_name":"【全国爆卖】牙膏竹炭黑牙膏美白牙齿美白神器去黄牙结石去口臭","sales_tip":"10万 ","only_scene_auth":true,"goods_id":132599975675,"predict_promotion_rate":300,"desc_txt":"低","mall_coupon_id":0,"goods_desc":"【全国爆卖】牙膏竹炭黑牙膏美白牙齿美白神器去黄牙结石去口臭","opt_name":"洗护","share_rate":0,"goods_thumbnail_url":"https://t00img.yangkeduo.com/goods/images/2020-07-31/4e29bb906929a537bd8e876cfc9f3232.jpeg","opt_ids":[10113,11201,22146,10696,328,10697,12,8590,10702,8591,15,10127,8592,10710,407,21919,10730,299,304,11187,20787,22134,8569,8570,8571,10110],"opt_id":10110,"search_id":"5cec2188ddd6947f4afd459729eb01a6f6c","goods_image_url":"https://img.pddpic.com/mms-material-img/2020-07-31/ff7b5cd4-c9a8-4d74-9808-843c34e4fa45.jpg.a.jpeg","activity_tags":[10666,10000,21],"has_mall_coupon":false,"has_coupon":true,"min_normal_price":3289,"mall_coupon_start_time":0,"serv_txt":"低","mall_coupon_total_quantity":0,"mall_coupon_max_discount_amount":0,"coupon_start_time":1610294400,"min_group_price":2990,"mall_cps":1,"coupon_discount":2000,"goods_sign":"c9X2vLXd8G9GIOuhwfDYnELevpBv_J4YeNdmtU","coupon_end_time":1614614399,"zs_duo_id":0}],"total_count":6000,"list_id":"1610780776133_c18bc7ec451014de66a30457d692d8dc","search_id":"5cec2188ddd6947f4afd459729eb01a6f6c"},"msg":"success"}

code/http_status说明

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