深入理解京东商品搜索API（jd.item_search）返回值结构

2024-05-08 18:20
文章标签 搜索 深入 理解 api 商品 结构 返回值 search item 京东 jd

本文主要是介绍深入理解京东商品搜索API（jd.item_search）返回值结构，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

京东商品搜索API（jd.item_search）的返回值结构通常是一个复杂的JSON对象，它包含了关于搜索结果的详细信息。为了深入理解这个返回值结构，我们可以将其大致分解为几个主要部分。

  1. status:

    • code: 响应状态码，通常200表示成功。
    • message: 响应消息，描述操作的结果。
    • error: 如果出现错误，这里会包含错误详细信息；否则为null。

  2. 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

公共参数

名称类型必须描述
keyString是调用key（必须以GET方式拼接在URL中）
secretString是调用密钥
api_nameString是API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cacheString否[yes,no]默认yes，将调用缓存的数据，速度比较快
result_typeString否[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
langString否[cn,en,ru]翻译语言，默认cn简体中文
versionString否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)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据是
2000Search success but no result接口访问成功，但是搜索没有结果是
4000Server internal error服务器内部错误否
4001Network error网络错误否
4002Target server error目标服务器错误否
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时否
5000unknown error未知错误否

这篇关于深入理解京东商品搜索API（jd.item_search）返回值结构的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/971077。

相关文章

Java并发编程必备之Synchronized关键字深入解析

Java并发编程必备之Synchronized关键字深入解析

《Java并发编程必备之Synchronized关键字深入解析》本文我们深入探索了Java中的Synchronized关键字,包括其互斥性和可重入性的特性,文章详细介绍了Synchronized的三种... 目录一、前言二、Synchronized关键字2.1 Synchronized的特性1. 互斥2.
阅读更多...
使用Java实现通用树形结构构建工具类

使用Java实现通用树形结构构建工具类

《使用Java实现通用树形结构构建工具类》这篇文章主要为大家详细介绍了如何使用Java实现通用树形结构构建工具类,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录完整代码一、设计思想与核心功能二、核心实现原理1. 数据结构准备阶段2. 循环依赖检测算法3. 树形结构构建4. 搜索子
阅读更多...
基于Flask框架添加多个AI模型的API并进行交互

基于Flask框架添加多个AI模型的API并进行交互

《基于Flask框架添加多个AI模型的API并进行交互》：本文主要介绍如何基于Flask框架开发AI模型API管理系统,允许用户添加、删除不同AI模型的API密钥,感兴趣的可以了解下... 目录1. 概述2. 后端代码说明2.1 依赖库导入2.2 应用初始化2.3 API 存储字典2.4 路由函数2.5 应
阅读更多...
利用Python开发Markdown表格结构转换为Excel工具

利用Python开发Markdown表格结构转换为Excel工具

《利用Python开发Markdown表格结构转换为Excel工具》在数据管理和文档编写过程中,我们经常使用Markdown来记录表格数据,但它没有Excel使用方便,所以本文将使用Python编写一... 目录1.完整代码2. 项目概述3. 代码解析3.1 依赖库3.2 GUI 设计3.3 解析 Mark
阅读更多...
一文带你深入了解Python中的GeneratorExit异常处理

一文带你深入了解Python中的GeneratorExit异常处理

《一文带你深入了解Python中的GeneratorExit异常处理》GeneratorExit是Python内置的异常,当生成器或协程被强制关闭时,Python解释器会向其发送这个异常,下面我们来看... 目录GeneratorExit：协程世界的死亡通知书什么是GeneratorExit实际中的问题案例
阅读更多...
Redis中如何实现商品秒杀

Redis中如何实现商品秒杀

《Redis中如何实现商品秒杀》：本文主要介绍Redis中如何实现商品秒杀问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录技术栈功能实现步骤步骤一：准备商品库存数据步骤二：实现商品秒杀步骤三：优化Redis性能技术讲解Redis的List类型Redis的Set
阅读更多...
Javascript访问Promise对象返回值的操作方法

Javascript访问Promise对象返回值的操作方法

《Javascript访问Promise对象返回值的操作方法》这篇文章介绍了如何在JavaScript中使用Promise对象来处理异步操作,通过使用fetch()方法和Promise对象,我们可以从... 目录在Javascript中，什么是Promise1- then() 链式操作2- 在之后的代码中使
阅读更多...
Python使用DeepSeek进行联网搜索功能详解

Python使用DeepSeek进行联网搜索功能详解

《Python使用DeepSeek进行联网搜索功能详解》Python作为一种非常流行的编程语言,结合DeepSeek这一高性能的深度学习工具包,可以方便地处理各种深度学习任务,本文将介绍一下如何使用P... 目录一、环境准备与依赖安装二、DeepSeek简介三、联网搜索与数据集准备四、实践示例：图像分类1.
阅读更多...
C#集成DeepSeek模型实现AI私有化的流程步骤(本地部署与API调用教程)

C#集成DeepSeek模型实现AI私有化的流程步骤(本地部署与API调用教程)

《C#集成DeepSeek模型实现AI私有化的流程步骤(本地部署与API调用教程)》本文主要介绍了C#集成DeepSeek模型实现AI私有化的方法,包括搭建基础环境,如安装Ollama和下载DeepS... 目录前言搭建基础环境1、安装 Ollama2、下载 DeepSeek R1 模型客户端 ChatBo
阅读更多...
mysql通过frm和ibd文件恢复表_mysql5.7根据.frm和.ibd文件恢复表结构和数据

mysql通过frm和ibd文件恢复表_mysql5.7根据.frm和.ibd文件恢复表结构和数据

《mysql通过frm和ibd文件恢复表_mysql5.7根据.frm和.ibd文件恢复表结构和数据》文章主要介绍了如何从.frm和.ibd文件恢复MySQLInnoDB表结构和数据,需要的朋友可以参... 目录一、恢复表结构二、恢复表数据补充方法一、恢复表结构（从 .frm 文件）方法 1：使用 mysq
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2