商品文案

				
API市场> 特色栏目API >各大榜单
各大榜单 (实时销量榜等特色榜单) 免费
API类型: 特色栏目API 使用人数:5600+
槽点建议
API接口说明: 返回京推推实时领券榜、30天销量榜、30天收益榜及总领券榜,可通过eliteId值去选择想要的榜单
API使用建议: 默认实时领券榜,若不使用分类则为总类目领券榜,可使用一级分类构建分类榜单;默认返回榜单前100商品,可使用分页获取更多商品
应用场景: 构建媒体内京东特色榜单,帮助用户快速选择优质爆品,提升用户选品体验
槽点建议
版本号:v2(推荐使用此版本)
版本号:v1(即将下线)
接口地址: http://japi.jingtuitui.com/api/today_top
请求数据: http://japi.jingtuitui.com/api/today_top?appid=&appkey=&v=v2&pageIndex=&pageSize=&eliteId=&goods_type=&goods_second_type=
请求方式: 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
请求参数说明
名称 类型 必填 示例 说明
pageIndex
复制
Int 1 分页获取数据(默认第1页)
pageSize
复制
Int 20 单页面显示条数(最大100条最少10条)
eliteId
复制
String discountReal 频道ID discountReal实时爆单榜;inOrderCount30Days 30天销量榜;inOrderComm30Days 30天收益榜;discountCount总领券
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 13 京推推二级分类
返回参数说明
名称 类型 示例值 说明
return
复制
Int 0=返回成功
result
复制
返回结果
> data
复制
Array 数据明细
>> J_state
复制
Int 2 京推推商品状态(注:2正常,其他状态为非正常状态)
>> JID
复制
Int 3637626 京推推商品ID
>> goods_id
复制
Long 10023720495617 商品SKU
itemId
复制
String NVJuNYKhqfbcuNGbgB8SIyWN_3ZXBSI3iMqBf3NqHN2 联盟商品ID
>> short_name
复制
String "【旗舰店】AGExper 一次性医用口罩 50片" 商品精编标题(京推推商品精编标题)
>> goods_name
复制
String "【现货速发】AGExper一次性Yi用口罩透气成人通用内含熔喷布三层设计防护 50片装(一包装)" 京东商品原标题
>> goods_content
复制
String "三层防护,有效过滤,防雾霾、防细菌,呼吸舒畅,95%更高防护,更严苛更安心~" 推广文案(京推推商品推广文案)
>> link_content
复制
String "———刚需必囤———\r\n\r\n【旗舰店】AGExper 一次性医用口罩 50片\r\n\r\n抢购:[商品推广链接]\r\n—————————\r\n🔴到手价:5.9元\r\n\r\n🔰三层防护,有效过滤💛防雾霾、防细菌,呼吸舒畅👏95%更高防护,更严苛更安心~" 社群推广文案(京推推商品精编社群推广文案)
>> circle_content
复制
String "👏口罩还是刚需,出门一定戴好\r\n【AGExper】一次性医用口罩\r\n🔰防雾霾、防细菌,呼吸舒畅\r\n💰5.9元包邮得50片\r\n💛95%更高防护,更严苛更安心~\r\n👉抢购:[商品推广链接]"
>> goods_link
复制
String "http://item.jd.com/10023720495617.html" 京东商品链接
>> commissionShare
复制
Double 20 商品佣金比例(具体佣金可根据平台分佣体系进行计算显示)
>> brand_id
复制
Int 0 京推推品牌id,可用于品牌API商品筛选
>> inOrderCount30Days
复制
Int 92706 近30天引入单量(京东商品近30天销量)
>> inOrderComm30Days
复制
Int 129117 京东商品30天支出佣金
>> brandCode
复制
Int 630773 京东_品牌code
>> brandName
复制
String "AGExper" 京东_品牌名称
>> isHot
复制
Int 1 是否爆款(1=是;0=否)
>> comments
复制
Long 51092 评论数
>> goodCommentsShare
复制
Double 98 商品好评率
>> goods_price
复制
Double 16.9 商品原价
>> final_price
复制
Double 5.9 商品最终价格(使用优惠券后的商品最终价格)
>> historyPriceDay
复制
Int 180 历史最低价天数
>> goods_img
复制
String "http://img14.360buyimg.com/imgzone/jfs/t1/149721/10/19733/160278/5fe1a62eE2b4437a2/7c28213f0119a3f4.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\\/149721\\/10\\/19733\\/160278\\/5fe1a62eE2b4437a2\\/7c28213f0119a3f4.jpg\"}, 京东图片合集(第一张图为京东商品主图) 如因图片过大建议优化图片大小:例:http://img14.360buyimg.com/ads/s300x300_jfs/t22495/56/628456568/380476/9befc935/5b39fb01N7d1af390.jpg
>> today_num
复制
Int 5176 今日领券数(商品今日领券总量,券类型为商品券)
>> discount_link
复制
String "http://coupon.m.jd.com/coupons/show.action?key=1eeb1dd2c9654d9f9c90c185ff5a0b83&roleId=44295143&to=item.jd.com/10023720495617.html" 领券链接
>> discount_price
复制
Double 11 优惠券面额
>> get_start_time
复制
Long 1609293768000 优惠券开始时间(时间戳,java精确到毫秒,其他语言都可以精确到秒)
>> get_end_time
复制
Long 1612108798000 优惠券到期时间(时间戳,java精确到毫秒,其他语言都可以精确到秒)
>> shop_id
复制
Int 10344470 店铺id
>> shop_name
复制
String "AGExper旗舰店" 店铺名称
>> score
复制
Text "{\"afterServiceScore\":\"9.05\",\"logisticsLvyueScore\":\"8.44\",\"scoreRankRateGrade\":\"4.00\",\"userEvaluateScore\":\"9.29\"}" "店铺评分(afterServiceScore售后服务评分;logisticsLvyueScore物流履约评分; ;scoreRankRateGrade店铺星级;userEvaluateScore商品评价评分)"
>> owner
复制
String p 店铺性质:(g=自营;p=pop)
>> goods_type
复制
Int 1 京推推商品一级类目
>> goods_second_type
复制
Int 24 京推推商品二级类目(可以通过超级分类API获取全部二级类目ID)
>> spu_id
复制
Long 10023720495617 商品主SPU,其值为同款商品的主skuid
>> cid1
复制
Int 15901 京东一级类目ID
>> cid1Name
复制
String "家庭清洁/纸品" 京东一级类目名称
>> cid2
复制
Int 15903 京东二级类目ID
>> cid2Name
复制
String "清洁用具" 京东二级类目名称
>> cid3
复制
Int 15915 京东三级类目ID
>> cid3Name
复制
String "一次性清洁用品" 京东三级类目名称
>> goods_level
复制
Int 5 京推推商品类型(5=普通产品;10=优选产品;20=精选好货;30=主推(坑位等);40=爆款)
>> deliveryType
复制
Int null 京东商品类型(0=普通产品;1=京东配送)
>> jd_type
复制
Int 1 京东商品类型(1=POP;2=self自营;3=拼购)
>> 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 null 京东商品图文详情
>> discount_count
复制
Int 61252 商品总领券量
>> is_good_shop
复制
Int 0 是否京东好店(0=否,1=是)
>> is_flagship_store
复制
Int 1 是否官方旗舰店(0=否,1=是)
>> is_subsidy_goods
复制
Int 0 是否奖励商品(0=否,1=是)
> current_page
复制
Int 1 页码
> total_page
复制
Int 8310 商品总页数
> total_Count
复制
Int 83094 商品总数量
JSON返回示例

    {

        "return"0,

        "result": {

            "data": [

                {

                    "J_state"2,

                    "JID"3362433,

                    "goods_id"4608059,

                    "short_name""尊尼获加(JOHNNIE WALKER)洋酒 苏格兰进口珍藏调配威士忌750ml",

                    "goods_name""尊尼获加(JOHNNIE WALKER)洋酒 金方 金牌礼盒装 苏格兰进口珍藏调配威士忌750ml洋酒礼盒",

                    "goods_content""英国尊尼获加金牌苏格兰威士忌,琥珀流光,欢乐共享,金牌珍藏限量礼盒,口感滑腻,层次丰富,平衡甘甜!",

                    "link_content""",

                    "circle_content""",

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

                    "commissionShare"10,

                    "brand_id"0,

                    "inOrderCount30Days"5745,

                    "inOrderComm30Days"79960,

                    "brandCode"21272,

                    "brandName""尊尼获加(JOHNNIE WALKER)",

                    "isHot"1,

                    "comments"425267,

                    "goodCommentsShare"98,

                    "goods_price"360,

                    "final_price"325,

                    "historyPriceDay"140,

                    "goods_img""http://img14.360buyimg.com//imgzone//jfs/t1/123574/3/8063/112786/5f1e69a6Eb869de96/7e9c009c332c8c7b.jpg",

                    "imageList""[{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/123574\\/3\\/8063\\/112786\\/5f1e69a6Eb869de96\\/7e9c009c332c8c7b.jpg\"},{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/146823\\/1\\/3723\\/117095\\/5f1a5d5fE32bafcbf\\/c73ecc013cac83c4.jpg\"},{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/129501\\/4\\/7858\\/104545\\/5f1a5d59Ee9840c27\\/32fb5c707763602b.jpg\"},{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/114922\\/39\\/13304\\/100377\\/5f1a5d72E3071f1e2\\/f5f654c3b5213563.jpg\"},{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/147166\\/20\\/3835\\/97139\\/5f1a5d68Ea6baab67\\/d88e3fc047125710.jpg\"},{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/130637\\/35\\/5267\\/95335\\/5f1a5d78Eb4219474\\/d1ae3bd30e6e8f63.jpg\"}]",

                    "today_num"null,

                    "discount_link""https://coupon.m.jd.com/coupons/show.action?linkKey=AAROH_xIpeffAs_-naABEFoeand8QP-Wkzw2rLgI7GXac7MCPdv-jb15HRPrWrm6d8yCHA59CZPjlxchnn87tNOvL_9EXQ",

                    "discount_price"35,

                    "get_start_time"1604505600000,

                    "get_end_time"1604851199000,

                    "shop_id"1000114166,

                    "shop_name""尊尼获加自营旗舰店",

                    "score""{\"afterServiceScore\":\"\",\"logisticsLvyueScore\":\"\",\"scoreRankRateGrade\":\"\",\"userEvaluateScore\":\"\"}",

                    "owner""g",

                    "goods_type"2,

                    "goods_second_type"13,

                    "spu_id"286032,

                    "cid1"12259,

                    "cid1Name""酒类",

                    "cid2"14715,

                    "cid2Name""洋酒",

                    "cid3"14739,

                    "cid3Name""威士忌",

                    "goods_level"5,

                    "deliveryType"2,

                    "jd_type"2,

                    "pingouPrice"null,

                    "pingouTmCount"null,

                    "pingouUrl"null,

                    "pingouStartTime"null,

                    "pingouEndTime"null,

                    "jd_videoList"null,

                    "pc_ware_style""<style>.ssd-module-wrap{position:relative;margin:0 auto;width:750px;text-align:left;background-color:#fff}.ssd-module-wrap .ssd-module,.ssd-module-wrap .ssd-module-heading{width:750px;position:relative;overflow:hidden}.ssd-module-wrap .ssd-floor-activity{max-height:380px;overflow:hidden}.,

                    "discount_count"251386,

                    "is_good_shop"0,

                    "is_flagship_store"1,

                    "is_subsidy_goods"0

                },

            ],

            "second": [],

            "current_page""1",

            "total_count"97219,

            "total_page"9722

        }

    }

v1.1版本 更新时间: 2020-09-21 17:19:32

v1.1更新内容

同步商品列表v1.1版本所有返回参数(其中isHot、goods_level不返回)
错误码 说明
0 请求成功
1000 appid或appkey错误
2000 API次数调用超过上限
3000 API权限不足