京东按关键字搜索商品 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
技术冰糖葫芦
还未添加个人签名 2023-11-13 加入
还未添加个人简介
评论