写点什么

京东按关键字搜索商品 API(jd.item_search)返回值全面解析

  • 2024-05-08
    江西
  • 本文字数:7418 字

    阅读完需:约 24 分钟

当使用京东的按关键字搜索商品 API(jd.item_search)时,返回的结果通常是一个 JSON 格式的字符串,包含了与搜索关键词相关的商品信息。以下是对该 API 返回值的全面解析:

一、公共参数

  • requestId:请求的唯一标识符,用于追踪和调试请求。

  • timestamp:请求的时间戳,表示请求发生的时间。

  • status:请求状态,通常用于指示请求是否成功,例如“success”或“error”。

二、响应体(Body)

  1. 总结果数(total):表示与搜索关键词相关的商品总数。

  2. 商品列表(items):包含了多个商品对象的数组,每个商品对象通常包含以下字段:

    skuId:商品的唯一标识符。

    skuName:商品的名称或标题。

    skuImg:商品的图片 URL,通常是一个或多个图片链接。

    price:商品的价格,可能包含原价、现价、折扣等信息。

    promotion:商品的促销活动信息,如满减、直降等。

    brand:商品的品牌信息。

    category:商品所属的分类信息。

    shop:销售该商品的店铺信息,可能包括店铺名称、链接等。

    sales:商品的销售量或销量评分等信息。

    comment:商品的评论数量或评分等信息。

    other:其他与商品相关的字段,具体取决于 API 的版本和配置。

  3. 翻页信息(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:

3142401606

(微信同号)



公共参数请求参数响应参数请求示例响应示例异常示例相关资料

跨境电商平台接口提供商 数据采集公司 数据接口定制服务 企业级数据服务商备案号:赣 ICP 备 13008243 号-1

用户头像

还未添加个人签名 2023-11-13 加入

还未添加个人简介

评论

发布
暂无评论
京东按关键字搜索商品API(jd.item_search)返回值全面解析_API 编排_技术冰糖葫芦_InfoQ写作社区