入库更新
特色栏目
系统参数
| 名称 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| appid 复制 | Int | 是 | 2010091553028980 | 您在京推推申请的appid |
| appkey 复制 | String | 是 | 2 | 您在京推推申请的appkey |
| v 复制 | String | 是 | v2 | API接口版本号，当前版本: v2 |
| return_type 复制 | String | 否 | code_jsonp | 返回数据格式，不传参默认json,支持以下参数code、jsonp、code_jsonp |
请求参数说明
| 名称 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| pageIndex 复制 | Int | 否 | 1 | 分页获取数据（默认第1页） |
| pageSize 复制 | Int | 否 | 20 | 单页面显示条数(最大100条最少10条) |
| keyword 复制 | String | 否 | 纸巾 | 关键词搜索（可以输入关键词、SKU、商品链接、店铺名称） |
| goods_type 复制 | Int | 否 | 1 | 京推推商品一级类目： 1居家日用；2食品；3生鲜；4图书；5美妆个护；6母婴；7数码家电；8内衣；9配饰；10女装；11男装；12鞋品；13家装家纺；14文娱车品；15箱包；16户外运动（支持多类目筛选，如1,2获取类目为居家日用、食品的所有商品，请用英文都好隔开，不传则为全部商品） |
| goods_second_type 复制 | Int | 否 | 8 | 京推推二级分类（可通过超级分类API获取全部的二级分类id，本接口也有返回） |
| eliteId 复制 | String | 否 | sift | 频道id： sift精选好货；nineSift“9块9”精选；collage京东拼购；self京东自营；wtype京东配送；goodShop京东好店；flagShop官方旗舰店；giftGoods奖励商品；import京东国际；jdMarket京东超市；bugGoods漏洞单；remotePost偏远地区包邮 |
| sortName 复制 | String | 否 | finally | 排序字段：finally券后价；brokerage佣金比例；sale折扣力度；OrderCount30Days 30天引入订单量；inOrderComm30Days 30天支出佣金；getCouponNum领券量；comments评论数；goodComments好评数 |
| sort 复制 | String | 否 | desc | 排序：asc,desc升降序 |
| price_start 复制 | Double | 否 | 1.9 | 价格筛选:最低价格 |
| price_end 复制 | Double | 否 | 9.9 | 价格筛选:最高价格 |
| brand_id 复制 | String | 否 | 1 | 京推推品牌ID筛选 |
| shop_id 复制 | Int | 否 | 1000016561 | 店铺id筛选 |
| jd_type 复制 | Int | 否 | 1 | 京东商品类型（1=POP；2=self自营；3=拼购） |
返回参数说明
| 名称 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| return 复制 | Int | 0 | 0=返回成功 |
| result 复制 | 返回结果 | ||
| > data 复制 | Array | 数据明细 | |
| >> J_state 复制 | Int | 2 | 京推推商品状态(注:2正常，其他状态为非正常状态) |
| >> JID 复制 | Int | 3288585 | 京推推商品ID |
| >> goods_id 复制 | Long | 10021724657015 | 商品SKU |
| >> itemId 复制 | String | Q9Z2ZdyMsa9g7jpsfgQNVA0R_3SD7M7ISbsR0zCKPo | 联盟商品ID |
| >> short_name 复制 | String | "【漏洞价108】Latim乐太 麦饭石不粘锅 " | 京推推商品精编标题 |
| >> goods_name 复制 | String | "Latim乐太 不粘锅炒锅家用麦饭石炒菜锅少油烟平底锅燃气灶适用电磁炉专用 QA2028粉色煎锅28cm+盖子 28cm" | 京东商品原标题 |
| >> goods_content 复制 | String | "源自意大利，传承百年工艺，一抹即净，清洁方便，电磁炉燃气灶都通用，省时又省心！" | 京推推商品描述文案 |
| >> link_content 复制 | String | "🔰源自意大利，传承百年工艺🍳好锅不挑灶，省时又省心[强]享受厨房烹饪的乐趣！\r\n—————\r\nLatim乐太 麦饭石不粘锅\r\n\r\n🔴到手仅需108元，太值了💢\r\n\r\n抢购：[商品推广链接]" | 精编社群推广文案 |
| >> circle_content 复制 | String | "🔥爆款，抢疯了！\r\n✨一抹即净，清洁方便\r\n🔰源自意大利，品质标杆！\r\nLatim乐太 麦饭石不粘锅\r\n到手价：108元🉐\r\n抢购：[商品推广链接]" | 朋友圈推广文案 |
| >> goods_link 复制 | String | "http://item.jd.com/10021724657015.html?rid=10109" | 京东商品链接 |
| >> commissionShare 复制 | Double | 22 | 商品佣金比例（具体佣金可根据平台分佣体系进行计算显示） |
| >> brand_id 复制 | Int | 0 | 京推推品牌id,可用于品牌API商品筛选 |
| >> inOrderCount30Days 复制 | Int | 5 | 京东商品近30天销量 |
| >> inOrderComm30Days 复制 | Int | 295 | 京东商品30天支出佣金 |
| >> brandCode 复制 | Int | 306998 | 京东_品牌code |
| >> brandName 复制 | String | Latim | 京东_品牌名称 |
| >> isHot 复制 | Int | 1 | 是否爆款（1=是；0=否） |
| >> comments 复制 | Long | 0 | 评论数 |
| >> goodCommentsShare 复制 | Double | 100 | 商品好评率 |
| price_Info 复制 | 价格信息（结果不返回，仅作为文档分类展示） | ||
| >> goods_price 复制 | Double | 1108 | 商品原价 |
| >> final_price 复制 | Double | 308 | 商品最终价格（使用优惠券后的商品最终价格） |
| >> historyPriceDay 复制 | Int | 180 | 历史最低价天数 |
| img_info 复制 | 图片信息（结果不返回，仅作为文档分类展示） | ||
| >> goods_img 复制 | String | "http://img.jingtuitui.com/a48e4202010201652443724.jpg" | 京推推商品主图（京推推优化过的商品主图，建议用户将其设为商品展示主图） 如因图片过大建议优化图片大小：例http://img.jingtuitui.com/a497d202011251136243678.jpg?imageView2/1/w/120/h/120/q/75 |
| >> imageList 复制 | Json | "[{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/118516\\/9\\/17975\\/523786\\/5f61a8d1Eb2285144\\/278a4b046aae26fe.png\"}, | 京东图片合集（第一张图为京东商品主图） 如因图片过大建议优化图片大小：例：http://img14.360buyimg.com/ads/s300x300_jfs/t22495/56/628456568/380476/9befc935/5b39fb01N7d1af390.jpg |
| coupon_Info 复制 | 优惠券信息（结果不返回，仅作为文档分类展示） | ||
| >> today_num 复制 | Int | 0 | 商品今日领券总量，券类型为商品券 |
| >> discount_link 复制 | String | http://coupon.m.jd.com/coupons/show.action?key=8135f5bf2e4f4712b2ff65dde9e394a9&roleId=39776621&to=mall.jd.com/index-948228.html | 领券链接 |
| >> discount_price 复制 | Double | 800 | 优惠券面额 |
| >> get_start_time 复制 | Long | 1603123200000 | 优惠券开始时间(时间戳，java精确到毫秒，其他语言都可以精确到秒) |
| >> get_end_time 复制 | Long | 1604764799000 | 优惠券到期时间(时间戳，java精确到毫秒，其他语言都可以精确到秒) |
| shop_Info 复制 | 店铺信息（结果不返回，仅作为文档分类展示） | ||
| >> shop_id 复制 | Int | 948228 | 店铺id |
| >> shop_name 复制 | String | Latim拼购旗舰店 | 店铺名称 |
| >> score 复制 | Text | "{\"afterServiceScore\":\"8.96\",\"logisticsLvyueScore\":\"9.31\",\"scoreRankRateGrade\":\"\",\"userEvaluateScore\":\"9.17\"}" | 店铺评分（afterServiceScore售后服务评分；logisticsLvyueScore物流履约评分； ;scoreRankRateGrade店铺星级；userEvaluateScore商品评价评分) |
| >> owner 复制 | String | p | 店铺性质:（g=自营；p=pop） |
| category_Info 复制 | 类目信息（结果不返回，仅作为文档分类展示） | ||
| >> goods_type 复制 | Int | 1 | 京推推商品一级类目 |
| >> cname 复制 | String | 居家日用 | 京推推一级分类名称 |
| >> goods_second_type 复制 | Int | 10 | 京推推商品二级类目（可以通过超级分类API获取全部二级类目ID） |
| >> subcname 复制 | String | 厨具用品 | 京推推二级分类名称 |
| >> spu_id 复制 | Long | 10021724657015 | 商品主SPU，其值为同款商品的主skuid |
| >> cid1 复制 | Int | 6196 | 京东一级类目ID |
| >> cid1Name 复制 | String | 厨具 | 京东一级类目名称 |
| >> cid2 复制 | Int | 6197 | 京东二级类目ID |
| >> cid2Name 复制 | String | 烹饪锅具 | 京东二级类目名称 |
| >> cid3 复制 | Int | 6200 | 京东三级类目ID |
| >> cid3Name 复制 | String | 平底锅/煎锅 | 京东三级类目名称 |
| >> goods_level 复制 | Int | 5 | 京推推商品类型（5=普通产品；10=优选产品；20=精选好货；30=主推(坑位等)；40=爆款） |
| >> deliveryType 复制 | Int | 0 | 京东商品类型（0=普通产品；1=京东配送） |
| >> jd_type 复制 | Int | 3 | 京东商品类型（1=POP；2=self自营；3=拼购） |
| PinGou_Info 复制 | 拼购信息（结果不返回，仅作为文档分类展示） | ||
| >> pingouPrice 复制 | Double | 1108 | 拼购价格 |
| >> pingouTmCount 复制 | Int | 2 | 拼购所需人数 |
| >> pingouUrl 复制 | String | https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=10021724657015&from=cps | 拼购落地页url |
| >> pingouStartTime 复制 | Long | 1600235969000 | 拼购开始时间(java精确到毫秒，其他语言都可以精确到秒) |
| >> pingouEndTime 复制 | Long | 2133999048000 | 拼购结束时间(java精确到毫秒，其他语言都可以精确到秒) |
| >> jd_videoList 复制 | Text | null | 京东_视频集合 |
| >> pc_ware_style 复制 | Text | "<p><img style=\"width:auto;height:auto;max-width:100%;\" src=\"http://img30.360buyimg.com/popWareDetail/jfs/t1/129628/25/10143/96761/5f61a941Eb7949bad/3fccff64f9874025.jpg\" | 京东商品图文详情 |
| >> discount_count 复制 | Int | 35 | 商品总领券量 |
| >> is_good_shop 复制 | Int | 0 | 是否京东好店（0=否，1=是） |
| >> is_flagship_store 复制 | Int | 1 | 是否官方旗舰店（0=否，1=是） |
| >> is_subsidy_goods 复制 | Int | 0 | 是否奖励商品（0=否，1=是） |
| >> is_import 复制 | Int | 0 | 是否京东国际（0=否，1=是） |
| >> is_jd_market 复制 | Int | 0 | 是否京东超市（0=否，1=是） |
| >> is_bug_goods 复制 | Int | 0 | 是否漏洞单（0=否，1=是） |
| >> is_remote_post 复制 | Int | 0 | 是否偏远地区包邮（0=否，1=是） |
| >> plusCommissionShare 复制 | Double | 0 | plus会员佣金 |
| >> quota 复制 | Int | 1000 | 券消费限额 |
| > current_page 复制 | Int | 1 | 当前页码 |
| > total_page 复制 | Int | 3965 | 商品总页数 |
| > total_Count 复制 | Int | 397 | 商品总数量 |
JSON返回示例
{
"return": 0,
"result": {
"data": [
{
"J_state": 2,
"JID": 3832856,
"goods_id": 10026789974960,
"short_name": "笑猫日记全套27册",
"goods_name": "【累计销售5000千万册】笑猫日记全套27册 戴口罩的猫幸运女神的宠儿属猫的人杨红樱的书故事书小学生",
"goods_content": "170元得笑猫日记全套27册\r\n\r\n发行量累计超过5000万册. 被誉为献给当代中国孩子的“心灵之书”\r\n 贴近孩子的生活,帮助孩子提高写作.童话名家杨红樱力作\r\n\r\n\r\n\r\n",
"link_content": "",
"circle_content": "\r\n",
"goods_link": "http://item.jd.com/10026789974960.html?rid=10109",
"commissionShare": 25,
"brand_id": 0,
"inOrderCount30Days": 0,
"inOrderComm30Days": null,
"brandCode": 35247,
"brandName": "其他品牌",
"isHot": 1,
"comments": 0,
"goodCommentsShare": 100,
"goods_price": 270,
"final_price": 170,
"historyPriceDay": null,
"goods_img": "http://img14.360buyimg.com//imgzone//jfs/t1/169197/6/7561/368376/6034e6f8Ed2d20904/bc9af4c11ba5b6b5.jpg",
"imageList": "[{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/169197\\/6\\/7561\\/368376\\/6034e6f8Ed2d20904\\/bc9af4c11ba5b6b5.jpg\"},{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/159492\\/19\\/6495\\/372060\\/6034d4c4E57dce388\\/03dc5f74d03cfe9f.jpg\"},{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/167857\\/31\\/7286\\/502743\\/6034d4c4Ecb903e0c\\/40719b488e255818.jpg\"},{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/169577\\/27\\/7701\\/173532\\/6034d4c1E7ace2e08\\/da0294828529482c.jpg\"},{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/160741\\/36\\/7711\\/221556\\/6034d4c0E8dc7598a\\/f274f3dfdac01318.jpg\"}]",
"today_num": 0,
"discount_link": "http://coupon.m.jd.com/coupons/show.action?key=f84505d2fc264bbe908432202282d0ba&roleId=46733721&to=item.jd.com/10026789974960.html",
"discount_price": 100,
"get_start_time": 1614136264000,
"get_end_time": 1614787198000,
"shop_id": 10310704,
"shop_name": "国潮图书拼购专营店",
"score": "{\"afterServiceScore\":\"8.79\",\"logisticsLvyueScore\":\"8.65\",\"scoreRankRateGrade\":\"\",\"userEvaluateScore\":\"9.3\"}",
"owner": "p",
"goods_type": 4,
"goods_second_type": 90,
"spu_id": 10026789974960,
"cid1": 1713,
"cid1Name": "图书",
"cid2": 3259,
"cid2Name": "文学",
"cid3": 3329,
"cid3Name": "儿童文学",
"goods_level": 5,
"deliveryType": null,
"jd_type": 3,
"pingouPrice": 270,
"pingouTmCount": 2,
"pingouUrl": "https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=10026789974960&from=cps",
"pingouStartTime": 1614136213634,
"pingouEndTime": 2133999048634,
"jd_videoList": null,
"pc_ware_style": "<div style=\"text-align: center;\"><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/151872/7/19722/396591/6034d4c3Ece37baf8/f6d2c86002dd14e7.jpg\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/159870/11/6955/136619/6034d4c0E1e30414c/8bcebf87617c9fc2.jpg\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/162885/15/7674/268909/6034d4c1Ebfc04397/2b65a2d020219248.jpg\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/158726/20/7679/89427/6034d4bfE35ccfcb4/ff4332d4a58a839c.gif\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/158152/28/7831/460417/6034d4c5Ea9f18df9/d0e8beedef5c0014.gif\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/154142/31/19439/450393/6034d4c7Ee6e96042/d8b523eb42577ea7.gif\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/169649/19/7531/150217/6034d4c0Ef83d2825/8aff2fb1f66c4716.jpg\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/151221/8/20685/259650/6034d4caE7594e78d/c5ea3817687bc488.gif\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/167053/26/8733/252132/6034d4cbE83ce1bcf/597ebfdbc808d96b.gif\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/157487/5/8372/372742/6034d4cbEe1e67c0e/3f7ed6b12eef720d.gif\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/164845/14/7363/393207/6034d4cbE780f3b32/5adb57cf49f36426.gif\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/169751/34/7608/318176/6034d4caE73166099/671a65f0458a9139.gif\"></div>\n\n<div><img style=\"max-width:790px;\" src=\"http://img10.360buyimg.com/imgzone/jfs/t1/168209/15/7220/362803/6034d4caEf034d475/e9921cc04dcfcf2c.gif\"></div>\n<p><br></p><br/>",
"discount_count": 0,
"is_good_shop": 0,
"is_flagship_store": 0,
"is_subsidy_goods": 0,
"is_import": 0,
"is_jd_market": 0,
"is_bug_goods": 0,
"is_remote_post": null,
"plusCommissionShare": 25,
"quota": 200,
"cname": "图书",
"subcname": "人文"
"second": [],
"current_page": 1,
"total_count": 4201,
"total_page": 421
}
}
v2版本 更新时间: 2024-03-30 11:25:56
v2更新内容
一、返回参数新增itemId：联盟商品ID
v2版本 更新时间: 2021-02-24 17:53:48
v2更新内容
v2版本一、请求参数
新增jd_type：京东商品类型（1=POP；2=self自营；3=拼购）
二、返回参数
新增cname：一级分类名称；
新增subcname：二级分类名称；
新增plusCommissionShare：plus会员佣金；
新增quota：券消费限额
v2版本 更新时间: 2020-12-09 14:26:05
v2更新内容
一、请求参数新增eliteId：import京东国际；jdMarket京东超市；bugGoods漏洞单；remotePost偏远地区包邮
二、返回参数
新增is_impor 是否京东国际（0=否，1=是）
新增 is_jd_market 是否京东超市（0=否，1=是）
新增is_bug_goods 是否漏洞单（0=否，1=是）
新增is_remote_post 是否偏远地区包邮（0=否，1=是）
| 错误码 | 说明 |
|---|---|
| 0 | 请求成功 |
| 1000 | appid或appkey错误 |
| 2000 | API次数调用超过上限 |
| 3000 | API权限不足 |
