京東API使用須知
京東聯盟設置螞蟻星球推出開放API的目的在于,讓具有開發能力的個人京東客,開發團隊以及軟件開發商更便捷的采集螞蟻星球商品庫的數據,實現優質好單的資源共享。使用螞蟻星球開放API需要先申請apikey,您可以螞蟻星球推廣中心->開發管理->插件接入查看apikey,單個螞蟻星球賬號只能申請一個apikey。螞蟻星球開放API是免費使用的,但螞蟻星球保留對各接口進行調整的權利,我們會在調整時及時給予通知,也請您持續關注我們的公告。
接口地址: http://api-gw.haojingke.com/index.php/v1/api/jd/goodslist
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/goodslist?apikey=您的apikey&pageindex=1&pagesize=20
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
pageindex | int | 否 | 第幾頁(默認第1頁) |
pagesize | int | 否 | 1-100 默認20 |
cid1 | string | 否 | 一級類目id |
cid2 | string | 否 | 二級類目id |
cid3 | string | 否 | 三級類目id |
cid3 | string | 否 | 三級類目id |
goods_ids | string | 否 | 京東商品ID,多個用英文逗號分隔 |
itemIds | string | 否 | 聯盟商品ID集合(一次最多支持查詢20個itemId),多個用英文逗號分隔 |
keyword | string | 否 | 關鍵字 |
minprice | string | 否 | 最小金額 |
maxprice | string | 否 | 最大金額 |
mincommission | string | 否 | 最小傭金 |
maxcommission | string | 否 | 最大傭金 |
sortname | string | 否 | 1 單價 2傭金比例 3傭金 4銷量 |
sort | string | 否 | asc 升序 desc 降序 默認降序 |
ispg | string | 否 | 是否拼購 1拼購 |
iscoupon | int | 否 | 是否有券 1只查有券 默認1 |
minpgpirce | number | 否 | 最小拼購金額 |
maxpgpirce | number | 否 | 最大拼購金額 |
ishot | number | 否 | 1爆品0非爆品 |
owner | string | 否 | g 自營 ,p POP |
brandcode | number | 否 | 品牌code |
shopid | number | 否 | 店鋪Id |
isunion | string | 否 | isunion=1 表示返回京東原接口數據不做處理 返回值參考京東聯盟 官方文檔 |
JSON返回示例:
{ "data": { "data": [ { "goods_id": "25980119611",商品id "goods_name": "雅詩泉口紅唇膏持久保濕不脫色滋潤孕婦可用口紅不沾杯女士學生 氣質淺粉色",商品名稱 "goods_short_name": " 雅詩泉口紅唇膏持久保濕不脫色",短標題 "materiaurl": "item.jd.com/25980119611.html",商品原鏈接 "goods_desc": "天然健康配方,孕婦可用,滋潤保濕,淡化唇紋,持久防水不沾杯,夢幻溫感變色,護唇美唇兩不誤!",導購信息 "price": "39.90",原價 "price_pg": "0.00",拼購價(拼購商品才有) "price_after": "19.90",券后價 "discount": "20.0",券金額 "bindtype": "3",券種類 "quota": "39.00",滿多少可用券 "picurl": "https://img.91fyt.com/c000ed32ea0c646e7745d2a90e4be0734f284e9a8a6f1ae70Ec7DYEbQG.jpg",圖片地址 "picurls": "http://img14.360buyimg.com/ads/jfs/t17569/64/948512377/34369/732e2360/5ab3262fN4eb59cb1.jpg,http://img14.360buyimg.com/ads/jfs/t13549/328/2570853349/120152/f11eeaaf/5aa0ede7N11b66f8e.jpg,http://img14.360buyimg.com/ads/jfs/t14995/345/2441647593/131237/36c4b18c/5aa0ecbfN6aae8fc5.jpg,http://img14.360buyimg.com/ads/jfs/t15397/309/2495673175/214807/f1d556c4/5aa0ecbfNd22195d2.jpg,http://img14.360buyimg.com/ads/jfs/t16552/41/2323101598/197292/3dccdb6c/5aa0ecbfN97f93cde.jpg,http://img14.360buyimg.com/ads/jfs/t19339/163/693116176/186505/ed707c88/5aa0ecbfN0f3870ac.jpg",多圖 "couponurl": "http://coupon.m.jd.com/coupons/show.action?key=1f7c51b0bf6744abafb4777e90164538&roleId=20781614&to=mall.jd.com/index-166851.html",優惠券鏈接 "sales": 155,30天引單數量 "start_time": 1559059200,推廣開始時間 "end_time": 1564588799,推廣結束時間 "pf_cid1": 1316,一級分類id "pf_cid2": 1387,二級分類id "pf_cid3": 1425,三級分類id "pf_cname1": "美妝護膚",一級分類名稱 "pf_cname2": "香水彩妝",二級分類名稱 "pf_cname3": "口紅",三級分類名稱 "jd_c_info": "O:8:\"stdClass\":6:{s:4:\"cid1\";i:1316;s:8:\"cid1Name\";s:12:\"美妝護膚\";s:4:\"cid2\";i:1387;s:8:\"cid2Name\";s:12:\"香水彩妝\";s:4:\"cid3\";i:1425;s:8:\"cid3Name\";s:6:\"口紅\";}", "ispg": 0,是否拼購 0否1是 "ishot": 1,是否爆款 0否1是 "owner": "p",g=自營,p=pop "brandcode": "66737",品牌ID "brandname": "雅詩泉(ARSYCHLL)",品牌名稱 "comments": 416, 評論數 "goodcommentsshare": "94.00", 商品好評率 "commission": "10.75", 預估傭金 "commissionshare": "60.00", 傭金比例 "shopid": "166851", 店鋪ID "shopname": "芊植本草化妝品專營店", 店鋪名稱 "spuid": "25980119602" 同款商品的主skuid "ordercommission": 16940.9, 月支出傭金 "coupon_remain_quantity": 49998, 優惠券剩余數量 "coupon_total_quantity": 50000, 優惠券總數量 "coupon_take_quantity": 2, 優惠券領取數量(每天更新一次,如要看實時領券量請自行調用優惠券查詢接口) "is_jdwl": "0", 是否京東物流0否1是 } ], "total": 44總數 }, "message": "success",提示信息 "status_code": 200狀態碼 200表示請求成功 }
熱推榜: http://api-gw.haojingke.com/index.php/v1/api/jd/getgoodshot?apikey=您的apikey&pageindex=1&pagesize=20
熱銷榜: http://api-gw.haojingke.com/index.php/v1/api/jd/getgoodsbd?apikey=您的apikey&activityid=10000&pageindex=1&pagesize=20
熱搜榜: http://api-gw.haojingke.com/index.php/v1/api/jd/getgoodsbd?apikey=您的apikey&activityid=10001&pageindex=1&pagesize=20
領券榜: http://api-gw.haojingke.com/index.php/v1/api/jd/goodslist?apikey=您的apikey&sortname=4&sort=desc&pageindex=1&pagesize=20
月銷榜: http://api-gw.haojingke.com/index.php/v1/api/jd/goodslist?apikey=您的apikey&sortname=5&sort=desc&pageindex=1&pagesize=20
支持格式: json
請求方式: get/post
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
pageindex | int | 否 | 第幾頁(默認第1頁) |
pagesize | int | 否 | 1-100 默認20 |
JSON返回示例:
{ "data": { "goods_id": "25980119611",商品id "goods_name": "雅詩泉口紅唇膏持久保濕不脫色滋潤孕婦可用口紅不沾杯女士學生 氣質淺粉色",商品名稱 "goods_short_name": " 雅詩泉口紅唇膏持久保濕不脫色",短標題 "materiaurl": "item.jd.com/25980119611.html",商品原鏈接 "goods_desc": "天然健康配方,孕婦可用,滋潤保濕,淡化唇紋,持久防水不沾杯,夢幻溫感變色,護唇美唇兩不誤!",導購信息 "price": "39.90",原價 "price_pg": "0.00",拼購價(拼購商品才有) "price_after": "19.90",券后價 "discount": "20.0",券金額 "bindtype": "3",券種類 "quota": "39.00",滿多少可用券 "picurl": "https://img.91fyt.com/c000ed32ea0c646e7745d2a90e4be0734f284e9a8a6f1ae70Ec7DYEbQG.jpg",圖片地址 "picurls": "http://img14.360buyimg.com/ads/jfs/t17569/64/948512377/34369/732e2360/5ab3262fN4eb59cb1.jpg,http://img14.360buyimg.com/ads/jfs/t13549/328/2570853349/120152/f11eeaaf/5aa0ede7N11b66f8e.jpg,http://img14.360buyimg.com/ads/jfs/t14995/345/2441647593/131237/36c4b18c/5aa0ecbfN6aae8fc5.jpg,http://img14.360buyimg.com/ads/jfs/t15397/309/2495673175/214807/f1d556c4/5aa0ecbfNd22195d2.jpg,http://img14.360buyimg.com/ads/jfs/t16552/41/2323101598/197292/3dccdb6c/5aa0ecbfN97f93cde.jpg,http://img14.360buyimg.com/ads/jfs/t19339/163/693116176/186505/ed707c88/5aa0ecbfN0f3870ac.jpg",多圖 "couponurl": "http://coupon.m.jd.com/coupons/show.action?key=1f7c51b0bf6744abafb4777e90164538&roleId=20781614&to=mall.jd.com/index-166851.html",優惠券鏈接 "sales": 155,30天引單數量 "start_time": 1559059200,推廣開始時間 "end_time": 1564588799,推廣結束時間 "pf_cid1": 1316,一級分類id "pf_cid2": 1387,二級分類id "pf_cid3": 1425,三級分類id "pf_cname1": "美妝護膚",一級分類名稱 "pf_cname2": "香水彩妝",二級分類名稱 "pf_cname3": "口紅",三級分類名稱 "jd_c_info": "O:8:\"stdClass\":6:{s:4:\"cid1\";i:1316;s:8:\"cid1Name\";s:12:\"美妝護膚\";s:4:\"cid2\";i:1387;s:8:\"cid2Name\";s:12:\"香水彩妝\";s:4:\"cid3\";i:1425;s:8:\"cid3Name\";s:6:\"口紅\";}", "ispg": 0,是否拼購 0否1是 "ishot": 1,是否爆款 0否1是 "owner": "p",g=自營,p=pop "brandcode": "66737",品牌ID "brandname": "雅詩泉(ARSYCHLL)",品牌名稱 "comments": 416, 評論數 "goodcommentsshare": "94.00", 商品好評率 "commission": "10.75", 預估傭金 "commissionshare": "60.00", 傭金比例 "shopid": "166851", 店鋪ID "shopname": "芊植本草化妝品專營店", 店鋪名稱 "spuid": "25980119602" 同款商品的主skuid "ordercommission": 16940.9, 月支出傭金 "coupon_remain_quantity": 49998, 優惠券剩余數量 "coupon_total_quantity": 50000, 優惠券總數量 "coupon_take_quantity": 2, 優惠券領取數量(每天更新一次,如要看實時領券量請自行調用優惠券查詢接口) "is_jdwl": "0", 是否京東物流0否1是 }, "message": "success",提示信息 "status_code": 200狀態碼 200表示請求成功 }
接口地址: http://api-gw.haojingke.com/index.php/v1/api/jd/goodsdetail
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/goodsdetail?apikey=您的apikey&goods_id=66982790389
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
goods_id | string | 是 | skuid 商品id或者聯盟商品id(聯盟商品ID)或二合一鏈接 |
itemId | string | 否 | 聯盟商品ID |
isunion | string | 否 | isunion=1 表示返回京東原接口數據不做處理 返回值參考京東聯盟 官方文檔 |
JSON返回示例:
{ "data": { "goods_id": "25980119611",商品id "goods_name": "雅詩泉口紅唇膏持久保濕不脫色滋潤孕婦可用口紅不沾杯女士學生 氣質淺粉色",商品名稱 "goods_short_name": " 雅詩泉口紅唇膏持久保濕不脫色",短標題 "materiaurl": "item.jd.com/25980119611.html",商品原鏈接 "goods_desc": "天然健康配方,孕婦可用,滋潤保濕,淡化唇紋,持久防水不沾杯,夢幻溫感變色,護唇美唇兩不誤!",導購信息 "price": "39.90",原價 "price_pg": "0.00",拼購價(拼購商品才有) "price_after": "19.90",券后價 "discount": "20.0",券金額 "bindtype": "3",券種類 "quota": "39.00",滿多少可用券 "picurl": "https://img.91fyt.com/c000ed32ea0c646e7745d2a90e4be0734f284e9a8a6f1ae70Ec7DYEbQG.jpg",圖片地址 "picurls": "http://img14.360buyimg.com/ads/jfs/t17569/64/948512377/34369/732e2360/5ab3262fN4eb59cb1.jpg,http://img14.360buyimg.com/ads/jfs/t13549/328/2570853349/120152/f11eeaaf/5aa0ede7N11b66f8e.jpg,http://img14.360buyimg.com/ads/jfs/t14995/345/2441647593/131237/36c4b18c/5aa0ecbfN6aae8fc5.jpg,http://img14.360buyimg.com/ads/jfs/t15397/309/2495673175/214807/f1d556c4/5aa0ecbfNd22195d2.jpg,http://img14.360buyimg.com/ads/jfs/t16552/41/2323101598/197292/3dccdb6c/5aa0ecbfN97f93cde.jpg,http://img14.360buyimg.com/ads/jfs/t19339/163/693116176/186505/ed707c88/5aa0ecbfN0f3870ac.jpg",多圖 "couponurl": "http://coupon.m.jd.com/coupons/show.action?key=1f7c51b0bf6744abafb4777e90164538&roleId=20781614&to=mall.jd.com/index-166851.html",優惠券鏈接 "sales": 155,30天引單數量 "start_time": 1559059200,推廣開始時間 "end_time": 1564588799,推廣結束時間 "pf_cid1": 1316,一級分類id "pf_cid2": 1387,二級分類id "pf_cid3": 1425,三級分類id "pf_cname1": "美妝護膚",一級分類名稱 "pf_cname2": "香水彩妝",二級分類名稱 "pf_cname3": "口紅",三級分類名稱 "jd_c_info": "O:8:\"stdClass\":6:{s:4:\"cid1\";i:1316;s:8:\"cid1Name\";s:12:\"美妝護膚\";s:4:\"cid2\";i:1387;s:8:\"cid2Name\";s:12:\"香水彩妝\";s:4:\"cid3\";i:1425;s:8:\"cid3Name\";s:6:\"口紅\";}", "ispg": 0,是否拼購 0否1是 "ishot": 1,是否爆款 0否1是 "owner": "p",g=自營,p=pop "brandcode": "66737",品牌ID "brandname": "雅詩泉(ARSYCHLL)",品牌名稱 "comments": 416, 評論數 "goodcommentsshare": "94.00", 商品好評率 "commission": "10.75", 預估傭金 "commissionshare": "60.00", 傭金比例 "shopid": "166851", 店鋪ID "shopname": "芊植本草化妝品專營店", 店鋪名稱 "spuid": "25980119602" 同款商品的主skuid "ordercommission": 16940.9, 月支出傭金 "coupon_remain_quantity": 49998, 優惠券剩余數量 "coupon_total_quantity": 50000, 優惠券總數量 "coupon_take_quantity": 2, 優惠券領取數量(每天更新一次,如要看實時領券量請自行調用優惠券查詢接口) "is_jdwl": "0", 是否京東物流0否1是 "commentInfo": { 評論 "commentList": [ { "content": "盤子挺好的,比家里的少一點,簡極大方,勺子筷子。也不錯,包裝的很仔細,沒有一點破損。沾了油漬很好洗。釉面光滑。四個小碗、四個碟子.四個小勺,很超級。比我想象中出乎意料的好。", "imageList": [ { "url": "http://img14.360buyimg.com/ads/jfs/t1/108293/36/12651/83234/5e99bc5aEe0d10bb3/a96f97536a3723ff.jpg" }, { "url": "http://img14.360buyimg.com/ads/jfs/t1/112773/25/1625/70335/5e99bc5aE56ed689f/f7a390d42ccd96d6.jpg" } ] }, { "content": "盤子挺好的,釉面平滑,帶個黑邊很好看,簡潔大方。勺子筷子都不錯,這個盤子挺大的。份量也可以,包裝的很仔細,沒有一點破損,特別不錯??發貨超級的迅速,勺子包裝的也是很仔細,沒有一點磕碰的痕跡,筷子也不錯,這個價位買到這樣的品質,非常滿意。", "imageList": [ { "url": "http://img14.360buyimg.com/ads/jfs/t1/87106/31/17427/146503/5e8853d0E0493ab03/de422af46812a5c6.jpg" } ] }, { "content": "美觀程度:非常好看\n使用難易:好用,大小合適\n瓷質效果:很好\n瓷質品質:非常好\n質地效果:很厚實\n釉面品質:很好,沒有一點瑕疵,", "imageList": [ { "url": "http://img14.360buyimg.com/ads/jfs/t1/98658/16/18875/180790/5e99127bEd8efb546/8c7ab8820d38b65f.jpg" } ] } ] }, "videoInfo": { 視頻 "videoList": [ { "duration": 28, "high": 720, "imageUrl": "https://img.300hu.com/4c1f7a6atransbjngwcloud1oss/391fa280299141690550702081/imageSampleSnapshot/1586056953_499130463.100_2826.jpg", "playType": "low", "playUrl": "https://vod.300hu.com/4c1f7a6atransbjngwcloud1oss/391fa280299141690550702081/v.f20.mp4?dockingId=5ddb5957-03e9-4a88-9100-b24dc88d0215&storageSource=3", "videoType": 1, "width": 1280 }, { "duration": 28, "high": 720, "imageUrl": "https://img.300hu.com/4c1f7a6atransbjngwcloud1oss/391fa280299141690550702081/imageSampleSnapshot/1586056953_499130463.100_2826.jpg", "playType": "high", "playUrl": "https://vod.300hu.com/4c1f7a6atransbjngwcloud1oss/391fa280299141690550702081/v.f30.mp4?dockingId=6221b1d7-ea0b-44f9-81df-8273d463ee33&storageSource=3", "videoType": 1, "width": 1280 } ] }, "message": "success",提示信息 "status_code": 200狀態碼 200表示請求成功 }
接口地址: http://api-gw.haojingke.com/index.php/v1/api/jd/themelist
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/themelist?apikey=您的apikey
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
pageindex | int | 否 | 第幾頁(默認第1頁) |
pagesize | int | 否 | 1-10 默認10 |
JSON返回示例:
{ "data": { "data": [ { "themeid": 10004, "themename": "美妝護膚專場", "start_time": 1592323200, "end_time": 1593532799, "logo": "http://img.haojingke.com/a602f3b94e79390de0afc9a12fbc36ecaa674ab8924db2d8QM0VuZewQj.png", "banner": "http://img.haojingke.com/91a1c169b733669d5c668f1f6db56ee64ffb08428bd7e1d8xo1cOu9SqZ.png", "title": "美妝護膚專場", "remark": "618女生福利,做最美的自己", "goodslist": [ { "activityid": 10004, "goods_id": 61666446218, "goods_name": "手工蠶絲皂護膚皂拉絲蛋白皂拉絲潔面沐浴香皂除螨海鹽皂 蠶絲皂 一盒裝", "goods_short_name": "手工蠶絲皂護膚皂拉絲蛋白皂拉絲潔面沐浴香皂除螨海鹽皂 蠶絲皂 一盒裝", "materiaurl": "item.jd.com/61666446218.html", "goods_desc": "手工蠶絲皂護膚皂拉絲蛋白皂拉絲潔面沐浴香皂除螨海鹽皂 蠶絲皂 一盒裝", "price": "29.90", "price_pg": "12.90", "price_after": "10.90", "discount": "2.0", "bindtype": "3", "quota": "12.00", "picurl": "http://img14.360buyimg.com/ads/jfs/t1/74606/8/15313/106180/5dcba644Ea4b5899c/440abc0552fcff88.jpg", "picurls": "http://img14.360buyimg.com/ads/jfs/t1/74606/8/15313/106180/5dcba644Ea4b5899c/440abc0552fcff88.jpg,http://img14.360buyimg.com/ads/jfs/t1/80556/20/15479/98423/5dcba647E30c997b2/a76f8329031d66b9.jpg,http://img14.360buyimg.com/ads/jfs/t1/69259/35/15330/132802/5dcba650E74e010fa/0cd1faa58be53235.jpg,http://img14.360buyimg.com/ads/jfs/t1/95206/15/2192/62832/5dcba639Ec40e9498/3258850f33d5bd18.jpg,http://img14.360buyimg.com/ads/jfs/t1/103442/31/2154/172454/5dcba65bE5a733962/d229d9a7f0aa9f61.jpg,http://img14.360buyimg.com/ads/jfs/t1/74244/2/15234/108032/5dcba65eE9fc57dfe/4e9cebf1b33d6b13.jpg,http://img14.360buyimg.com/ads/jfs/t1/98570/5/2241/265505/5dcba689E2a5507ea/57013c5753afe72a.png", "couponurl": "http://coupon.m.jd.com/coupons/show.action?key=12a8b58df90a479e8da4f277a5721fef&roleId=30637203&to=mall.jd.com/index-10106014.html", "sales": 6, "start_time": 1588435200, "end_time": 1593532799, "pf_cid1": 1316, "pf_cid2": 1381, "pf_cid3": 1389, "pf_cname1": "美妝護膚", "pf_cname2": "面部護膚", "pf_cname3": "潔面", "jd_c_info": "O:8:\"stdClass\":6:{s:4:\"cid1\";i:1316;s:8:\"cid1Name\";s:12:\"美妝護膚\";s:4:\"cid2\";i:1381;s:8:\"cid2Name\";s:12:\"面部護膚\";s:4:\"cid3\";i:1389;s:8:\"cid3Name\";s:6:\"潔面\";}", "ispg": 1, "ishot": 1, "owner": "p", "brandcode": "430436", "brandname": "聚然", "comments": 33, "goodcommentsshare": "100.00", "commission": "2.45", "commissionshare": "25.00", "shopid": "10106014", "shopname": "佰迎美妝護膚拼購專營店", "spuid": "61666446218", "ordercommission": "27.17", "coupon_remain_quantity": 99991, "coupon_total_quantity": 100000, "coupon_take_quantity": 9, "uid": 2170, "is_jdwl": "0" } ], "goodscount": 73商品總數 } ], "total": 2總數 }, "message": "success",提示信息 "status_code": 200狀態碼 200表示請求成功 }
接口地址: http://api-gw.haojingke.com/index.php/v1/api/jd/themegoods
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/themegoods?apikey=您的apikey&themeid=10004
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
pageindex | int | 否 | 第幾頁(默認第1頁) |
pagesize | int | 否 | 1-20 默認10 |
themeid | int | 是 | 主題列表獲取 |
商品字段說明見商品列表
接口地址: http://api-gw.haojingke.com/index.php/v1/api/jd/brandlist
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/brandlist?apikey=您的apikey
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
pageindex | int | 否 | 第幾頁(默認第1頁) |
pagesize | int | 否 | 1-10 默認10 |
JSON返回示例:
{ "data": { "data": [ { "id": 36, "brandcode": "18972", "brandname": "雅詩蘭黛", "start_time": 1591632000, "end_time": 1594223999, "logo": "http://img.haojingke.com/3074ad7e4eb53c38b263d357da990b2440c8ca5838dbffdbP7jvZB1kQh.png", "banner": "http://img.haojingke.com/46ec6e424a64a1161e6fd0a2fe2de7e1b7ce26bdc1d9626aF0HB6kFSUH.png", "title": "最大的護膚、化妝品和香水公司之一", "remark": "世界500強 \r\n最大的護膚、化妝品和香水公司之一 \r\n雅詩蘭黛的產品風格是精于研發和精致優雅\r\n", "goodslist": [ { "goods_id": 70158542056, "goods_name": "【京東國際】雅詩蘭黛 DW持妝粉底液", "goods_short_name": "【京東國際】雅詩蘭黛 DW持妝粉底液", "materiaurl": "item.jd.com/70158542056.html", "goods_desc": "??雅詩蘭黛國際大牌COSME美妝大賞殿堂級產品?楊冪代言?618提前搶 領券立減70元 ?持久遮瑕 長效控油 整日不脫妝 ?京東國際 正品保障,下單即贈彩妝蛋\n", "price": "288.00", "price_pg": "0.00", "price_after": "218.00", "discount": "70.0", "bindtype": "3", "quota": "200.00", "picurl": "http://img.haojingke.com/ab49200686480db5b5766fd19af5e53626b7f7a8b139d89atXwsHgeKjk.jpg", "picurls": "http://img14.360buyimg.com/ads/jfs/t1/114900/25/9254/93878/5ed88ffeE2d5bef2d/d2cd02e85a7efbad.jpg,http://img14.360buyimg.com/ads/jfs/t1/124406/6/3936/94165/5ed88fffE2a31eed5/cd6eef95d2856ec2.jpg,http://img14.360buyimg.com/ads/jfs/t1/113986/16/9351/149000/5ed88fffEe0cb5e64/5bdaeb92b137a93d.jpg,http://img14.360buyimg.com/ads/jfs/t1/126943/21/4060/93841/5ed89000E10976637/a37cab8eed6a00ca.jpg,http://img14.360buyimg.com/ads/jfs/t1/136100/24/1450/69876/5ed89000E135801da/851a1b0f391071dc.jpg,http://img14.360buyimg.com/ads/jfs/t1/131819/16/1435/67549/5ed89000Ede2d3bf9/8f0e88b936d109d3.jpg,http://img14.360buyimg.com/ads/jfs/t1/121977/31/3995/85330/5ed89002E3747f523/715a75ef1d136c75.jpg,http://img14.360buyimg.com/ads/jfs/t1/131134/2/1433/46074/5ed89002E4bfa3430/70a8c1a17480f765.jpg", "couponurl": "http://coupon.m.jd.com/coupons/show.action?key=89721bb4d6384120800d6ea4d8c709d8&roleId=32751057&to=item.jd.hk/70158542056.html", "sales": 303, "start_time": 1591804800, "end_time": 1592668799, "pf_cid1": 1316, "pf_cid2": 1387, "pf_cid3": 1420, "pf_cname1": "美妝護膚", "pf_cname2": "香水彩妝", "pf_cname3": "粉底液/膏", "jd_c_info": "O:8:\"stdClass\":6:{s:4:\"cid1\";i:1316;s:8:\"cid1Name\";s:12:\"美妝護膚\";s:4:\"cid2\";i:1387;s:8:\"cid2Name\";s:12:\"香水彩妝\";s:4:\"cid3\";i:1420;s:8:\"cid3Name\";s:13:\"粉底液/膏\";}", "ispg": 0, "ishot": 1, "owner": "p", "brandcode": "18972", "brandname": "雅詩蘭黛(Estee Lauder)", "comments": 0, "goodcommentsshare": "100.00", "commission": "39.24", "commissionshare": "20.00", "shopid": "658197", "shopname": "LADY GO海外專營店", "spuid": "70158542056", "ordercommission": "14883.65", "coupon_remain_quantity": 9718, "coupon_total_quantity": 10000, "coupon_take_quantity": 282, "uid": 20531, "is_jdwl": "0" } ], "goodscount": 4 } ], "total": 127總數 }, "message": "success",提示信息 "status_code": 200狀態碼 200表示請求成功 }
接口地址: http://api-gw.haojingke.com/index.php/v1/api/jd/brandgoods
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/brandgoods?apikey=您的apikey&brandcode=293299
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
pageindex | int | 否 | 第幾頁(默認第1頁) |
pagesize | int | 否 | 1-20 默認10 |
brandcode | int | 是 | 品牌列表獲取 |
商品字段說明見商品列表
接口地址: http://api-gw.haojingke.com/index.php/v1/api/jd/getcategory
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getcategory?apikey=您的apikey&parentId=0&grade=0
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
parentId | int | 是 | 父類目id(一級父類目為0) |
grade | int | 是 | 類目級別(類目級別 0,1,2 代表一、二、三級類目) |
接口地址:
http://api-gw.haojingke.com/index.php/v1/api/jd/getunionurl
注:此接口需要注冊并在會員中心 我的京盟設置京東聯盟ID
可在會員中心按操作步驟申請跨店高傭
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getunionurl?apikey=您的apikey&goods_id=39040990995&positionid=1000100&type=1&couponurl=
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
goods_id | String | 是 | skuid 商品id或者聯盟商品id(聯盟商品ID) |
couponurl | string | 否 | 優惠券鏈接,需要urlencode |
positionid | Int | 是 | 自定義推廣位id,整型數字 (螞蟻星球開發者中心推廣位管理中的uid) |
type | int | 是 | type=1 goods_id=商品ID,type=2 goods_id=店鋪id,type=3 goods_id=自定義鏈接(京東活動鏈接、二合一鏈接) |
giftCouponKey | string | 否 | 禮金批次號 |
JSON返回示例:
{ "data": "https://u.jd.com/KnHEkr",二合一推廣鏈接 "message": "success",提示信息 "status_code": 200狀態碼 200表示請求成功 }注:訂單返回skuList中的positionId=positionid
接口地址:
http://api-gw.haojingke.com/index.php/v1/api/jd/getorder?apikey=您的apikey
注:
1、jd.union.open.order.query 訂單查詢接口 官方文檔
2、此接口需要注冊并在會員中心京東聯盟設置京東聯盟ID、社交媒體應用的appkey 和secretkey
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getorder?apikey=您的apikey&time=2019070809&type=1
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
time | string | 是 | 查詢時間,建議使用分鐘級查詢,格式:yyyyMMddHH、yyyyMMddHHmm或yyyyMMddHHmmss,如201811031212 的查詢范圍從12:12:00--12:12:59 |
pageNo | int | 否 | 頁碼,返回第幾頁結果 |
pageSize | int | 否 | 每頁包含條數,上限為500 |
type | int | 是 | 訂單時間查詢類型(1:下單時間,2:完成時間,3:更新時間) 默認3 |
{ "data": { "data": [ { "ext1": "1000008444", "finishTime": 0, "orderEmt": 2, "orderId": 96158554583, "orderTime": 1559015222000, "parentId": 0, "payMonth": 0, "plus": 0, "popId": 0, "skuList": [ { "actualCosPrice": 0, "actualFee": 0, "cid1": 1620, "cid2": 11158, "cid3": 11163, "commissionRate": 30, "estimateCosPrice": 228, "estimateFee": 0, "ext1": "1000008444", "finalRate": 90, "frozenSkuNum": 0, "payMonth": 0, "pid": "", "popId": 0, "positionId": 1000117, "price": 258, "siteId": 0, "skuId": 15065787245, "skuName": "久久達 客廳裝飾畫電表箱沙發背景墻北歐鹿頭餐廳臥室掛畫相框掛鐘組合美式墻畫現代簡約壁畫字畫 9框組合送畫心(197cm*80cm)", "skuNum": 1, "skuReturnNum": 0, "subSideRate": 90, "subUnionId": "", "subsidyRate": 0, "traceType": 2, "unionAlias": "", "unionTag": "00000000", "unionTrafficGroup": 4, "validCode": 3 }, { "actualCosPrice": 0, "actualFee": 0, "cid1": 4938, "cid2": 4941, "cid3": 13663, "commissionRate": 0, "estimateCosPrice": 0, "estimateFee": 0, "ext1": "1000008444", "finalRate": 100, "frozenSkuNum": 0, "payMonth": 0, "pid": "", "popId": 0, "positionId": 1000117, "price": 0, "siteId": 0, "skuId": 200100123903, "skuName": "流量(支持移動聯通電信手機號提取) 1M", "skuNum": 1, "skuReturnNum": 0, "subSideRate": 90, "subUnionId": "", "subsidyRate": 10, "traceType": 3, "unionAlias": "", "unionTag": "00000000", "unionTrafficGroup": 4, "validCode": 3 } ], "unionId": 1000379981, "validCode": 3 } ], "hasMore": false }, "message": "success", "status_code": 200 }
接口地址:
http://api-gw.haojingke.com/index.php/v1/api/jd/getorderrow?apikey=您的apikey
注:
1、jd.union.open.order.row.query 訂單行查詢接口 官方文檔
2、此接口需要注冊并在會員中心京東聯盟設置京東聯盟ID、社交媒體應用的appkey 和secretkey
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getorderrow?apikey=您的apikey&startTime=2020-01-02 21:23:00&endTime=2020-01-02 21:43:00&type=1
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
startTime | string | 是 | 查開始時間 格式yyyy-MM-dd HH:mm:ss,與endTime間隔不超過1小時 |
endTime | string | 是 | 結束時間 格式yyyy-MM-dd HH:mm:ss,與startTime間隔不超過1小時 |
pageNo | int | 否 | 頁碼,返回第幾頁結果 |
pageSize | int | 否 | 每頁包含條數,上限為500 |
type | int | 是 | 訂單時間查詢類型(1:下單時間,2:完成時間,3:更新時間) 默認3 |
childUnionId | string | 否 | 子推客unionID,傳入該值可查詢子推客的訂單,注意不可和key同時傳入。(需聯系運營開通PID權限才能拿到數據) |
key | string | 否 | 工具商傳入推客的授權key,可幫助該推客查詢訂單,注意不可和childUnionid同時傳入。(需聯系運營開通工具商權限才能拿到數據) |
fields | string | 否 | 支持出參數據篩選,逗號','分隔,目前可用:goodsInfo(商品信息),categoryInfo(類目信息) |
{ "data": { "data": [ { "actualCosPrice": 0, "actualFee": 0, "balanceExt": "", "categoryInfo": { "cid1": 0, "cid2": 0, "cid3": 0 }, "cid1": 1316, "cid2": 1381, "cid3": 1392, "commissionRate": 4, "cpActId": 0, "estimateCosPrice": 0, "estimateFee": 0, "expressStatus": 20, "ext1": "", "finalRate": 100, "finishTime": "", "giftCouponKey": "", "giftCouponOcsAmount": 0, "goodsInfo": { "mainSkuId": 0, "productId": 0, "shopId": 0 }, "id": "593199626514579456", "modifyTime": "2021-05-06 08:53:54", "orderEmt": 2, "orderId": 176465801232, "orderTime": "2021-05-05 22:03:31", "parentId": 0, "payMonth": 0, "pid": "", "plus": 1, "popId": 0, "positionId": 1000117, "price": 0, "proPriceAmount": 0, "rid": 0, "siteId": 0, "skuFrozenNum": 0, "skuId": 100008549903, "skuName": "自然堂(CHANDO) 煙酰胺細致提亮安瓶面膜1片", "skuNum": 1, "skuReturnNum": 0, "subSideRate": 90, "subUnionId": "", "subsidyRate": 10, "traceType": 2, "unionAlias": "", "unionId": 1000000001, "unionRole": 1, "unionTag": "00000000000000000000000000000000", "validCode": 16 } ], "hasMore": false }, "message": "success", "status_code": 200 }
接口地址:
http://api-gw.haojingke.com/index.php/v1/api/jd/getcoupon
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getcoupon?apikey=您的apikey&couponurl=
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
couponurl | string | 否 | 優惠券鏈接,需要urlencode |
接口地址:
http://api-gw.haojingke.com/index.php/v1/api/jd/getjingfen?apikey=您的apikey
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getjingfen?apikey=您的apikey&eliteId=1
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
eliteId | string | 是 | 1-好券商品,2-京粉APP-jingdong.超級大賣場,3-小程序-jingdong.好券商品,4-京粉APP-jingdong.主題聚惠1-jingdong.服裝運動,5-京粉APP-jingdong.主題聚惠2-jingdong.精選家電,6-京粉APP-jingdong.主題聚惠3-jingdong.超市,7-京粉APP-jingdong.主題聚惠4-jingdong.居家生活,10-9.9專區,11-品牌好貨-jingdong.潮流范兒,12-品牌好貨-jingdong.精致生活,13-品牌好貨-jingdong.數碼先鋒,14-品牌好貨-jingdong.品質家電,15-京倉配送,16-公眾號-jingdong.好券商品,17-公眾號-jingdong.9.9,18-公眾號-jingdong. 頻道id:1-好券商品,2-超級大賣場,10-9.9專區,22-熱銷爆品,23-為你推薦,24-數碼家電,25-超市,26-母嬰玩具,27-家具日用,28-美妝穿搭,29-醫藥保健,30-圖書文具,31-今日必推,32-品牌好貨,33-秒殺商品,34-拼購商品,109-新品首發,110-自營,125-首購商品,129-高傭榜單,130-視頻商品 |
pageIndex | int | 否 | 頁碼,返回第幾頁結果 |
pageSize | int | 否 | 每頁包含條數,上限為50 |
sort | string | 否 | asc,desc升降序,默認降序 |
sortName | string | 否 | 排序字段(price:單價, commissionShare:傭金比例, commission:傭金, inOrderCount30DaysSku:sku維度30天引單量,comments:評論數,goodComments:好評數) |
isunion | string | 否 | isunion=1 表示返回京東原接口數據不做處理 返回值參考京東聯盟 官方文檔 |
接口地址:
http://api-gw.haojingke.com/index.php/v1/api/jd/getstuprice?apikey=您的apikey
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getstuprice?apikey=您的apikey
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
skuIds | string | 是 | sku id集合,長度30 英文逗號分隔。如果傳值,忽略其他查詢條件 |
pageIndex | int | 否 | 頁碼,返回第幾頁結果 |
pageSize | int | 否 | 每頁包含條數,上限為50 |
sort | string | 否 | asc,desc升降序,默認降序 |
sortName | string | 否 | 排序字段,默認搜索綜合排序。允許的排序字段:stuPrice、commissionShare、inOrderCount30Days、inOrderComm30Days |
cid1 | string | 否 | 一級類目id |
cid2 | string | 否 | 二級類目id |
cid3 | string | 否 | 三級類目id |
stuPriceFrom | string | 否 | 學生專享價區間開始(單位:元) |
stuPriceTo | string | 否 | 學生專享價區間結束(單位:元) |
commissionShareFrom | string | 否 | 傭金比例區間開始 |
commissionShareTo | string | 否 | 傭金比例區間結束 |
owner | string | 否 | g=自營,p=pop |
接口地址:
http://api-gw.haojingke.com/index.php/v1/api/jd/getseckill?apikey=您的apikey
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getseckill?apikey=您的apikey
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
skuIds | string | 是 | sku id集合,長度30 英文逗號分隔。如果傳值,忽略其他查詢條件 |
pageIndex | int | 否 | 頁碼,返回第幾頁結果 |
pageSize | int | 否 | 每頁包含條數,上限為50 |
sort | string | 否 | asc,desc升降序,默認降序 |
sortName | string | 否 | 排序字段,默認搜索綜合排序。允許的排序字段:stuPrice、commissionShare、inOrderCount30Days、inOrderComm30Days |
cid1 | string | 否 | 一級類目id |
cid2 | string | 否 | 二級類目id |
cid3 | string | 否 | 三級類目id |
secKillPriceFrom | string | 否 | 秒殺價區間開始(單位:元) |
secKillPriceTo | string | 否 | 秒殺價區間結束(單位:元) |
commissionShareFrom | string | 否 | 傭金比例區間開始 |
commissionShareTo | string | 否 | 傭金比例區間結束 |
owner | string | 否 | g=自營,p=pop |
isBeginSecKill | string | 否 | 是否返回未開始秒殺商品。1=返回,0=不返回 |
接口地址:
http://api-gw.haojingke.com/index.php/v1/api/jd/getactivity?apikey=您的apikey
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getactivity?apikey=您的apikey&poolId=6
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
pageIndex | int | 否 | 頁碼,返回第幾頁結果 |
pageSize | int | 否 | 每頁包含條數,上限為50 |
poolId | int | 否 | 活動物料ID,1:營銷日歷熱門會場;2:營銷日歷熱門榜單;6:PC站長端官方活動 |
activeDate | string | 否 | 例:20200918 可查詢到在這一天開始、結束、進行中的活動。可查詢日期范圍為查詢當日的過去或未來各15天。若不傳,則不限制日期 |
接口地址:
http://api-gw.haojingke.com/index.php/v1/api/jd/getmaterial?apikey=您的apikey
支持格式: json
請求方式: get/post
請求示例: http://api-gw.haojingke.com/index.php/v1/api/jd/getmaterial?apikey=您的apikey&eliteId=1
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
apikey | String | 是 | 螞蟻星球apikey,請將示例中的key替換成您的key |
eliteId | string | 是 | 頻道ID:1.猜你喜歡、2.實時熱銷、3.大額券、4.9.9包郵 |
pageIndex | int | 否 | 頁碼,返回第幾頁結果 |
pageSize | int | 否 | 每頁包含條數,上限為50 |
hasCoupon | int | 否 | 1:只查詢有最優券商品,不傳值不做限制 |
userIdType | string | 否 | 用戶ID類型,傳入此參數可獲得個性化推薦結果。當前userIdType支持的枚舉值包括:8、16、32、64、128、32768。userIdType和userId需同時傳入,且一一對應。userIdType各枚舉值對應的userId含義如下:8(安卓移動設備Imei); 16(蘋果移動設備Openudid);32(蘋果移動設備idfa); 64(安卓移動設備imei的md5編碼,32位,大寫,匹配率略低);128(蘋果移動設備idfa的md5編碼,32位,大寫,匹配率略低); 32768(安卓移動設備oaid); 131072(安卓移動設備oaid的md5編碼,32位,大寫) |
userId | string | 否 | 示例1: userIdType設置為8時,此時userId需要設置為安卓移動設備Imei,如861794042953717 示例2: userIdType設置為16時,此時userId需要設置為蘋果移動設備Openudid,如f99dbd2ba8de45a65cd7f08b7737bc919d6c87f7 示例3: userIdType設置為32時,此時userId需要設置為蘋果移動設備idfa,如DCC77BDA-C2CA-4729-87D6-B7F65C8014D6 示例4: userIdType設置為64時,此時userId需要設置為安卓移動設備imei的32位大寫的MD5編碼,如1097787632DB8876D325C356285648D0(原始imei:861794042953717) 示例5: userIdType設置為128時,此時userId需要設置為蘋果移動設備idfa的32位大寫的MD5編碼,如38D7C90186B1328F9418816DCC762A27(原始idfa:DCC77BDA-C2CA-4729-87D6-B7F65C8014D6) 示例6: userIdType設置為32768時,此時userId需要設置為安卓移動設備oaid,如7dafe7ff-bffe-a28b-fdf5-7fefdf7f7e85 示例7: userIdType設置為131072時,此時userId需要設置為安卓移動設備oaid的32位大寫的MD5編碼,如4967357D630E32E312A3A3EE0C5A128B(原始oaid:7dafe7ff-bffe-a28b-fdf5-7fefdf7f7e85), userIdType對應的用戶設備ID,傳入此參數可獲得個性化推薦結果,userIdType和userId需同時傳入 |
fields | string | 否 | 支持出參數據篩選,逗號','分隔,目前可用:videoInfo(視頻信息),hotWords(熱詞),similar(相似推薦商品),documentInfo(段子信息),skuLabelInfo(商品標簽),promotionLabelInfo(商品促銷標簽) |
forbidTypes | string | 否 | 10微信京東購物小程序禁售,11微信京喜小程序禁售 |
isunion | string | 否 | isunion=1 表示返回京東原接口數據不做處理 返回值參考京東聯盟 官方文檔 |