淘宝联盟API

京东联盟API

数据接口API

点击获取APKEY

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

获取全部拼多多推广商品

接口地址： 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":"业务服务错误"}
解决方法参考：http://www.ecapi.cn/index/article/detail/id/4846776999819282.shtml

请求参数

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

返回参数

返回参数	类型	参数说明	扩展说明
total_count	Number	返回商品总数
list	Json	商品列表
├　goods_sign	String	商品goodsSign
├　unified_tags	Json	优惠标签列表
├　share_rate	String	招商分成服务费比例，千分比
├　predict_promotion_rate	String	比价行为预判定佣金，需要用户备案
├　activity_tags	String	商品活动标记数组，例：[4,7]，4-秒杀 7-百亿补贴等
├　zs_duo_id	String	招商团长id
├　plan_type	String	推广计划类型 3:定向 4:招商
├　clt_cpn_min_amt	String	店铺收藏券使用门槛价格，单位为分
├　clt_cpn_discount	String	店铺收藏券面额，单位为分
├　clt_cpn_remain_quantity	String	店铺收藏券剩余量
├　clt_cpn_quantity	String	店铺收藏券总量
├　clt_cpn_end_time	String	店铺收藏券截止时间
├　clt_cpn_start_time	String	店铺收藏券起始时间
├　clt_cpn_batch_sn	String	店铺收藏券id
├　service_tags	String	服务标签	4-送货入户并安装,5-送货入户,6-电子发票,9-坏果包赔,11-闪电退款,12-24小时发货,13-48小时发货,17-顺丰包邮,18-只换不修,19-全国联保,20-分期付款,24-极速退款,25-品质保障,26-缺重包退,27-当日发货,28-可定制化,29-预约配送,1000001-正品发票,1000002-送货入户并安装
├　activity_type	String	活动类型	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_coupon	String	商品是否有优惠券 true-有，false-没有
├　create_at	Number	创建时间（unix时间戳）
├　mall_coupon_end_time	String	店铺券结束使用时间
├　mall_coupon_start_time	String	店铺券开始使用时间
├　mall_coupon_remain_quantity	String	店铺券余量
├　mall_coupon_total_quantity	Number	店铺券总量
├　mall_coupon_max_discount_amount	String	最大使用金额
├　mall_coupon_min_order_amount	String	最小使用金额
├　mall_coupon_discount_pct	String	店铺券折扣
├　mall_coupon_id	String	店铺券id
├　has_mall_coupon	String	是否有店铺券
├　goods_id	String	参与多多进宝的商品ID
├　goods_name	String	商品标题
├　goods_thumbnail_url	String	商品缩略图
├　goods_image_url	String	商品主图
├　sales_tip	Number	已售卖件数
├　min_group_price	String	最小拼团价格
├　min_normal_price	String	最小单买价格	单位：分
├　mall_name	String	店铺名称
├　coupon_min_order_amount	String	优惠券门槛价格	单位：分
├　coupon_discount	String	优惠券面额	单位：分
├　coupon_total_quantity	Number	优惠券总数量
├　coupon_remain_quantity	Number	优惠券剩余数量
├　coupon_start_time	String	优惠券生效时间
├　coupon_end_time	String	优惠券失效时间
├　promotion_rate	String	佣金比例	千分比
├　goods_desc	String	商品描述
├　goods_eval_count	Number	商品评价数量
├　cat_ids	String	商品类目ID	使用getpddgoodscats接口获取
├　opt_id	String	商品标签ID	格式为：[一级标签ID，二级标签ID，三级标签ID...]使用getpddgoodsopt获取
├　opt_name	String	商品标签名
├　goods_gallery_urls	String	商品详情图列表
search_id	String	搜索id，建议生成推广链接时候填写，提高收益
list_id	String	翻页时必填前页返回的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	数据获取失败
401	IP没有添加白名单
429	访问次数超限
403	关键参数丢失
405	请求方式不对

【公告】

数据接口API

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

使用说明

请求参数

返回参数

Json返回示例

code/http_status说明

电话：0531-6896-1851