商品文案

				
API市场> 特色栏目API >首焦banner
首焦banner (媒体方精品轮播展示) 免费
API类型: 特色栏目API 使用人数:1100+
槽点建议
API接口说明: 京推推首焦banner展示(v1目前展示7个单品,v2除返回单品外,另返回线报集合及活动页);资深UI精心设计界面,界面与媒体完美融合;每日选购超级爆品,产品最多展示2天,线报及活动页不定期更换,激发用户的点击率及banner使用率;产品实时自动更新,实现自动监控
API使用建议: 建议设定每2分钟拉取更新一次,v2版本当type=2时,需搭建独立的H5或构建单独的展示页,详情请见应用效果
应用场景: 构建媒体内京东版块banner区域
槽点建议
版本号:v2(推荐使用此版本)
版本号:v1
接口地址: http://japi.jingtuitui.com/api/get_banner
请求数据: http://japi.jingtuitui.com/api/get_banner?appid=&appkey=&v=v2&type=&num=
请求方式: GET / POST
支持格式: json / jsonp
系统参数
名称 类型 必填 示例 说明
appid
复制
Int 2010091553028980 您在京推推申请的appid
appkey
复制
String 2 您在京推推申请的appkey
v
复制
String v2 API接口版本号,当前版本: v2
return_type
复制
String code_jsonp 返回数据格式,不传参默认json,支持以下参数code、jsonp、code_jsonp
请求参数说明
名称 类型 必填 示例 说明
type
复制
Int 1 banner格式筛选,不传则返回全部内容: 1单品;2线报(建议搭建独立的H5或构建单独的展示页);3官方活动(输出官方活动链接,小程序跳转路径如有问题请咨询客户经理)
num
复制
Int 3 输出banner数量
返回参数说明
名称 类型 示例值 说明
return
复制
Int 0 0=返回成功
result
复制
返回结果
> type
复制
Int 1 banner类型: 1单品;2线报(建议搭建独立的H5或构建单独的展示页);3官方活动(输出官方活动链接,小程序跳转路径如有问题请咨询客户经理)
> level
复制
Int 1 banner图展示序号(可用于banner展示排序,1为第一张)
> banner_img
复制
String http://img.jingtuitui.com/1dc34202008060833239778.jpg 轮播图片地址(banner尺寸:690*280,可等比例缩放)
> background_color
复制
String #e3a8a1 图片底色色值
> banner_img_bg
复制
String http://img.jingtuitui.com/cd71a202011051721475874.jpg 线报背景图(当包含type=2时返回此参数)
> link
复制
String https://h5.m.jd.com/babelDiy/Zeus/Vfr818K8Q69jt2MqesNiKQTJv5L/index.html?babelChannel=ttt2 活动链接(当包含type=3时返回此参数)
> content
复制
String "?超级吃货专属~\n[色]专属抢购价,健康又美味\n?牛奶,辣酱,螺蛳粉,通通特价!\n?数量有限,抢完即止,你还在等什么?\n\n------------爆款推荐-------------\n\n米老头 网红切薯条200g\n10.9元:https://u.jd.com/tOt9pMZ\n\n赣南脐橙 中小果 5斤\n12.9元:https://u.jd.com/tfC2PRQ\n\n安记 柳州螺蛳粉升级版 300g/袋*5袋\n29.9元::https://u.jd.com/tXdM2wc\n\n良品铺子 每日坚果干果礼盒750g\n59元:https://u.jd.com/tytFbBK\n\n亲别找啦 新疆红枣500g*2袋\n14.9元:https://u.jd.com/tAdsdIO\n\n高乐高 巧克力味卷卷心25g*24枚\n24.9元:https://u.jd.com/tEdKkUw\n\n港荣 木糖醇早餐蒸蛋糕 420g/箱\n23.9元:https://u.jd.com/tttFnKE \n\n阿宽红油面皮 5袋 送1袋酸辣粉(共6袋)\n16.9元:https://u.jd.com/tDtxGJw" 线报文案(当包含type=2时,可复制推广)
> name
复制
String 超级吃货专属 线报主题,当type=2时返回此数据
> goods_info
复制
Array 商品信息(当包含type=2时返回goods_list,当包含type=3时不返回具体单品信息)
>> J_state
复制
Int 2 京推推商品状态(注:2正常,其他状态为非正常状态)
>> JID
复制
Int 2618668 京推推商品ID
>> goods_id
复制
Long 69404645380 商品SKU
>> short_name
复制
String 【京东商城】心相印 经典金装系列实惠装抽纸巾 8包*100抽 京推推商品精编标题
>> goods_name
复制
String 心相印抽纸家用实惠装整箱纸巾面巾餐巾心心相印纸抽专用卫生纸 DT55100 8包单提 京东商品原标题
>> goods_content
复制
String 心相印抽纸漏洞价‼️ ️️️️大牌心相印 ✅国民品牌,田馥甄独家代言! ✅精选原生木浆严格高温杀菌,不含荧光剂! 京推推商品描述文案
>> link_content
复制
String 心相印抽纸漏洞价‼️\r\n️️️️大牌心相印 ✅国民品牌,田馥甄独家代言! ✅精选原生木浆严格高温杀菌,不含荧光剂!\r\n\r\n\r\n【京东商城】心相印 经典金装系列实惠装抽纸巾 8包*100抽\r\n————————\r\n京东价:16.9元\r\n券后价:11.9元🉐8包\r\n\r\n抢购:[商品推广链接] 精编社群推广文案
>> circle_content
复制
String 心相印抽纸漏洞价‼️ 朋友圈推广文案
>> goods_link
复制
String http://item.jd.com/69404645380.html 京东商品链接
>> commissionShare
复制
Double 10 商品佣金比例(具体佣金可根据平台分佣体系进行计算显示)
>> brand_id
复制
Int 79 京推推品牌id,可用于品牌API商品筛选
>> inOrderCount30Days
复制
Int 28251 京东商品近30天销量
>> inOrderComm30Days
复制
Int 28251 京东商品30天支出佣金
>> brandCode
复制
Int 174351 京东_品牌code
>> brandName
复制
String 心相印 京东_品牌名称
>> isHot
复制
Int 1 是否爆款(1=是;0=否)
>> comments
复制
Long 999 评论数
>> goodCommentsShare
复制
Double 98 商品好评率
>> goods_price
复制
Double 16.9 商品原价
>> final_price
复制
Double 11.9 商品最终价格(使用优惠券后的商品最终价格)
>> historyPriceDay
复制
Int 100 历史最低价天数
>> goods_img
复制
String http://img.jingtuitui.com/a7e50202007171449085375.jpg 京推推商品主图(京推推优化过的商品主图,建议用户将其设为商品展示主图)
>> imageList
复制
Json [{\"url\":\"http:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/113524\\/7\\/7795\\/205633\\/5ec74d5dEd3b42153\\/18806fc93dc778a4.jpg\"},{\"url\":\"http:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/85431\\/27\\/10477\\/179313\\/5e1be4edE7767978c\\/03c1d7b0cb8d3a8c.jpg\"}, 京东图片合集(第一张图为京东商品主图)
>> today_num
复制
Int 2508 商品今日领券总量,券类型为商品券
>> discount_link
复制
String http://coupon.m.jd.com/coupons/show.action?key=93d11df3d56341d3bce564bac974ecbc&roleId=34787861&to=item.jd.com/69404645380.html 领券链接
>> discount_price
复制
Double 5 优惠券面额
>> get_start_time
复制
Long 1594915200000 优惠券开始时间(时间戳,java精确到毫秒,其他语言都可以精确到秒)
>> get_end_time
复制
Long 1595519999000 优惠券到期时间(时间戳,java精确到毫秒,其他语言都可以精确到秒)
>> shop_id
复制
Int 10274690 店铺id
>> shop_name
复制
String 亮洁清洁纸品拼购专营店 店铺名称
>> score
复制
Text {\"afterServiceScore\":\"8.73\",\"logisticsLvyueScore\":\"8.87\",\"scoreRankRateGrade\":\"\",\"userEvaluateScore\":\"9.18\"} 店铺评分(afterServiceScore售后服务评分;logisticsLvyueScore物流履约评分; ;scoreRankRateGrade店铺星级;userEvaluateScore商品评价评分)
>> owner
复制
String P 店铺性质:(g=自营;p=pop)
>> goods_type
复制
Int 1 京推推商品一级类目
>> goods_second_type
复制
Int 25 京推推商品二级类目(可以通过超级分类API获取全部二级类目ID)
>> spu_id
复制
Long  65332642093 商品主SPU,其值为同款商品的主skuid
>> cid1
复制
Int 15901 京东一级类目ID
>> cid1Name
复制
String 家庭清洁/纸品 京东一级类目名称
>> cid2
复制
Int 15902 京东二级类目ID
>> cid2Name
复制
String 清洁纸品 京东二级类目名称
>> cid3
复制
Int 15908 京东三级类目ID
>> cid3Name
复制
String 抽纸 京东三级类目名称
>> goods_level
复制
Int 20 京推推商品类型(5=普通产品;10=优选产品;20=精选好货;30=主推(坑位等);40=爆款)
>> deliveryType
复制
Int 0 京东商品类型(0=普通产品;1=京东配送)
>> jd_type
复制
Int 3 京东商品类型(1=POP;2=self自营;3=拼购)
>> pingouPrice
复制
Double 19.9 拼购价格
>> pingouTmCount
复制
Int 2 拼购所需人数
>> pingouUrl
复制
String https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=69404645380&from=cps 拼购落地页url
>> pingouStartTime
复制
Long null 拼购开始时间(java精确到毫秒,其他语言都可以精确到秒)
>> pingouEndTime
复制
Long null 拼购结束时间(java精确到毫秒,其他语言都可以精确到秒)
>> jd_videoList
复制
Text null 京东_视频集合
>> pc_ware_style
复制
Text null 京东商品图文详情
>> discount_count
复制
Int 8306 商品总领券量
JSON返回示例

    {

        "return": 0,

        "result": [

            {

                "type": "3",

                "level": "1",

                "banner_img": "http://img.jingtuitui.com/2e093202011121515335207.jpg",

                "background_color": "#efeeeb",

                "link": "https://h5.m.jd.com/babelDiy/Zeus/Vfr818K8Q69jt2MqesNiKQTJv5L/index.html?babelChannel=ttt2",

                "content": ""

            },

            {

                "type": "2",

                "level": "4",

                "name""健康生活,从“口”入",

                "banner_img": "http://img.jingtuitui.com/f6f5d202011121010192977.jpg",

                "banner_img_bg": "http://img.jingtuitui.com/262ba202011121010237993.jpg",

                "background_color": "#c0defe",

                "goods_list": [

                    {

                        "J_state": 2,

                        "JID": 3393211,

                        "goods_id": 55775595544,

                        "short_name": "【旗舰店】韩国大宇  家用冷暖两用暖风",

                        "goods_name": "韩国大宇(DAEWOO)取暖器家用暖风机浴室电暖气电暖器办公室暖气速热干衣冷暖两用烤火炉节能省电静音 网红暖风机-机械款(1500W)",

                        "goods_content": "大宇网红暖风机,冷暖两用,四季皆宜;PTC陶瓷发热,即开即热,1500W大功率,3档调节;倾\r\n倒断电更安全! 【赠运费险】购物无忧 放心购买~",

                        "link_content": "——历史最低价——\r\n\r\n【旗舰店】【韩国大宇】家用冷暖两用暖风机\r\n抢购:抢购:[商品推广链接]\r\n——————\r\n㊙㊙漏洞199\r\n\r\n🔥3券叠加!赶紧抢!秋冬必备⚠【赠运费险】\r\n",

                        "circle_content": "——抢疯了,秋冬必备——\r\n【旗舰店】【韩国大宇】家用冷暖两用暖风机\r\n㊙㊙实付199\r\n🏆1500W大功率,3档调节,10万好评\r\n⚠【赠运费险】购物无忧\r\n⭕现在不抢!旺季必涨\r\n[发抖]这个冬天特别冷\r\n抢购:[商品推广链接]",

                        "goods_link": "http://item.jd.com/55775595544.html?rid=10109",

                        "commissionShare": 20,

                        "brand_id": 0,

                        "inOrderCount30Days": 7503,

                        "inOrderComm30Days": 259600,

                        "brandCode": 401623,

                        "brandName": "大宇(DAEWOO)",

                        "isHot": 1,

                        "comments": 23241,

                        "goodCommentsShare": 99,

                        "goods_price": 369,

                        "final_price": 269,

                        "historyPriceDay": 180,

                        "goods_img": "http://img.jingtuitui.com/d7c3920201110094403265.jpg",

                        "imageList": "[{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/155284\\/37\\/5341\\/182144\\/5faa3811E9728cc64\\/c687674fd71fb20e.jpg\"},

                        "today_num": 55,

                        "discount_link": "http://coupon.m.jd.com/coupons/show.action?key=a67af9e6b8274f92b280e9ce8f1fc59c&roleId=41125168&to=item.jd.com/55775595544.html#crumb-wrap",

                        "discount_price": 100,

                        "get_start_time": 1604903897000,

                        "get_end_time": 1605542398000,

                        "shop_id": 927846,

                        "shop_name": "大宇家用电器旗舰店",

                        "score": "{\"afterServiceScore\":\"8.75\",\"logisticsLvyueScore\":\"9.45\",\"scoreRankRateGrade\":\"4.00\",\"userEvaluateScore\":\"8.95\"}",

                        "owner": "p",

                        "goods_type": 7,

                        "goods_second_type": 98,

                        "spu_id": 55775595544,

                        "cid1": 737,

                        "cid1Name": "家用电器",

                        "cid2": 738,

                        "cid2Name": "生活电器",

                        "cid3": 747,

                        "cid3Name": "取暖器",

                        "goods_level": 20,

                        "deliveryType": 1,

                        "jd_type": 1,

                        "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/80267/19/15772/217818/5dd4d9d8E3e6a881b/0e3ec490986f792f.jpg\" style=\"text-align: left; width: auto; height: auto; max-width: 100%;\"><img src=\"//img10.360buyimg.com/imgzone/jfs/t1/46244/24/15629/271122/5dd4d9dcE43ad0efc/442149b89d78974a.jpg\" 

                        "discount_count": 64

                    }

                ],

                "content": "?冬季保暖狂欢节!\n[怄火]超值低价,限时抢购\n?全网热卖爆款,秋冬必备\n❤天冷了,记得保暖哦~\n\n------------爆款推荐-------------\n【全网热销】随身暖手宝 3个装\n9.9元:https://u.jd.com/t2ddwJQ\n\n小仙女暖暖裤 多色可选\n19.9元:https://u.jd.com/tJthUJB\n\n回力 秋冬居家 棉拖鞋\n19.9元:https://u.jd.com/t3torAD\n\n猫人 冬季新款珊瑚绒睡衣 男\n49元:https://u.jd.com/tndwKI7\n\n猫人 法兰绒睡衣套装 女\n49元:https://u.jd.com/tsdOmFt\n\n【南极人】 保暖内衣黄金绒一体套装\n56.9元:https://u.jd.com/tRtkcJO\n\n富贵鸟 三合一冲锋衣(两件)\n159元:https://u.jd.com/tddKPNr"

            },

            {

                "type": "1",

                "level": "6",

                "banner_img": "http://img.jingtuitui.com/88c26202011121017261832.jpg",

                "background_color": "#ffc94b",

                "goods_info": {

                    "J_state": 2,

                    "JID": 3322728,

                    "goods_id": 10021743017801,

                    "short_name": "【历史最低价】【官方旗舰店】米老头 蛋黄煎饼饼干 牛奶味360g*3",

                    "goods_name": "米老头 饼干 蛋黄煎饼饼干 休闲零食早点 办公室小吃小煎饼 牛奶味360g*3",

                    "goods_content": "米老头华夫饼蛋黄煎饼!超市一袋18.9!精选活力小麦,鸡蛋制作,奶香浓郁,香脆可口,营养早餐好搭档,给你满满的能量守护,超级好吃,多种口味可选,独立包装,携带方便,随时随地享受美食~",

                    "link_content": "——这个也太便宜了——\r\n\r\n【官方旗舰店】米老头蛋黄煎饼饼干牛奶味360g*3袋(低热量)\r\n\r\n🔴仅需24.9元到手\r\n\r\n👉抢购:[商品推广链接]\r\n—————\r\n*折8.3元/袋,自营1袋就要18.63元😱内购非常便宜!",

                    "circle_content": "——米老头大牌,吃货必囤——\r\n\r\n【官方旗舰店】米老头 蛋黄煎饼饼干 牛奶味360g*3\r\n\r\n抢购:[商品推广链接] \r\n\r\n🔴漏洞价:24.9元🉐1080g\r\n\r\n🚚各大商超有售 多种搭配🌾低热量,高营养,好吃又养胃~",

                    "goods_link": "http://item.jd.com/10021743017801.html?rid=10109",

                    "commissionShare": 20,

                    "brand_id": 768,

                    "inOrderCount30Days": 1736,

                    "inOrderComm30Days": 8418,

                    "brandCode": 25982,

                    "brandName": "米老头",

                    "isHot": 1,

                    "comments": 5451,

                    "goodCommentsShare": 99,

                    "goods_price": 49.9,

                    "final_price": 24.9,

                    "historyPriceDay": 180,

                    "goods_img": "http://img.jingtuitui.com/78a72202010280834423398.jpg",

                    "imageList": "[{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/138961\\/31\\/12181\\/105168\\/5f97c448E2ed21d56\\/74007590bfbc48df.jpg\"},

                    "today_num": 8,

                    "discount_link": "http://coupon.m.jd.com/coupons/show.action?key=8085790e016747d299f3466c0c9d5706&roleId=40186134&to=mall.jd.com/index-705388.html",

                    "discount_price": 25,

                    "get_start_time": 1603728000000,

                    "get_end_time": 1606233599000,

                    "shop_id": 705388,

                    "shop_name": "米老头食品旗舰店",

                    "score": "{\"afterServiceScore\":\"8.43\",\"logisticsLvyueScore\":\"8.73\",\"scoreRankRateGrade\":\"4.00\",\"userEvaluateScore\":\"9.42\"}",

                    "owner": "p",

                    "goods_type": 2,

                    "goods_second_type": 16,

                    "spu_id": 32370876821,

                    "cid1": 1320,

                    "cid1Name": "食品饮料",

                    "cid2": 1583,

                    "cid2Name": "休闲食品",

                    "cid3": 1595,

                    "cid3Name": "饼干蛋糕",

                    "goods_level": 20,

                    "deliveryType": 0,

                    "jd_type": 1,

                    "pingouPrice": null,

                    "pingouTmCount": null,

                    "pingouUrl": null,

                    "pingouStartTime": null,

                    "pingouEndTime": null,

                    "jd_videoList": null,

                    "pc_ware_style": "<p><img style=\"width:auto;height:auto;max-width:100%;\" src=\"//img10.360buyimg.com/imgzone/jfs/t1/119995/23/6792/456292/5f07eebcE43b988f1/a0c01584e15ee7ab.jpg\"><img style=\"width:auto;height:auto;max-width:100%;

                    "discount_count": 4282

                },

                "content": ""

            }

        ]

    }


v2版本 更新时间: 2021-02-24 18:50:45

v2更新内容

返回参数
新增name:线报主题

v2版本 更新时间: 2021-02-24 18:49:40

v2更新内容

1   新增活动会场返回
2   新增线报返回
3   同步商品列表v2返回参数
错误码 说明
0 请求成功
1000 appid或appkey错误
2000 API次数调用超过上限
3000 API权限不足