拼多多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表示請求成功
}
}
