拼多多API使用須知
多多進(jìn)寶設(shè)置螞蟻星球推出開放API的目的在于，讓具有開發(fā)能力的個(gè)人京東客，開發(fā)團(tuán)隊(duì)以及軟件開發(fā)商更便捷的采集螞蟻星球商品庫(kù)的數(shù)據(jù)，實(shí)現(xiàn)優(yōu)質(zhì)好單的資源共享。使用螞蟻星球開放API需要先申請(qǐng)apikey，您可以螞蟻星球推廣中心->開發(fā)管理->插件接入查看apikey，單個(gè)螞蟻星球賬號(hào)只能申請(qǐng)一個(gè)apikey。螞蟻星球開放API是免費(fèi)使用的，但螞蟻星球保留對(duì)各接口進(jìn)行調(diào)整的權(quán)利，我們會(huì)在調(diào)整時(shí)及時(shí)給予通知，也請(qǐng)您持續(xù)關(guān)注我們的公告。
聯(lián)系技術(shù)支持：712218340 點(diǎn)擊鏈接加入群聊【官方API交流群】(驗(yàn)證語(yǔ)：螞蟻星球開放平臺(tái))
接口地址： http://api-gw.haojingke.com/index.php/v1/api/pdd/goodslist
支持格式： json
請(qǐng)求方式： get/post
請(qǐng)求示例： http://api-gw.haojingke.com/index.php/v1/api/pdd/goodslist?apikey=您的apikey&page=1&page_size=20
請(qǐng)求參數(shù)說(shuō)明：
| 名稱 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| apikey | String | 是 | 螞蟻星球apikey，請(qǐng)將示例中的key替換成您的key |
| page | int | 否 | 第幾頁(yè)（默認(rèn)第1頁(yè)） |
| page_size | int | 否 | 1-100 默認(rèn)20 |
| cat_id | string | 否 | 商品類目ID |
| opt_id | string | 否 | 商品標(biāo)簽類目ID |
| block_cats | string | 否 | 自定義屏蔽一級(jí)/二級(jí)/三級(jí)類目ID：多個(gè)用英文逗號(hào)分隔屏 自定義數(shù)量不超過(guò)20個(gè);使用pdd.goods.cats.get接口獲取cat_id |
| block_cat_packages | string | 否 | 蔽商品類目包：多個(gè)用英文逗號(hào)分隔屏 1-拼多多小程序屏蔽的類目&關(guān)鍵詞;2-虛擬類目;3-醫(yī)療器械;4-處方藥;5-非處方藥 |
| keyword | string | 否 | 關(guān)鍵字，支持goods_id、拼多多長(zhǎng)鏈、進(jìn)寶長(zhǎng)鏈搜索 |
| goods_sign | string | 否 | 商品goodsSign，支持通過(guò)goods_sign查詢商品 |
| sort_type | string | 否 | 排序方式:0-綜合排序;1-按傭金比率升序;2-按傭金比例降序;3-按價(jià)格升序;4-按價(jià)格降序;5-按銷量升序;6-按銷量降序; 7-優(yōu)惠券金額排序升序;8-優(yōu)惠券金額排序降序;9-券后價(jià)升序排序;10-券后價(jià)降序排序;11-按照加入多多進(jìn)寶時(shí)間升序; 12-按照加入多多進(jìn)寶時(shí)間降序;13-按傭金金額升序排序;14-按傭金金額降序排序;15-店鋪描述評(píng)分升序;16-店鋪描述評(píng)分降序; 17-店鋪物流評(píng)分升序;18-店鋪物流評(píng)分降序;19-店鋪服務(wù)評(píng)分升序;20-店鋪服務(wù)評(píng)分降序;27-描述評(píng)分擊敗同類店鋪百分比升序， 28-描述評(píng)分擊敗同類店鋪百分比降序，29-物流評(píng)分擊敗同類店鋪百分比升序，30-物流評(píng)分擊敗同類店鋪百分比降序， 31-服務(wù)評(píng)分擊敗同類店鋪百分比升序，32-服務(wù)評(píng)分擊敗同類店鋪百分比降序 |
| with_coupon | string | 否 | 是否只返回優(yōu)惠券的商品，0返回所有商品，1只返回有優(yōu)惠券的商品 |
| minpgpirce | string | 否 | 最小拼購(gòu)金額 |
| maxpgpirce | string | 否 | 最大拼購(gòu)金額 |
| minprice | string | 否 | 最小金額 |
| maxprice | string | 否 | 最大金額 |
| mincommission | string | 否 | 最小傭金比例 |
| maxcommission | string | 否 | 最大傭金比例 |
| mindiscount | string | 否 | 最小優(yōu)惠券金額 |
| maxdiscount | string | 否 | 最大優(yōu)惠券金額 |
| mincommissionshare | string | 否 | 最小傭金比例 |
| maxcommissionshare | string | 否 | 最大傭金比例 |
| minsale | string | 否 | 最小銷量 |
| maxsale | string | 否 | 最大銷量 |
| ispg | string | 否 | 是否拼購(gòu) 1拼購(gòu) |
| merchant_type | int | 否 | 調(diào)用拼多多超級(jí)搜索（isunion=1）才有效 店鋪類型，1-個(gè)人，2-企業(yè)，3-旗艦店，4-專賣店，5-專營(yíng)店，6-普通店（未傳為全部） |
| isunion | string | 否 | isunion=1 表示返回拼多多原接口數(shù)據(jù)不做處理 返回值參考 官方文檔 |
| pid | string | 否 | 拼多多官方推廣位，不傳使用開發(fā)者中心多多進(jìn)寶設(shè)置的默認(rèn)pid |
| custom_parameters | string | 否 | 自定義參數(shù)，為鏈接打上自定義標(biāo)簽；自定義參數(shù)最長(zhǎng)限制64個(gè)字節(jié)；格式為： {"uid":"11111","sid":"22222"} ，其中 uid 用戶唯一標(biāo)識(shí)，可自行加密后傳入，每個(gè)用戶僅且對(duì)應(yīng)一個(gè)標(biāo)識(shí)，必填； sid 上下文信息標(biāo)識(shí) ，例如sessionId等，非必填。該json字符串中也可以加入其他自定義的key |
| predict_promotion | string | 否 | predict_promotion=1 表示返回比價(jià)參數(shù)predict_promotion_rate |
JSON返回示例：
{
"data": {
"goods_list": [
{
"goods_id": 8344870257,商品id
"goods_name": "12卷40卷48卷衛(wèi)生紙批發(fā)家用卷紙巾竹漿廁紙婦嬰紙手紙無(wú)芯卷筒",商品名稱
"goods_short_name": "12卷40卷48卷衛(wèi)生紙批發(fā)家用卷紙巾竹漿廁紙婦嬰紙手紙無(wú)芯卷筒",短標(biāo)題
"materiaurl": "http://mobile.yangkeduo.com/goods2.html?goods_id=8344870257",商品原鏈接
"goods_desc": "【您使用的紙巾夠安全么?】我們生活,離不開空氣和水源,在生活用品中,紙的使用也是占了生活的大部分。【買紙您是看手感?還是看掉不掉渣?還是看遇水易爛?】我們購(gòu)買衛(wèi)生紙,全家適用,尤其是家里有孩子和老人,更是要好好選擇。【原諒當(dāng)然是重中之重】紙巾很難在手感上面辨別紙巾是否安全和衛(wèi)生。【恒曼品牌,達(dá)億旗下電商新商標(biāo),與達(dá)意百慧是共同成長(zhǎng)的品牌,多年的老品牌,線下千萬(wàn)顧客認(rèn)證的紙品牌】采用進(jìn)口原生竹漿,簽署廠前供貨合同,貨源穩(wěn)定可靠,品質(zhì)保證。【噴漿精制,不愛掉渣,不添加任何熒光劑等有害物質(zhì)】您買的放心,用的安心。是達(dá)億紙業(yè)有限公司一直以來(lái)的追求和努力。【同等價(jià)格比品質(zhì),比質(zhì)量,比價(jià)格,恒曼性價(jià)比高】",導(dǎo)購(gòu)信息
"price": 11.9,原價(jià)
"price_pg": 9.9,拼購(gòu)價(jià)(拼購(gòu)商品才有)
"price_after": 6.9,券后價(jià)
"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萬(wàn)",銷量
"start_time": 1562428800,推廣開始時(shí)間
"end_time": 1562601599,推廣結(jié)束時(shí)間
"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,是否拼購(gòu) 0否1是
"opt_id": 8590,標(biāo)簽ID
"opt_name": "百貨",標(biāo)簽名稱
"comments": 20899, 評(píng)論數(shù)量
"goodcommentsshare": 4.71, 商品評(píng)價(jià)分
"commission": 1.449, 預(yù)估傭金
"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, 店鋪券使用開始時(shí)間
"mall_coupon_end_time": 0, 店鋪券使用結(jié)束時(shí)間
"avg_desc": 479, 描述評(píng)分
"avg_lgst": 479, 物流評(píng)分
"avg_serv": 479, 服務(wù)評(píng)分
"desc_pct": 0.8267, 描述分擊敗同類店鋪百分比
"lgst_pct": 0.8398, 物流分擊敗同類店鋪百分比
"serv_pct": 0.849, 服務(wù)分擊敗同類店鋪百分比
"predict_promotion_rate": 200, 比價(jià)行為預(yù)判定傭金，需要用戶備案
}
],
"totalCount": 50總數(shù)
},
"message": "success",提示信息
"status_code": 200狀態(tài)碼 200表示請(qǐng)求成功
}
}
