京推推首页
您好 ，请登录 免费注册
小工具 商家合作 开放平台API 帮助中心 联系我们
小程序
在线客服
我的收藏
帮助中心
官方采集群 在线客服
我的收藏 管理收藏夹
收起
商品文案 

				

				
			

		

	

	
	





    API基础说明
    系统参数
    请求参数
    返回参数
    返回示例
    
    






    

        API市场>
        入库更新API >商品更新（即将下线）
    






 
 
商品更新（即将下线） （定期更新商品库所有商品） 免费
 
API类型: 入库更新API 使用人数:1600+
 
 槽点建议
 
API接口说明： 首次通过商品列表获取商品后，后续商品可使用定时拉取接口进行增量更新，同时同步实时更新商品库已有商品状态（包括销量、领券量、佣金、价格等全部信息变动及下架商品）
 
API使用建议： 
                            建议每5分钟调用一次，当只返回单个商品SKU时，则表示该商品为下架商品                        
 
应用场景： 京推推商品全库更新（仅建议商品列表全量入库使用）
 
 应用效果  免费接入  接口测试
 
槽点建议 
 
  
 
 
 
 
 
 
 上传图片
                                 
 
 
提交
 
 
 
 
 
 
API接口明细 API更新记录 错误参照代码
 

                            版本号：v2
                        

                            版本号：v1（即将下线）
                        
 
接口地址: http://japi.jingtuitui.com/api/get_goods_update
 
请求数据: http://japi.jingtuitui.com/api/get_goods_update?appid=&appkey=&v=v2&pageIndex=&pageSize=&goods_type=&goods_second_type=&eliteId=&sortName=&sort=&price_start=&price_end=&start_time=&state=
 
请求方式: 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条)
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 
                                                京推推二级分类（可通过超级分类API获取全部的二级分类id，本接口也有返回）
eliteId 
 复制
 String 
                                                否 
                                                    sift 
                                                频道id： sift精选好货；nineSift“9块9”精选；collage京东拼购；self京东自营；wtype京东配送；goodShop京东好店；flagShop官方旗舰店；giftGoods奖励商品
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 
                                                价格筛选:最高价格
start_time 
 复制
 Long 
                                                否 
                                                    1605077381 
                                                拉取商品开始时间，时间戳到秒:1603956576（注:time()-2*60*60，建议每10分钟拉取一次）
state 
 复制
 Int 
                                                否 
                                                    1 
                                                更新商品状态筛选： 1状态异常；2状态正常
 
返回参数说明 
 
名称 类型 示例值 说明
 
return 
 复制
 Int 
                                                0 
                                                0=返回成功
result 
 复制
  
                                                 
                                                返回结果
> data 
 复制
 Array 
                                                 
                                                数据明细
>> J_state 
 复制
 Int 
                                                2 
                                                京推推商品状态(注:2正常，其他状态为非正常状态)
>> JID 
 复制
 Int 
                                                3394028 
                                                京推推商品ID
>> goods_id 
 复制
 Long 
                                                10024229434339 
                                                商品SKU
>itemId 
 复制
 String 
                                                Q9Z2ZdyMsa9g7jpsfgQNVA0R_3SD7M7ISbsR0zCKPo 
                                                联盟商品ID
>> short_name 
 复制
 String 
                                                "天海藏 翡翠生白虾仁300g*2袋+大扇贝6枚*3袋" 
                                                京推推商品精编标题
>> goods_name 
 复制
 String 
                                                "【拍3份】【第2份9.9元 第3份0元 虾仁300g】天海藏 翡翠生白虾仁 海鲜 虾仁300g*2袋+大扇贝6枚*3袋" 
                                                京东商品原标题
>> goods_content 
 复制
 String 
                                                "天海藏虾仁、扇贝组合装，一次购买拥有两种美味！14万评价推荐，值得购买！" 
                                                京推推商品描述文案
>> link_content 
 复制
 String 
                                                "💁一次购买拥有两种美味👊14万+评价推荐，值得购买！\r\n\r\n[色]虾仁肉质紧实，鲜嫩Q弹\r\n[色]扇贝蒜香浓郁，爽滑劲道\r\n\r\n天海藏 翡翠生白虾仁300g*2袋+大扇贝6枚*3袋\r\n————————\r\n京东价：100.7元\r\n券后价：89.7元🉐共5袋\r\n\r\n抢购：[商品推广链接]" 
                                                精编社群推广文案
>> circle_content 
 复制
 String 
                                                "💁一次购买拥有两种美味\r\n👊14万+评价推荐，值得购买\r\n[色]虾仁肉质紧实，鲜嫩Q弹\r\n[色]扇贝蒜香浓郁，爽滑劲道\r\n\r\n券后价：89.7元🉐共5袋\r\n抢购：[商品推广链接]" 
                                                朋友圈推广文案
>> goods_link 
 复制
 String 
                                                "http://item.jd.com/10024229434339.html?rid=10109" 
                                                京东商品链接
>> commissionShare 
 复制
 Double 
                                                15 
                                                商品佣金比例（具体佣金可根据平台分佣体系进行计算显示）
