入库更新
特色栏目
系统参数
| 名称 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| appid 复制 | Int | 是 | 2010091553028980 | 您在京推推申请的appid |
| appkey 复制 | String | 是 | 2 | 您在京推推申请的appkey |
| v 复制 | String | 是 | v3 | API接口版本号，当前版本: v3 |
请求参数说明
| 名称 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| pageIndex 复制 | Int | 否 | 1 | 分页获取数据 默认1 |
| pageSize 复制 | Int | 否 | 20 | 单页面显示条数(最大100条最少10条) |
| goods_type 复制 | Int | 否 | 1 | 京推推商品一级类目： 0全部；1居家日用；2食品；3生鲜；4图书；5美妆个护；6母婴；7数码家电；8内衣；9配饰；10女装；11男装；12鞋品；13家装家纺；14文娱车品；15箱包；16户外运动（支持多类目筛选，如1,2获取类目为女装、男装的商品，逗号仅限英文逗号） |
| type 复制 | Int | 否 | item | 品牌数据类型 item-详情（构建品牌内商品列表清单需加此参数。例type=item&brand_id=1） |
| brand_id 复制 | Int | 否 | 1 | 京推推品牌id |
| brand_name 复制 | String | 否 | 三只松鼠 | 品牌名称搜索 |
返回参数说明
| 名称 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| return 复制 | Int | 0 | 0=返回成功 |
| result 复制 | 返回结果 | ||
| > top_brand 复制 | Object | 今日主推品牌 | |
| >> brand_id 复制 | Int | 47 | 京推推品牌ID |
| >> brand_name 复制 | String | "汤臣倍健" | 京推推品牌名称 |
| >> ico 复制 | String | "http://img.jingtuitui.com/92a7d201912231520536005.png" | 品牌logo |
| >> introduce 复制 | String | "中国膳食营养补充剂领导品牌" | 品牌介绍 |
| >> slogan 复制 | String | "为更好的你" | 品牌宣传语 |
| >> history 复制 | String | "1995年创建于广东省珠海市" | 品牌历史 |
| >> location 复制 | String | "大众品牌" | 品牌定位 |
| >> group 复制 | String | "老少皆宜" | 品牌消费群体 |
| >> characteristic 复制 | String | "主打蛋白质、维生素等高品质营养补充剂和康食品;全球第一家透明工厂，打造品质标杆;年销量超过10,000,000瓶" | 品牌特点 |
| >> app_banner 复制 | String | "http://img.jingtuitui.com/1a889202008211853079975.jpg" | 品牌banner图 |
| >> top_goods 复制 | String | "3813434,3820104,3820082,3821436,3826444,3821442" | 今日主推商品SKU列表 |
| >> today_coupon_num 复制 | Int | 946 | 品牌今日总领券量 |
| >> all_coupon_num 复制 | Int | 269477 | 品牌累计总领券量 |
| >> goods_num 复制 | Int | 151 | 有效商品数量 |
| >> today_goods_num 复制 | Int | 16 | 今日上新商品数量 |
| >> settime 复制 | Long | 1614096000 | 主推品牌开始时间 |
| >> inOrderCount30Days_total 复制 | Int | 14380 | 品牌内所有商品销量总计 |
| >> inOrderCount30Days 复制 | Int | 22681 | 近30天引入单量（京东商品近30天销量） |
| >> high_discount_price 复制 | Double | 200 | 品牌内所有商品中最高券面额 |
| >> brand_low_discount 复制 | Int | 3 | 品牌内所有商品折扣最高值（例：7折） |
| >> goods_list 复制 | Array | 商品列表 | |
| >>> JID 复制 | Long | 3821436 | 京推推商品ID |
| >>> J_state 复制 | Int | 2 | 京推推商品状态(注:1被修改；2正常；3已下架；4已下架（除状态2返回所有信息，其他状态将只返回京推推商品ID、京东商品ID以及商品状态) |
| >>> goods_id 复制 | Long | 69012635022 | 商品SKU |
| >>> goods_name 复制 | String | "【到手198元】汤臣倍健蛋白粉共发 750g" | 京东商品原标题 |
| >>> goods_img 复制 | String | "http://img.jingtuitui.com/e2086202102221609271063.jpg" | 京推推商品主图（京推推优化过的商品主图，建议用户将其设为商品展示主图） |
| >>> goods_price 复制 | Double | 339 | 商品原价 |
| >>> goods_content 复制 | String | "厂家控价，数量有限！！折合1份才198，沃尔玛同款398/桶（中老年成人孕妇增强免疫力保健品，新西兰/澳大利亚浓缩乳全球优质奶源地清蛋白+中国东北黑土地非转基因大豆的完美集合，动植物双蛋白营好CP，营养好吸收！）\r\n" | 商品文案（京推推商品描述） |
| >>> goods_link 复制 | String | "http://item.jd.com/69012635022.html?rid=10109" | 京东商品链接 |
| >>> discount_price 复制 | Double | 71 | 优惠券面额 |
| >>> discount_link 复制 | String | "http://coupon.m.jd.com/coupons/show.action?key=9562983310254d01b32b266f5101ff61&roleId=46614220&to=item.jd.com/69012635022.html" | 领券链接 |
| >>> get_start_time 复制 | Long | 1613957898000 | 优惠券开始时间(时间戳，java精确到毫秒，其他语言都可以精确到秒) |
| >>> get_end_time 复制 | Long | 1614614398000 | 优惠券到期时间(时间戳，java精确到毫秒，其他语言都可以精确到秒) |
| >>> final_price 复制 | Double | 268 | 商品最终价格（使用优惠券后的商品最终价格） |
| >>> commissionShare 复制 | Double | 20 | 商品佣金比例（具体佣金可根据平台分佣体系进行计算显示） |
| >>> today_num 复制 | Int | 46 | 今日领券数（商品今日领券总量，券类型为商品券） |
| >>> goods_level 复制 | Int | 20 | 京推推商品类型（5=普通产品；10=优选产品；20=精选好货；30=主推(坑位等)；40=爆款） |
| >>> shop_type 复制 | Int | null | 京东商品类型（0=普通产品；1=京东配送） |
| >>> jd_type 复制 | Int | 1 | 京东商品类型（1=POP；2=self自营；3=拼购） |
| >>> brand_id 复制 | Int | 47 | 品牌ID（京推推品牌id,可用于品牌API商品筛选） |
| >>> shop_id 复制 | Int | 10173034 | 店铺id |
| >>> shop_name 复制 | String | "逸凡营养保健旗舰店" | 店铺名称 |
| >>> inOrderCount30Days 复制 | Int | 474 | 近30天引入单量（京东商品近30天销量） |
| >>> score 复制 | text | "{\"afterServiceScore\":\"8.88\",\"logisticsLvyueScore\":\"8.73\",\"scoreRankRateGrade\":\"4.50\",\"userEvaluateScore\":\"9.07\"}" | 店铺评分（afterServiceScore售后服务评分；logisticsLvyueScore物流履约评分； ;scoreRankRateGrade店铺星级；userEvaluateScore商品评价评分) |
| >>> link_content 复制 | String | "——超值！超值！——\r\n\r\n👉先领299-50平台券退出：\r\nhttp://t.cn/A6tJ2d6Y\r\n\r\n【到手198元】汤臣倍健蛋白粉共发 750g\r\n\r\n🔴实付198元到手\r\nhttps://u.jd.com/i41tocS\r\n——————\r\n*中老年成人孕妇增强免疫力保健品！动植物双蛋白营养，好吸收！今日三桶共750g到手仅需198！数量有限！！沃尔玛同款398/桶" | 精编社群推广文案 |
| >>> spu_id 复制 | Long | 66474064261 | 商品主SPU，其值为同款商品的主skuid |
| >>> cid1 复制 | Int | 9192 | 京东一级类目ID |
| >>> cid2 复制 | Int | 9193 | 京东二级类目ID |
| >>> cid3 复制 | Int | 9201 | 京东三级类目ID |
| >>> cid1Name 复制 | String | "医疗保健" | 京东一级类目名称 |
| >>> cid2Name 复制 | String | "营养健康" | 京东二级类目名称 |
| >>> cid3Name 复制 | String | "增强免疫" | 京东三级类目名称 |
| >>> imageList 复制 | Json | "[{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/159657\\/1\\/7975\\/143761\\/603304e3Ef97db834\\/920ccf47b46a5170.jpg\"}, | 京东图片合集（第一张图为京东商品主图） |
| >>> isHot 复制 | Int | 1 | 是否爆款（1=是；0=否） |
| >>> brandCode 复制 | Int | 16690 | 京东_品牌code |
| >>> brandName 复制 | String | "汤臣倍健（BY-HEALTH）" | 京东_品牌名称 |
| >>> owner 复制 | String | p | 店铺性质:（g=自营；p=pop） |
| >>> goodCommentsShare 复制 | Double | 99 | 商品好评率 |
| >>> pingouPrice 复制 | Double | null | 拼购价格 |
| >>> pingouTmCount 复制 | Int | null | 拼购所需人数 |
| >>> pingouUrl 复制 | String | null | 拼购落地页url |
| >>> pingouStartTime 复制 | Long | null | 拼购开始时间(java精确到毫秒，其他语言都可以精确到秒) |
| >>> pingouEndTime 复制 | Long | null | 拼购结束时间(java精确到毫秒，其他语言都可以精确到秒) |
| >>> jd_videoList 复制 | Text | null | 京东_视频集合 |
| >>> pc_ware_style 复制 | Text | "<p style=\"text-align: center; \"><img src=\"//img10.360buyimg.com/imgzone/jfs/t1/140373/19/6073/93482/5f3f9ad0E42617cf3/72a934af3e871cf6.jpg\" | 京东商品图文详情 |
| > brand_list 复制 | Array | 品牌列表（返回数据同top_brand） | |
| ...... 复制 | |||
| > brandtotal_Count 复制 | Int | 375 | 品牌总数量 |
| > current_page 复制 | Int | 1 | 当前页码 |
| > last_page 复制 | Int | 38 | 末尾页码 |
| 请求参数type=item&brand_id=1 复制 | 单个品牌详情页 | ||
| return 复制 | Int | 0 | 0=返回成功 |
| result 复制 | 返回结果 | ||
| > brand 复制 | Array | 品牌明细 | |
| >> brand_id 复制 | Int | 503 | 京推推品牌ID |
| >> brand_name 复制 | String | "康佳" | 京推推品牌名称 |
| >> ico 复制 | String | "http://img.jingtuitui.com/76ff1202001061332513950.jpg" | 品牌logo |
| >> introduce 复制 | String | "知名国产电器品牌" | 品牌介绍 |
| >> slogan 复制 | String | "国产电器" | 品牌宣传语 |
| >> history 复制 | String | "1980年创建于广东省深圳市" | 品牌历史 |
| >> location 复制 | String | "大众品牌" | 品牌定位 |
| >> group 复制 | String | "普通家庭" | 品牌消费群体 |
| >> characteristic 复制 | String | "2017年销售额超过300亿元;国内最早一批涉足大屏幕显示领域的企业" | 品牌特点 |
| >> app_banner 复制 | String | "http://img.jingtuitui.com/d6392202008131908374789.jpg" | 品牌banner图 |
| >> goods_num 复制 | Int | 3 | 有效商品数量 |
| >> today_coupon_num 复制 | Int | 28 | 品牌今日总领券量 |
| >> all_coupon_num 复制 | Int | 27816 | 品牌累计总领券量 |
| >> today_goods_num 复制 | Int | 0 | 今日上新商品数量 |
| > goods 复制 | 品牌商品清单 | ||
| >> total_Count 复制 | Int | 10 | 商品总数量 |
| >> current_page 复制 | Int | 1 | 当前页码 |
| >> last_page 复制 | Int | 1 | 末尾页码 |
| >> date 复制 | Array | 商品信息集合（返回信息同上goods_list） | |
| ...... 复制 |
JSON返回示例
{
"return": "0",
"result": {
"top_brand": [
{
"brand_id": 47,
"brand_name": "汤臣倍健",
"ico": "http://img.jingtuitui.com/92a7d201912231520536005.png",
"introduce": "中国膳食营养补充剂领导品牌",
"slogan": "为更好的你",
"history": "1995年创建于广东省珠海市",
"location": "大众品牌",
"group": "老少皆宜",
"characteristic": "主打蛋白质、维生素等高品质营养补充剂和康食品;全球第一家透明工厂，打造品质标杆;年销量超过10,000,000瓶",
"app_banner": "http://img.jingtuitui.com/1a889202008211853079975.jpg",
"top_goods": "3813434,3820104,3820082,3821436,3826444,3821442",
"today_coupon_num": 1005,
"all_coupon_num": 269527,
"goods_num": 151,
"today_goods_num": 16,
"settime": 1614096000,
"inOrderCount30Days_total": 22686,
"high_discount_price": 200,
"brand_low_discount": 3,
"goods_list": [
{
"JID": 3821436,
"J_state": 2,
"goods_id": 69012635022,
"goods_name": "【到手198元】汤臣倍健蛋白粉共发 750g",
"goods_img": "http://img.jingtuitui.com/e2086202102221609271063.jpg",
"goods_price": 339,
"goods_content": "厂家控价，数量有限！！折合1份才198，沃尔玛同款398/桶（中老年成人孕妇增强免疫力保健品，新西兰/澳大利亚浓缩乳全球优质奶源地清蛋白+中国东北黑土地非转基因大豆的完美集合，动植物双蛋白营好CP，营养好吸收！）\r\n",
"goods_link": "http://item.jd.com/69012635022.html?rid=10109",
"discount_price": 71,
"discount_link": "http://coupon.m.jd.com/coupons/show.action?key=9562983310254d01b32b266f5101ff61&roleId=46614220&to=item.jd.com/69012635022.html",
"get_start_time": 1613957898000,
"get_end_time": 1614614398000,
"final_price": 268,
"goods_type": 6,
"commissionshare": 20,
"today_num": 50,
"goods_level": 20,
"shop_type": null,
"jd_type": 1,
"brand_id": 47,
"shop_id": 10173034,
"shop_name": "逸凡营养保健旗舰店",
"inOrderCount30Days": 474,
"score": "{\"afterServiceScore\":\"8.88\",\"logisticsLvyueScore\":\"8.73\",\"scoreRankRateGrade\":\"4.50\",\"userEvaluateScore\":\"9.07\"}",
"link_content": "——超值！超值！——\r\n\r\n👉先领299-50平台券退出：\r\nhttp://t.cn/A6tJ2d6Y\r\n\r\n【到手198元】汤臣倍健蛋白粉共发 750g\r\n\r\n🔴实付198元到手\r\nhttps://u.jd.com/i41tocS\r\n——————\r\n*中老年成人孕妇增强免疫力保健品！动植物双蛋白营养，好吸收！今日三桶共750g到手仅需198！数量有限！！沃尔玛同款398/桶",
"img_list": "[\"http://img.jingtuitui.com/b39b3202102230905445659.jpg\"]",
"spu_id": 66474064261,
"cid1": 9192,
"cid2": 9193,
"cid3": 9201,
"cid1Name": "医疗保健",
"cid2Name": "营养健康",
"cid3Name": "增强免疫",
"imageList": "[{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/159657\\/1\\/7975\\/143761\\/603304e3Ef97db834\\/920ccf47b46a5170.jpg\"},
"isHot": 1,
"brandCode": 16690,
"brandName": "汤臣倍健（BY-HEALTH）",
"owner": "p",
"goodCommentsShare": 99,
"pingouPrice": null,
"pingouTmCount": null,
"pingouUrl": null,
"pingouStartTime": null,
"pingouEndTime": null,
"jd_videoList": null,
"pc_ware_style": "<p style=\"text-align: center; \"><img src=\"//img10.360buyimg.com/imgzone/jfs/t1/140373/19/6073/93482/5f3f9ad0E42617cf3/72a934af3e871cf6.jpg\" style=\"width: auto; height: auto; max-width: 100%;\"><img style=\"width:auto;height:auto;max-
},
"brand_list": [
{
"brand_id": 1,
"brand_name": "三只松鼠",
"ico": "http://img.jingtuitui.com/cbe0f202008110936494144.jpg",
"introduce": "三只松鼠-坚果领导品牌",
"slogan": "送礼首选",
"history": "2012年创建于安徽省芜湖市",
"location": "大众品牌",
"group": "零食和坚果爱好者",
"characteristic": "中国第一家纯互联网食品品牌的企业;全网零食坚果行业销量第一;买碧根果首选品牌",
"app_banner": "http://img.jingtuitui.com/36a57202008221746476067.jpg",
"top_goods": "3698015,3725577,3740530",
"today_coupon_num": 534,
"all_coupon_num": 4617076,
"goods_num": 5,
"today_goods_num": 0,
"settime": 1610380800,
"inOrderCount30Days_total": 14669,
"high_discount_price": 17,
"brand_low_discount": 6,
"goods_list": [
{
"JID": 3824983,
......
],
"brandtotal_Count": 376,
"per_page": "10",
"current_page": 1,
"last_page": 38
}
}
{
"return": "0",
"result": {
"brand": {
"id": 503,
"brand_name": "康佳",
"ico": "http://img.jingtuitui.com/76ff1202001061332513950.jpg",
"introduce": "知名国产电器品牌",
"slogan": "国产电器",
"history": "1980年创建于广东省深圳市",
"location": "大众品牌",
"group": "普通家庭",
"characteristic": "2017年销售额超过300亿元;国内最早一批涉足大屏幕显示领域的企业",
"app_banner": "http://img.jingtuitui.com/d6392202008131908374789.jpg",
"goods_num": 3,
"today_coupon_num": 28,
"all_coupon_num": 27816,
"today_goods_num": 0
},
"goods": {
"per_page": "10",
"current_page": 1,
"last_page": 1,
"data": [
{
v3版本 更新时间: 2021-02-25 14:32:14
v3更新内容
该版本功能与v2版本基本一致，该版本返回参数为京推推开放平台统一参数一、请求参数
1 原page调整为pageIndex：分页
2 原num调整为pageSize：单页显示数量
3 原goods_new_type调整为goods_type：
二、返回参数
1 原discount_start调整为get_start_time：优惠券领取开始时间
2 原discount_end调整为get_end_time：优惠券领取到期时间
3 原coupon_price调整为final_price：商品最终价格
4 原jd_brandCode调整为brandCode：京东_品牌code
5 原jd_brandName调整为brandName：京东_品牌名称
6 原commission调整为commissionshare：商品佣金比例
7 原shopid调整为shop_id：店铺id
8 原jd_imageList调整为imageList：京东图片合集
9 原total调整为total_Count：商品总数量
v2版本 更新时间: 2021-02-25 14:31:51
v2更新内容
2020年9月27日更新一、请求参数
1 增加单页面显示条数num
2 增加品牌名称搜索brand_name
二、返回参数
1 京推推品牌ID由id改为brand_id
2 品牌名称由name改为brand_name
3 增加品牌banner图（app_banner）
4 增加今日主推商品SKU列表（top_goods）
5 增加主推品牌开始时间（settime）
6 增加品牌内所有商品折扣最高值（）
7 增加品牌内所有商品中最高券面额（）
8 同步商品列表v1.1版本返回参数
| 错误码 | 说明 |
|---|---|
| 0 | 请求成功 |
| 1000 | appid或appkey错误 |
| 2000 | API次数调用超过上限 |
| 3000 | API权限不足 |
