拼多多API使用须知
多多进宝设置蚂蚁星球推出开放API的目的在于，让具有开发能力的个人京东客，开发团队以及软件开发商更便捷的采集蚂蚁星球商品库的数据，实现优质好单的资源共享。使用蚂蚁星球开放API需要先申请apikey，您可以蚂蚁星球推广中心->开发管理->插件接入查看apikey，单个蚂蚁星球账号只能申请一个apikey。蚂蚁星球开放API是免费使用的，但蚂蚁星球保留对各接口进行调整的权利，我们会在调整时及时给予通知，也请您持续关注我们的公告。
接口地址： http://api-gw.haojingke.com/index.php/v1/api/pdd/goodslist
支持格式： json
请求方式： get/post
请求示例： http://api-gw.haojingke.com/index.php/v1/api/pdd/goodslist?apikey=您的apikey&page=1&page_size=20
请求参数说明：
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | String | 是 | 蚂蚁星球apikey，请将示例中的key替换成您的key |
| page | int | 否 | 第几页（默认第1页） |
| page_size | int | 否 | 1-100 默认20 |
| cat_id | string | 否 | 商品类目ID |
| opt_id | string | 否 | 商品标签类目ID |
| block_cats | string | 否 | 自定义屏蔽一级/二级/三级类目ID：多个用英文逗号分隔屏 自定义数量不超过20个;使用pdd.goods.cats.get接口获取cat_id |
| block_cat_packages | string | 否 | 蔽商品类目包：多个用英文逗号分隔屏 1-拼多多小程序屏蔽的类目&关键词;2-虚拟类目;3-医疗器械;4-处方药;5-非处方药 |
| keyword | string | 否 | 关键字，支持goods_id、拼多多长链、进宝长链搜索 |
| goods_sign | string | 否 | 商品goodsSign，支持通过goods_sign查询商品 |
| sort_type | string | 否 | 排序方式: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-服务评分击败同类店铺百分比降序 |
| with_coupon | string | 否 | 是否只返回优惠券的商品，0返回所有商品，1只返回有优惠券的商品 |
| minpgpirce | string | 否 | 最小拼购金额 |
| maxpgpirce | string | 否 | 最大拼购金额 |
| minprice | string | 否 | 最小金额 |
| maxprice | string | 否 | 最大金额 |
| mincommission | string | 否 | 最小佣金比例 |
| maxcommission | string | 否 | 最大佣金比例 |
| mindiscount | string | 否 | 最小优惠券金额 |
| maxdiscount | string | 否 | 最大优惠券金额 |
| mincommissionshare | string | 否 | 最小佣金比例 |
| maxcommissionshare | string | 否 | 最大佣金比例 |
| minsale | string | 否 | 最小销量 |
| maxsale | string | 否 | 最大销量 |
| ispg | string | 否 | 是否拼购 1拼购 |
| merchant_type | int | 否 | 调用拼多多超级搜索（isunion=1）才有效 店铺类型，1-个人，2-企业，3-旗舰店，4-专卖店，5-专营店，6-普通店（未传为全部） |
| isunion | string | 否 | isunion=1 表示返回拼多多原接口数据不做处理 返回值参考 官方文档 |
| pid | string | 否 | 拼多多官方推广位，不传使用开发者中心多多进宝设置的默认pid |
| custom_parameters | string | 否 | 自定义参数，为链接打上自定义标签；自定义参数最长限制64个字节；格式为： {"uid":"11111","sid":"22222"} ，其中 uid 用户唯一标识，可自行加密后传入，每个用户仅且对应一个标识，必填； sid 上下文信息标识 ，例如sessionId等，非必填。该json字符串中也可以加入其他自定义的key |
| predict_promotion | string | 否 | predict_promotion=1 表示返回比价参数predict_promotion_rate |
JSON返回示例：
{
"data": {
"goods_list": [
{
"goods_id": 8344870257,商品id
"goods_name": "12卷40卷48卷卫生纸批发家用卷纸巾竹浆厕纸妇婴纸手纸无芯卷筒",商品名称
"goods_short_name": "12卷40卷48卷卫生纸批发家用卷纸巾竹浆厕纸妇婴纸手纸无芯卷筒",短标题
"materiaurl": "http://mobile.yangkeduo.com/goods2.html?goods_id=8344870257",商品原链接
"goods_desc": "【您使用的纸巾够安全么?】我们生活,离不开空气和水源,在生活用品中,纸的使用也是占了生活的大部分。【买纸您是看手感?还是看掉不掉渣?还是看遇水易烂?】我们购买卫生纸,全家适用,尤其是家里有孩子和老人,更是要好好选择。【原谅当然是重中之重】纸巾很难在手感上面辨别纸巾是否安全和卫生。【恒曼品牌,达亿旗下电商新商标,与达意百慧是共同成长的品牌,多年的老品牌,线下千万顾客认证的纸品牌】采用进口原生竹浆,签署厂前供货合同,货源稳定可靠,品质保证。【喷浆精制,不爱掉渣,不添加任何荧光剂等有害物质】您买的放心,用的安心。是达亿纸业有限公司一直以来的追求和努力。【同等价格比品质,比质量,比价格,恒曼性价比高】",导购信息
"price": 11.9,原价
"price_pg": 9.9,拼购价(拼购商品才有)
"price_after": 6.9,券后价
"discount": 3,券金额
"quota": 3,满多少可用券
"picurl": "https://t00img.yangkeduo.com/goods/images/2019-06-10/193fccbb500cd2b81eb2ee5c2af8305d.jpeg",图片地址
"picurls": [
"https://t00img.yangkeduo.com/goods/images/2019-06-05/3a4cc069-ac35-495d-a4ff-c449a7e661d6.jpg",
"https://t00img.yangkeduo.com/goods/images/2019-06-18/6a886c8c-d453-4463-b848-7b59857a36a6.jpg",
"https://t00img.yangkeduo.com/goods/images/2019-06-10/ae7ec705-9c05-481a-95df-37d8b6b72ecc.jpg",
"https://t00img.yangkeduo.com/goods/images/2019-06-10/315dd56c-a67b-4d5f-99ec-8a5219cf2df5.jpg",
"https://t00img.yangkeduo.com/goods/images/2019-06-06/8419936a-3f34-4e0d-985b-623cc4f6f87a.jpg",
"https://t00img.yangkeduo.com/goods/images/2019-06-10/6dbc6e47-1ee2-4e6c-b408-1084004a4adc.jpg",
"https://t00img.yangkeduo.com/goods/images/2019-06-10/04286c4a-5c34-49dc-beaf-993a1c1a7924.jpg",
"https://t00img.yangkeduo.com/goods/images/2019-06-06/1e31ac1e-7570-4e28-be9a-8dae69dbeed3.jpg",
"https://t00img.yangkeduo.com/goods/images/2019-07-07/9e7801f0-ac1e-4aa8-a4d0-4fb6d721a4c0.jpg",
"https://t00img.yangkeduo.com/goods/images/2019-07-07/fd1fd75f-ae05-4977-a67f-d565bf0d5308.jpg"
],多图
"sales": "8.9万",销量
"start_time": 1562428800,推广开始时间
"end_time": 1562601599,推广结束时间
"pf_cid": 8590,分类id
"pf_cname": "百货",分类名称
"pdd_c_info": "a:3:{i:0;i:17285;i:1;i:17297;i:2;i:17402;}",
"ispg": 1,是否拼购 0否1是
"opt_id": 8590,标签ID
"opt_name": "百货",标签名称
"comments": 20899, 评论数量
"goodcommentsshare": 4.71, 商品评价分
"commission": 1.449, 预估佣金
"commissionshare": 21, 佣金比例
"shopid": 226035612, 店铺ID
"shopname": "恒曼居家日用官方旗舰店", 店铺名称
"has_mall_coupon": 0,,是否有店铺券 0否1是
"mall_coupon_discount_pct": 0, 店铺折扣
"mall_coupon_min_order_amount": 0, 最小使用金额
"mall_coupon_max_discount_amount": 0, 最大使用金额
"mall_coupon_total_quantity": 0, 店铺券总量
"mall_coupon_remain_quantity": 0, 店铺券余量
"mall_coupon_start_time": 0, 店铺券使用开始时间
"mall_coupon_end_time": 0, 店铺券使用结束时间
"avg_desc": 479, 描述评分
"avg_lgst": 479, 物流评分
"avg_serv": 479, 服务评分
"desc_pct": 0.8267, 描述分击败同类店铺百分比
"lgst_pct": 0.8398, 物流分击败同类店铺百分比
"serv_pct": 0.849, 服务分击败同类店铺百分比
"predict_promotion_rate": 200, 比价行为预判定佣金，需要用户备案
}
],
"totalCount": 50总数
},
"message": "success",提示信息
"status_code": 200状态码 200表示请求成功
}
}
