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

相关文章

百度/小米/滴滴/京东，中台架构比较

百度/小米/滴滴/京东，中台架构比较

小米中台建设实践 01 小米的三大中台建设：业务+数据+技术 业务中台--从业务说起 在中台建设中，需要规范化的服务接口、一致整合化的数据、容器化的技术组件以及弹性的基础设施。并结合业务情况，判定是否真的需要中台。 小米参考了业界优秀的案例包括移动中台、数据中台、业务中台、技术中台等，再结合其业务发展历程及业务现状，整理了中台架构的核心方法论，一是企业如何共享服务，二是如何为业务提供便利。
阅读更多...
【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【课程链接】 AntV G6：深入图形与图形分组、自定义节点、节点动画（下）_哔哩哔哩_bilibili 本章十吾老师讲解了一个复杂的自定义节点中，应该怎样去计算和绘制图形，如何给一个图形制作不间断的动画，以及在鼠标事件之后产生动画。（有点难，需要好好理解） <!DOCTYPE html><html><head><meta charset="UTF-8"><title>06
阅读更多...
认识、理解、分类——acm之搜索

认识、理解、分类——acm之搜索

普通搜索方法有两种：1、广度优先搜索；2、深度优先搜索； 更多搜索方法： 3、双向广度优先搜索； 4、启发式搜索（包括A*算法等）； 搜索通常会用到的知识点：状态压缩（位压缩，利用hash思想压缩）。
阅读更多...
hdu1240、hdu1253（三维搜索题）

hdu1240、hdu1253（三维搜索题）

1、从后往前输入，（x，y，z）; 2、从下往上输入，（y , z, x）; 3、从左往右输入，（z，x，y）； hdu1240代码如下： #include<iostream>#include<algorithm>#include<string>#include<stack>#include<queue>#include<map>#include<stdio.h>#inc
阅读更多...
深入探索协同过滤：从原理到推荐模块案例

深入探索协同过滤：从原理到推荐模块案例

文章目录 前言一、协同过滤1. 基于用户的协同过滤（UserCF）2. 基于物品的协同过滤（ItemCF）3. 相似度计算方法 二、相似度计算方法1. 欧氏距离2. 皮尔逊相关系数3. 杰卡德相似系数4. 余弦相似度 三、推荐模块案例1.基于文章的协同过滤推荐功能2.基于用户的协同过滤推荐功能 前言     在信息过载的时代，推荐系统成为连接用户与内容的桥梁。本文聚焦于
阅读更多...
usaco 1.3 Mixing Milk (结构体排序 qsort) and hdu 2020(sort)

usaco 1.3 Mixing Milk (结构体排序 qsort) and hdu 2020(sort)

到了这题学会了结构体排序 于是回去修改了 1.2 milking cows 的算法~ 结构体排序核心： 1.结构体定义 struct Milk{int price;int milks;}milk[5000]; 2.自定义的比较函数，若返回值为正，qsort 函数判定a>b ；为负，a<b；为0，a==b； int milkcmp(const void *va,c
阅读更多...
【生成模型系列（初级）】嵌入（Embedding）方程——自然语言处理的数学灵魂【通俗理解】

【生成模型系列（初级）】嵌入（Embedding）方程——自然语言处理的数学灵魂【通俗理解】

【通俗理解】嵌入（Embedding）方程——自然语言处理的数学灵魂 关键词提炼 #嵌入方程 #自然语言处理 #词向量 #机器学习 #神经网络 #向量空间模型 #Siri #Google翻译 #AlexNet 第一节：嵌入方程的类比与核心概念【尽可能通俗】 嵌入方程可以被看作是自然语言处理中的“翻译机”，它将文本中的单词或短语转换成计算机能够理解的数学形式，即向量。 正如翻译机将一种语言
阅读更多...
【C++高阶】C++类型转换全攻略：深入理解并高效应用

【C++高阶】C++类型转换全攻略：深入理解并高效应用

📝个人主页🌹：Eternity._ ⏩收录专栏⏪：C++ “ 登神长阶 ” 🤡往期回顾🤡：C++ 智能指针 🌹🌹期待您的关注 🌹🌹 ❀C++的类型转换 📒1. C语言中的类型转换📚2. C++强制类型转换⛰️static_cast🌞reinterpret_cast⭐const_cast🍁dynamic_cast 📜3. C++强制类型转换的原因📝
阅读更多...
hdu 4517 floyd+记忆化搜索

hdu 4517 floyd+记忆化搜索

题意： 有n（100）个景点，m（1000）条路，时间限制为t（300），起点s，终点e。 访问每个景点需要时间cost_i，每个景点的访问价值为value_i。 点与点之间行走需要花费的时间为g[ i ] [ j ] 。注意点间可能有多条边。 走到一个点时可以选择访问或者不访问，并且当前点的访问价值应该严格大于前一个访问的点。 现在求，从起点出发，到达终点，在时间限制内，能得到的最大
阅读更多...
深入手撕链表

深入手撕链表

链表 分类概念单链表增尾插头插插入 删尾删头删删除 查完整实现带头不带头 双向链表初始化增尾插头插插入 删查完整代码 数组 分类 #mermaid-svg-qKD178fTiiaYeKjl {font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-svg-
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2