深入理解京东商品搜索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。

相关文章

深入理解Go语言中二维切片的使用

深入理解Go语言中二维切片的使用

《深入理解Go语言中二维切片的使用》本文深入讲解了Go语言中二维切片的概念与应用,用于表示矩阵、表格等二维数据结构,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧... 目录引言二维切片的基本概念定义创建二维切片二维切片的操作访问元素修改元素遍历二维切片二维切片的动态调整追加行动态
阅读更多...
Knife4j+Axios+Redis前后端分离架构下的 API 管理与会话方案(最新推荐)

Knife4j+Axios+Redis前后端分离架构下的 API 管理与会话方案(最新推荐)

《Knife4j+Axios+Redis前后端分离架构下的API管理与会话方案(最新推荐)》本文主要介绍了Swagger与Knife4j的配置要点、前后端对接方法以及分布式Session实现原理,... 目录一、Swagger 与 Knife4j 的深度理解及配置要点Knife4j 配置关键要点1.Spri
阅读更多...
从原理到实战深入理解Java 断言assert

从原理到实战深入理解Java 断言assert

《从原理到实战深入理解Java断言assert》本文深入解析Java断言机制,涵盖语法、工作原理、启用方式及与异常的区别,推荐用于开发阶段的条件检查与状态验证,并强调生产环境应使用参数验证工具类替代... 目录深入理解 Java 断言（assert）：从原理到实战引言：为什么需要断言？一、断言基础1.1 语
阅读更多...
MySQL中的索引结构和分类实战案例详解

MySQL中的索引结构和分类实战案例详解

《MySQL中的索引结构和分类实战案例详解》本文详解MySQL索引结构与分类,涵盖B树、B+树、哈希及全文索引,分析其原理与优劣势,并结合实战案例探讨创建、管理及优化技巧,助力提升查询性能,感兴趣的朋... 目录一、索引概述1.1 索引的定义与作用1.2 索引的基本原理二、索引结构详解2.1 B树索引2.2
阅读更多...
如何使用Maven创建web目录结构

如何使用Maven创建web目录结构

《如何使用Maven创建web目录结构》：本文主要介绍如何使用Maven创建web目录结构的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录创建web工程第一步第二步第三步第四步第五步第六步第七步总结创建web工程第一步js通过Maven骨架创pytho
阅读更多...
Python循环结构全面解析

Python循环结构全面解析

《Python循环结构全面解析》循环中的代码会执行特定的次数,或者是执行到特定条件成立时结束循环,或者是针对某一集合中的所有项目都执行一次,这篇文章给大家介绍Python循环结构解析,感兴趣的朋友跟随... 目录for-in循环while循环循环控制语句break语句continue语句else子句嵌套的循
阅读更多...
HTML5 getUserMedia API网页录音实现指南示例小结

HTML5 getUserMedia API网页录音实现指南示例小结

《HTML5getUserMediaAPI网页录音实现指南示例小结》本教程将指导你如何利用这一API，结合WebAudioAPI，实现网页录音功能,从获取音频流到处理和保存录音，整个过程将逐步... 目录1. html5 getUserMedia API简介1.1 API概念与历史1.2 功能与优势1.3
阅读更多...
一文深入详解Python的secrets模块

一文深入详解Python的secrets模块

《一文深入详解Python的secrets模块》在构建涉及用户身份认证、权限管理、加密通信等系统时,开发者最不能忽视的一个问题就是“安全性”,Python在3.6版本中引入了专门面向安全用途的secr... 目录引言一、背景与动机：为什么需要 secrets 模块？二、secrets 模块的核心功能1. 基
阅读更多...
HTML5 搜索框Search Box详解

HTML5 搜索框Search Box详解

《HTML5搜索框SearchBox详解》HTML5的搜索框是一个强大的工具，能够有效提升用户体验,通过结合自动补全功能和适当的样式，可以创建出既美观又实用的搜索界面,这篇文章给大家介绍HTML5... html5 搜索框（Search Box）详解搜索框是一个用于输入查询内容的控件，通常用于网站或应用程
阅读更多...
Go学习记录之runtime包深入解析

Go学习记录之runtime包深入解析

《Go学习记录之runtime包深入解析》Go语言runtime包管理运行时环境,涵盖goroutine调度、内存分配、垃圾回收、类型信息等核心功能,：本文主要介绍Go学习记录之runtime包的... 目录前言：一、runtime包内容学习1、作用：① Goroutine和并发控制：② 垃圾回收：③ 栈和
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2