>> brand_id 
 复制
 Int 
                                                474 
                                                京推推品牌id,可用于品牌API商品筛选
>> inOrderCount30Days 
 复制
 Int 
                                                2969 
                                                京东商品近30天销量
>> inOrderComm30Days 
 复制
 Double 
                                                40246 
                                                京东商品30天支出佣金
>> brandCode 
 复制
 Int 
                                                290234 
                                                京东_品牌code
>> brandName 
 复制
 String 
                                                天海藏 
                                                京东_品牌名称
>> isHot 
 复制
 Int 
                                                1 
                                                是否爆款（1=是；0=否）
>> comments 
 复制
 Long 
                                                145856 
                                                评论数
>> goodCommentsShare 
 复制
 Double 
                                                97 
                                                商品好评率
price_Info 
 复制
  
                                                 
                                                价格信息（结果不返回，仅作为文档分类展示）
>> goods_price 
 复制
 Double 
                                                100.7 
                                                商品原价
>> final_price 
 复制
 Double 
                                                89.7 
                                                商品最终价格（使用优惠券后的商品最终价格）
>> historyPriceDay 
 复制
 Int 
                                                180 
                                                历史最低价天数
img_info 
 复制
  
                                                 
                                                图片信息（结果不返回，仅作为文档分类展示）
>> goods_img 
 复制
 String 
                                                "http://img.jingtuitui.com/c2fe2202011101337416986.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\\/89117\\/40\\/15663\\/148082\\/5e7436d1E654ab3bd\\/61583413d342d6ff.jpg\"} 
                                                京东图片合集（第一张图为京东商品主图） 如因图片过大建议优化图片大小：例：http://img14.360buyimg.com/ads/s300x300_jfs/t22495/56/628456568/380476/9befc935/5b39fb01N7d1af390.jpg
coupon_Info 
 复制
  
                                                 
                                                优惠券信息（结果不返回，仅作为文档分类展示）
>> today_num 
 复制
 Int 
                                                1 
                                                商品今日领券总量，券类型为商品券
>> discount_link 
 复制
 String 
                                                "http://coupon.m.jd.com/coupons/show.action?key=3c9fcb7e200e4fc9872767067493153a&roleId=41197802&to=item.jd.com/10024229434339.html#crumb-wrap" 
                                                领券链接
>> discount_price 
 复制
 Double 
                                                11 
                                                优惠券面额
>> get_start_time 
 复制
 Long 
                                                1604980120000 
                                                优惠券开始时间(时间戳，java精确到毫秒，其他语言都可以精确到秒)
>> get_end_time 
 复制
 Long 
                                                1606060798000 
                                                优惠券到期时间(时间戳，java精确到毫秒，其他语言都可以精确到秒)
shop_Info 
 复制
  
                                                 
                                                店铺信息（结果不返回，仅作为文档分类展示）
>> shop_id 
 复制
 Int 
                                                724148 
                                                店铺id
>> shop_name 
 复制
 String 
                                                "天海藏生鲜旗舰店" 
                                                店铺名称
>> score 
 复制
 String 
                                                null 
                                                "店铺评分（afterServiceScore售后服务评分；logisticsLvyueScore物流履约评分； ;scoreRankRateGrade店铺星级；userEvaluateScore商品评价评分)"
>> owner 
 复制
 String 
                                                p 
                                                店铺性质:（g=自营；p=pop）
category_Info 
 复制
  
                                                 
                                                类目信息（结果不返回，仅作为文档分类展示）
>> goods_type 
 复制
 Int 
                                                3 
                                                京推推商品一级类目
>> goods_second_type 
 复制
 Int 
                                                4 
                                                京推推商品二级类目（可以通过超级分类API获取全部二级类目ID）
>> spu_id 
 复制
 Long 
                                                44243718559 
                                                商品主SPU，其值为同款商品的主skuid
>> cid1 
 复制
 Int 
                                                12218 
                                                京东一级类目ID
>>  cid1Name 
 复制
 String 
                                                "生鲜" 
                                                京东一级类目名称
>> cid2 
 复制
 Int 
                                                12222 
                                                京东二级类目ID
>>  cid2Name 
 复制
 String 
                                                "海鲜水产" 
                                                京东二级类目名称
>> cid3 
 复制
 Int 
                                                12242 
                                                京东三级类目ID
>>  cid3Name 
 复制
 String 
                                                "虾类" 
                                                京东三级类目名称
>> goods_level 
 复制
 Int 
                                                20 
                                                京推推商品类型（5=普通产品；10=优选产品；20=精选好货；30=主推(坑位等)；40=爆款）
>> deliveryType 
 复制
 Int 
                                                0 
                                                京东商品类型（0=普通产品；1=京东配送）
>> jd_type 
 复制
 Int 
                                                1 
                                                京东商品类型（1=POP；2=self自营；3=拼购）
PinGou_Info 
 复制
  
                                                 
                                                拼购信息（结果不返回，仅作为文档分类展示）
