onebound.jd.item_search
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | 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": "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"}
错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
---|---|---|---|
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |