本文主要是介绍深入理解京东商品搜索API(jd.item_search)返回值结构,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
京东商品搜索API(jd.item_search
)的返回值结构通常是一个复杂的JSON对象,它包含了关于搜索结果的详细信息。为了深入理解这个返回值结构,我们可以将其大致分解为几个主要部分。
-
status:
- code: 响应状态码,通常200表示成功。
- message: 响应消息,描述操作的结果。
- error: 如果出现错误,这里会包含错误详细信息;否则为null。
-
result:
- keyword: 用户搜索的关键词。
- page_size: 每页显示的商品数量。
- page_num: 当前页码。
- total_results: 总共搜索到的商品数量。
- gen_time: 响应生成的时间。
- items: 商品列表,包含多个商品对象的数组。
每个item对象都代表一个搜索到的商品,包含以下信息:
- sku_id: 商品的SKU ID,用于唯一标识商品。
- sku_name: 商品名称。
- price: 商品价格。
- image: 商品图片的URL。
- shop_name: 销售该商品的店铺名称。
- shop_id: 店铺ID。
- promotion: 商品的促销活动信息,如打折、满减等。
- category: 商品所属的类别。
- brand: 商品的品牌名称。
- spec: 商品的规格参数。
- comment_count: 商品的评价数量。
- comment_rating: 商品的评价平均分。
- sale_count: 商品的销量。
- is_presale: 是否是预售商品。
jd.item_search
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter=
参数说明:q:搜索关键字
sort:排序[bid,_bid,_sale,_review,_new]
(bid:总价,sale:销量,review评论数,new新品,加_前缀为从大到小排序)<
page:
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
items | items[] | 0 | 按关键字搜索商品 |
返回数据示例
"items": {"page": "1","url": "https://search.jd.com/Search?keyword=%E5%A5%B3%E8%A3%85","keyword": "%E5%A5%B3%E8%A3%85","real_total_results": 10000,"total_results": 10000,"page_size": 20,"pagecount": 500,"data_from": "ha","item": [{"title": "恒源祥民族风复古高端香云纱袍子长款中长袖秋季新款连衣裙女装 高档女装高档女装衣服:绿色 高档女装高档女装衣服:XL","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/229888/17/7138/103455/657d33e2Fb291bf94/e0550ecfc9d4cf72.jpg","price": "220","sales": 0,"num_iid": "10072445837225","area": "","seller": "恒源祥唐春(新余)专卖店","seller_id": "","detail_url": "https://item.jd.com/10072445837225.html"},{"title": "恒源祥气质夏装网纱裙洋气减龄短袖裙子薄款中年女装连衣裙 高档女装高档女装衣服:粉色 高档女装高档女装衣服:XL","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/233125/37/8742/159235/657d33e3Fc9955b24/1e529d7bc36850ec.jpg","price": "208","sales": 0,"num_iid": "10072392554898","area": "","seller": "恒源祥唐春(新余)专卖店","seller_id": "","detail_url": "https://item.jd.com/10072392554898.html"},{"title": "恒源祥夏季2023新款棉麻女装复古刺绣亚麻连衣裙女长款短袖轻中式旗袍 高档女装高档女装衣服:紫色 高档女装高档女装衣服:XL","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/234995/12/8473/132011/657d33e2F77552971/cc68b2ec9d2b7f40.jpg","price": "210","sales": 0,"num_iid": "10072445027274","area": "","seller": "恒源祥唐春(新余)专卖店","seller_id": "","detail_url": "https://item.jd.com/10072445027274.html"},{"title": "恒源祥台湾网纱连衣裙2023夏装洋气蕾丝裙子中年女装高端大牌中长裙子 高档女装高档女装衣服:绿色 高档女装高档女装衣服:XL","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/230665/15/7877/144632/6579605eF0b2a51b5/e421ea8810202f58.jpg","price": "208","sales": 0,"num_iid": "10072445052226","area": "","seller": "恒源祥唐春(新余)专卖店","seller_id": "","detail_url": "https://item.jd.com/10072445052226.html"},{"title": "恒源祥夏季高档棉麻裙子仿仿仿真丝仿桑蚕丝背心裙2023新款女装色气质连 高档女装高档女装衣服:黑色 高档女装高档女装衣服:XL","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/229894/27/8084/105508/657d33e2F7b8d70e7/8ea5c1b283acdb9a.jpg","price": "199","sales": 0,"num_iid": "10072444449819","area": "","seller": "恒源祥唐春(新余)专卖店","seller_id": "","detail_url": "https://item.jd.com/10072444449819.html"},{"title": "恒源祥夏季中袖定位花连衣裙女2023新款中年女装洋气显瘦遮肉裙子 高档女装高档女装衣服:焦糖色 高档女装高档女装衣服:XL","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/228619/17/8030/102305/657d33e1Ffed8f97c/7f6d18e2b6132629.jpg","price": "215","sales": 0,"num_iid": "10072445516016","area": "","seller": "恒源祥唐春(新余)专卖店","seller_id": "","detail_url": "https://item.jd.com/10072445516016.html"},{"title": "乙纱2023秋季新款女装收腰显遮肚子秋冬女装连衣裙女装 黑色 M","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/208206/39/35861/43205/65379b40Fec8b5c22/ecf24a51e5f34b6c.jpg","price": "146","sales": 0,"num_iid": "10089179742101","area": "","seller": "乙纱旗舰店","seller_id": "","detail_url": "https://item.jd.com/10089179742101.html"},{"title": "YZYU优衣官方依库女装翻领短袖T恤女装洋气拼接polo衫2024新款体 白色品牌官方女装 M品牌官方女装","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/195619/23/42773/71794/65f72062F168fefac/3cb8e50b79920242.jpg","price": "98","sales": 0,"num_iid": "10097856169583","area": "","seller": "悦曼服饰专营店","seller_id": "","detail_url": "https://item.jd.com/10097856169583.html"},{"title": "YZYU优衣官方依库女装宽松短袖2024新款体恤女装夏季薄款上衣小衫 黑色品牌官方女装 M品牌官方女装","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/112313/15/41494/60448/65f71fdfF04bf3ec9/9076b279c0b5a7dc.jpg","price": "88","sales": 0,"num_iid": "10097856062918","area": "","seller": "悦曼服饰专营店","seller_id": "","detail_url": "https://item.jd.com/10097856062918.html"},{"title": "佐径(ZUOJING)2023秋季新款女装收腰显遮肚子秋冬女装连衣裙女装 黑色 M","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/182426/34/41222/47675/65379afbF64b66673/41925abb5f7c3ed2.jpg","price": "146","sales": 0,"num_iid": "10089176055877","area": "","seller": "佐径(ZUOJING)旗舰店","seller_id": "","detail_url": "https://item.jd.com/10089176055877.html"},{"title": "踏司红高端女装8607春装女装新款茶歇法式长裙感小香风碎花高端女装连衣 花色 S","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/101216/4/47604/115105/65eff71bF5921142f/4db87e77ecd48a61.jpg","price": "178","sales": 0,"num_iid": "10098088553178","area": "","seller": "踏司红中老年旗舰店","seller_id": "","detail_url": "https://item.jd.com/10098088553178.html"},{"title": "佐径(ZUOJING)2023秋季新款女装收腰显遮肚子秋冬女装连衣裙女装 黑色 M","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/236962/29/545/44153/65379ab2F39cedf24/95e7cf5bf37295ac.jpg","price": "146","sales": 0,"num_iid": "10089166815662","area": "","seller": "佐径服饰旗舰店","seller_id": "","detail_url": "https://item.jd.com/10089166815662.html"},{"title": "YZYU优衣官方依库女装纯棉v领短袖T恤女装绣花上衣2024新款休闲体恤 白色品牌官方女装 M品牌官方女装","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/168529/32/42753/83658/65f72045Fa6b20004/2c65956fd5bf9dc1.jpg","price": "88","sales": 0,"num_iid": "10097856005091","area": "","seller": "悦曼服饰专营店","seller_id": "","detail_url": "https://item.jd.com/10097856005091.html"},{"title": "YZYU优衣官方依库女装纯棉白色T恤女装春秋套头圆领长袖基础上衣 白色棉品牌官方女装 S品牌官方女装","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/146320/10/41861/75917/65f72364F27667515/c5ed886a93edb0ef.jpg","price": "118","sales": 0,"num_iid": "10098379703983","area": "","seller": "悦曼服饰专营店","seller_id": "","detail_url": "https://item.jd.com/10098379703983.html"},{"title": "YZYU优衣官方依库女装短袖T恤女装夏春季韩版印花宽松情侣正肩圆领ins 黑色品牌官方女装 S品牌官方女装","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/188573/14/37067/159324/65f7210eF3ada1f26/130048f25047f44a.jpg","price": "59","sales": 0,"num_iid": "10097879600044","area": "","seller": "悦曼服饰专营店","seller_id": "","detail_url": "https://item.jd.com/10097879600044.html"},{"title": "简夕墨 女装新款女装修身v领短款上衣服夏季新款女装紧身短袖T 灰色 S70-85斤","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/183508/30/13348/167835/60e85df5Ec2f6cf24/df1f064fe2f17575.jpg","price": "32","sales": 0,"num_iid": "10033647072608","area": "","seller": "简夕墨服饰官方旗舰店","seller_id": "","detail_url": "https://item.jd.com/10033647072608.html"},{"title": "毕航【女装】轻奢高端女装T恤女黑色半高领长袖打底衫女装秋冬 酒红色 S","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/210510/22/33054/85815/652a04b2Ffba72029/da147d3947444904.jpg","price": "168","sales": 0,"num_iid": "10088255298632","area": "","seller": "毕航鞋靴旗舰店","seller_id": "","detail_url": "https://item.jd.com/10088255298632.html"},{"title": "皮尔卡丹【轻奢】品牌女装法式连衣裙套装夏装新款女装盐系洋气上衣服 法国品牌旗舰女装秀红 短袖 法国品牌旗舰女装S","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/207601/32/33033/97958/6505a30fF52cf18d4/ada1549509950caa.jpg","price": "288","sales": 0,"num_iid": "10085273013782","area": "","seller": "皮尔卡丹千清漪专卖店","seller_id": "","detail_url": "https://item.jd.com/10085273013782.html"},{"title": "皮尔卡丹轻奢高档女装春秋季连衣裙新款2023中年妈m洋气品牌贵妇女装人气 咖色 XL","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/572/5/20772/55534/63f8361dFe4a4a7bb/e2351a65f09dbe98.jpg","price": "548","sales": 0,"num_iid": "10069517573477","area": "","seller": "皮尔卡丹伊伦专卖店","seller_id": "","detail_url": "https://item.jd.com/10069517573477.html"},{"title": "YZYU优衣官方依库女装v领短袖T恤女2024新款夏季衣服女装上衣洋气半袖 皮粉色品牌官方女装 M品牌官方女装","pic_url": "https://img11.360buyimg.com/n0/jfs/t1/137705/9/40832/58432/65ec1664F93f132d4/ea6564449a974088.jpg","price": "88","sales": 0,"num_iid": "10097855946063","area": "","seller": "悦曼服饰专营店","seller_id": "","detail_url": "https://item.jd.com/10097855946063.html"}]},"error_code": "0000","reason": "ok","secache": "a8881ed5637e3c7e84f03acdc86be64f","secache_time": 1710742964,"secache_date": "2024-03-18 14:22:44","translate_status": "","translate_time": 0,"language": {"default_lang": "cn","current_lang": "cn"},"error": "","cache": 0,"api_info": "today:159 max:10000 all[396=159+189+48];expires:2030-10-30","execution_time": "9.889","server_time": "Beijing/2024-03-18 14:22:44","client_ip": "106.6.37.50","call_args": {"q": "女装","start_price": "0","end_price": "0","page": "1","cat": "0"},"api_type": "jd","translate_language": "zh-CN","translate_engine": "baidu","server_memory": "0.85MB","request_id": "gw-4.65f7ddaa88113","last_id": "2705647087"
}
错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
---|---|---|---|
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |
这篇关于深入理解京东商品搜索API(jd.item_search)返回值结构的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!