京东按关键字搜索商品 API（jd.item_search）返回值全面解析
作者：技术冰糖葫芦
- 2024-05-08 江西
本文字数：7418 字
阅读完需：约 24 分钟
当使用京东的按关键字搜索商品 API（jd.item_search）时，返回的结果通常是一个 JSON 格式的字符串，包含了与搜索关键词相关的商品信息。以下是对该 API 返回值的全面解析：
一、公共参数
requestId：请求的唯一标识符，用于追踪和调试请求。
timestamp：请求的时间戳，表示请求发生的时间。
status：请求状态，通常用于指示请求是否成功，例如“success”或“error”。
二、响应体（Body）
总结果数（total）：表示与搜索关键词相关的商品总数。
商品列表（items）：包含了多个商品对象的数组，每个商品对象通常包含以下字段：
skuId：商品的唯一标识符。
skuName：商品的名称或标题。
skuImg：商品的图片 URL，通常是一个或多个图片链接。
price：商品的价格，可能包含原价、现价、折扣等信息。
promotion：商品的促销活动信息，如满减、直降等。
brand：商品的品牌信息。
category：商品所属的分类信息。
shop：销售该商品的店铺信息，可能包括店铺名称、链接等。
sales：商品的销售量或销量评分等信息。
comment：商品的评论数量或评分等信息。
other：其他与商品相关的字段，具体取决于 API 的版本和配置。
翻页信息（pagination）：如果商品总数较多，需要进行分页展示时，会包含翻页信息，如当前页码、每页显示数量、总页数等。
jd.item_search
公共参数
请求地址: https://o0b.cn/ibelle
请求参数
请求参数：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:
请求示例
复制
-- 请求示例 url 默认请求参数已经URL编码处理curl -i "https://api-gw.onebound.cn/jd/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter="复制代码
响应示例复制
{ "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": "item-not-found", "reason": "商品没找到", "error_code": "2000", "success": 0, "cache": 0, "api_info": "today:0 max:10000", "execution_time": 0.081, "server_time": "Beijing/2020-06-10 23:44:00", "call_args": [], "api_type": "taobao", "request_id": "15ee0ffc041242"}复制代码
相关资料
错误码解释
API 工具API SDK 调用示例 API SDK下载 API测试工具
如何获得此 API立即开通 有疑问联系客服 QQ：
（微信同号）
跨境电商平台接口提供商 数据采集公司 数据接口定制服务 企业级数据服务商备案号：赣 ICP 备 13008243 号-1
划线
评论
复制
发布于: 刚刚阅读数: 2
技术冰糖葫芦
关注
还未添加个人签名 2023-11-13 加入
还未添加个人简介
评论