>> 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 
                                                "<div style=\"text-align: center;\"><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/114117/34/12070/1221188/5f082de2E74809b3a/0fd209ac91eec08a.jpg\" usemap=\"#Map213\">\n<map name=\"Map213\">\n  <area shape=\"rect\" coords=\"17,377,266,708\" href=\"https://item.jd.com/44243718559.html\" target=\"_blank\">\n  
                                                京东商品图文详情
>> discount_count 
 复制
 Int 
                                                2 
                                                商品总领券量
>> 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 
                                                98731 
                                                商品总页数
> total_Count 
 复制
 Int 
                                                9874 
                                                商品总数量
 
JSON返回示例 
 

    { 
    "return": 0,
        "result": {
            "data": [
                {
                    "J_state": 2,
                    "JID": 3394028,
                    "goods_id": 10024229434339,
                    "short_name": "天海藏 翡翠生白虾仁300g*2袋+大扇贝6枚*3袋",
                    "goods_name": "【拍3份】【第2份9.9元 第3份0元 虾仁300g】天海藏 翡翠生白虾仁 海鲜 虾仁300g*2袋+大扇贝6枚*3袋",
                    "goods_content": "天海藏虾仁、扇贝组合装，一次购买拥有两种美味！14万评价推荐，值得购买！",
                    "link_content": "💁一次购买拥有两种美味👊14万+评价推荐，值得购买！\r\n\r\n[色]虾仁肉质紧实，鲜嫩Q弹\r\n[色]扇贝蒜香浓郁，爽滑劲道\r\n\r\n天海藏 翡翠生白虾仁300g*2袋+大扇贝6枚*3袋\r\n————————\r\n京东价：100.7元\r\n券后价：89.7元🉐共5袋\r\n\r\n抢购：[商品推广链接]",
                    "circle_content": "💁一次购买拥有两种美味\r\n👊14万+评价推荐，值得购买\r\n[色]虾仁肉质紧实，鲜嫩Q弹\r\n[色]扇贝蒜香浓郁，爽滑劲道\r\n\r\n券后价：89.7元🉐共5袋\r\n抢购：[商品推广链接]",
                    "goods_link": "http://item.jd.com/10024229434339.html?rid=10109",
                    "commissionShare": 15,
                    "brand_id": 474,
                    "inOrderCount30Days": 2969,
                    "inOrderComm30Days": 40246,
                    "brandCode": 290234,
                    "brandName": "天海藏",
                    "isHot": 1,
                    "comments": 145856,
                    "goodCommentsShare": 97,
                    "goods_price": 100.7,
                    "final_price": 89.7,
                    "historyPriceDay": null,
                    "goods_img": "http://img.jingtuitui.com/c2fe2202011101337416986.jpg",
                    "imageList": "[{\"url\":\"https:\\/\\/img14.360buyimg.com\\/pop\\/jfs\\/t1\\/89117\\/40\\/15663\\/148082\\/5e7436d1E654ab3bd\\/61583413d342d6ff.jpg\"},
                    "today_num": 1,
                    "discount_link": "http://coupon.m.jd.com/coupons/show.action?key=3c9fcb7e200e4fc9872767067493153a&roleId=41197802&to=item.jd.com/10024229434339.html#crumb-wrap",
                    "discount_price": 11,
                    "get_start_time": 1604980120000,
                    "get_end_time": 1606060798000,
                    "shop_id": 724148,
                    "shop_name": "天海藏生鲜旗舰店",
                    "score": null,
                    "owner": "p",
                    "goods_type": 3,
                    "goods_second_type": 4,
                    "spu_id": 44243718559,
                    "cid1": 12218,
                    "cid1Name": "生鲜",
                    "cid2": 12222,
                    "cid2Name": "海鲜水产",
                    "cid3": 12242,
                    "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": "<div style=\"text-align: center;\"><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/114117/34/12070/1221188/5f082de2E74809b3a/0fd209ac91eec08a.jpg\" usemap=\"#Map213\">\n<map name=\"Map213\">\n  <area shape=\"rect\" coords=\"17,377,266,708\" href=\"https://item.jd.com/44243718559.html\" target=\"_blank\">\n  <area shape=\"rect\" coords=\"276,376,523,708\" href=\"https://item.jd.com/50580381564.html\" target=\"_blank\">\n  <area shape=\"rect\" coords=\"534,375,782,708\" href=\"https://item.jd.com/48230162719.html\" target=\"_blank\">\n  <area shape=\"rect\" coords=\"18,718,263,1049\" href=
                    "discount_count": 2,
                    "is_good_shop": 0,
                    "is_flagship_store": 1,
                    "is_subsidy_goods": 0
                }
    ],
            "second": [],
            "current_page": 1,
            "total_count": 98731,
            "total_page": 9874
        }
    }
 
V2版本 更新时间: 2024-03-30 11:25:47
 
 
V2更新内容

                                                        一、返回参数

新增itemId：联盟商品ID                        
 
错误码 说明
 
0 请求成功
 
1000 appid或appkey错误
 
2000 API次数调用超过上限
 
3000 API权限不足







	
		

			

				

					
					
					
				

				
CopyRight © 2015-2022 京推推 www.jingtuitui.com 浙ICP备17019584号