京东API使用须知
京东联盟设置蚂蚁星球推出开放API的目的在于,让具有开发能力的个人京东客,开发团队以及软件开发商更便捷的采集蚂蚁星球商品库的数据,实现优质好单的资源共享。使用蚂蚁星球开放API需要先申请apikey,您可以在本页面上方点击申请按钮或直接进入个人中心开放API页面申请,单个蚂蚁星球账号只能申请一个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,多个用英文逗号分隔 |
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 | int | 是 | skuid 商品id |
isdetail | string | 否 | isunion=1 表示返回detail字段 |
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 | int | 是 | 商品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 表示返回京东原接口数据不做处理 返回值参考京东联盟 官方文档 |