万邦京东按关键字搜索商品 API 返回值说明

item_search-按关键字搜索商品  API测试工具

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:搜索关键字，支持url
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_review,_new]
(bid:总价,sale:销量,review评论数,new新品,加_前缀为从大到小排序)<
page:

响应参数

名称	类型	是否隐私	示例值	描述
items	items[]			按关键字搜索商品
num_iid	Bigint			宝贝ID
detail_url	String			商品详情页
title	String			商品标题
pic_url	String			宝贝图片
price	Float			价格
promotion_price	Float			优惠价
sales	Int			销量
sample_id	Bigint			商品风格标识ID
post_fee	Float			物流费用
area	String			店铺所在地
seller	String		俞兆林YZL旗舰店	卖家昵称

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

	
-- 请求示例 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": {
		"url": "https://search.jd.com/Search?keyword=女士包包&enc=utf-8&wq=女士包包&pvid=33dbb420d9fa4ca483a869f2e4c5625c",
		"keyword": "女士包包",
		"page": "",
		"real_total_results": 4400,
		"total_results": 4400,
		"pagecount": 74,
		"products_total": "",
		"list_count": "",
		"page_size": "60",
		"item": [
			{
				"num_iid": "100017453787",
				"detail_url": "https://item.jd.com/100017453787.html",
				"title": "蔻一CNOLES官网包包女包牛皮女士斜挎包通勤款百搭单肩包轻奢手提包袋式大容量奢侈品生日礼物送女友老婆",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/108989/22/33717/65742/638033f4Ec22b5d1e/7a71f4af3bc55bd2.jpg",
				"price": 269,
				"promotion_price": 269,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "Cnoles蔻一女包京东自营旗舰店"
			},
			{
				"num_iid": "10048028879576",
				"detail_url": "https://item.jd.com/10048028879576.html",
				"title": "CAKNLS＆KALRY CK奢侈品包包女包牛皮单肩包女士斜挎包平安夜圣诞节生日礼物送老婆女友原创 CK-518米白色 纪念日送女友老婆生日礼物礼盒装",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/126600/29/32973/68005/6371b32dE18717068/e09bac4b9e7a2259.jpg",
				"price": 1314,
				"promotion_price": 1314,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "Caknls Kalry官方旗舰店"
			},
			{
				"num_iid": "100015118922",
				"detail_url": "https://item.jd.com/100015118922.html",
				"title": "viney牛皮包包女包时尚单肩包女休闲大容量水桶包百搭手提包简约斜挎包奢侈品老婆生日礼物送女朋友女生闺蜜",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/133640/40/28936/157441/6380545eE919b0f5c/02d9db55b4ccffe8.jpg",
				"price": 269,
				"promotion_price": 269,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "viney箱包京东自营旗舰店"
			},
			{
				"num_iid": "100006682949",
				"detail_url": "https://item.jd.com/100006682949.html",
				"title": "TUCANO啄木鸟包包女包时尚潮流单肩包链条女包鹿头百搭小方包一鹿有你送女友老婆生日礼物",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/205799/40/28685/171056/638423dbEf5dfdf20/bcedb2fbf9b63521.jpg",
				"price": 219,
				"promotion_price": 219,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "啄木鸟箱包京东自营旗舰店"
			},
			{
				"num_iid": "10032216705742",
				"detail_url": "https://item.jd.com/10032216705742.html",
				"title": "【原创设计】范西帕品牌女包新款升级包包潮简约小方包单肩手提包时尚百搭斜挎女生日礼物 绿拼白【精美礼盒】【七仓直发/当日次日达】",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/175313/28/31656/75005/637196b7Ea174e823/46bc8fd6511ff8af.jpg",
				"price": 520,
				"promotion_price": 520,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "范西帕（FANXIPA）官方旗舰店"
			},
			{
				"num_iid": "10048639613432",
				"detail_url": "https://item.jd.com/10048639613432.html",
				"title": "歌诗嫚包包女包新款中年女士大气百搭时尚皮牛皮手提包妈妈款方包7127 灰蓝（配蓝色丝巾）",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/84011/9/22293/63282/630f14a1E4a9b5f89/ac1decc8cbeb775e.jpg",
				"price": 455,
				"promotion_price": 455,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "歌诗嫚官方旗舰店"
			},
			{
				"num_iid": "10047286840551",
				"detail_url": "https://item.jd.com/10047286840551.html",
				"title": "纪诗哲轻奢品牌奢侈品包包女包单肩包女新款托特包大容量百搭通勤女士斜挎水桶包送女友老婆生日情人节礼物 米色 礼盒装",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/189711/31/32442/126609/6370e00eE5cb82904/3c2ece7293f4072f.jpg",
				"price": 1314,
				"promotion_price": 1314,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "纪诗哲旗舰店"
			},
			{
				"num_iid": "100033771900",
				"detail_url": "https://item.jd.com/100033771900.html",
				"title": "皮尔卡丹(pierre cardin)时尚包包女包百搭单肩斜挎包女简约牛皮手提包女士礼盒装 J2A244-110202P米白色",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/181367/16/31123/172981/637f4ddcEd912c55e/b285fc4ab58f1b1c.jpg",
				"price": 699,
				"promotion_price": 699,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "皮尔卡丹箱包京东自营旗舰店"
			},
			{
				"num_iid": "10048007597283",
				"detail_url": "https://item.jd.com/10048007597283.html",
				"title": "GIRL ROSEN 奢侈品包包女包2022新款斜挎包腋下包3条肩带女士包包生日礼物礼盒包装单肩包女 咖啡色 精美礼盒装",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/113445/4/27688/169006/62ce4b08E9ca8b5ed/81868075e3700212.jpg",
				"price": 1688,
				"promotion_price": 1688,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "GIRL ROSEN壹丁点专卖店"
			},
			{
				"num_iid": "10039119109196",
				"detail_url": "https://item.jd.com/10039119109196.html",
				"title": "CinvaiKrose官网官方 牛皮包包女包轻奢女士斜挎包大容量小＆ck风单肩包女奢侈品链条包小方包 米白配蓝【送生日礼物礼品袋】",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/105067/15/21512/54636/63823d6dE1bd6448d/5afaadefb5b48146.jpg",
				"price": 239,
				"promotion_price": 239,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "CinvaiKrose女包旗舰店"
			},
			{
				"num_iid": "100020031668",
				"detail_url": "https://item.jd.com/100020031668.html",
				"title": "蔻一Cnoles官网包包女包牛皮单肩包女士大容量轻奢手提包袋OL风百搭斜挎包生日礼物送女朋友老婆奢侈品 米白",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/189294/13/27655/50038/63805d32E7a284f8a/47ca4446823811bb.jpg",
				"price": 369,
				"promotion_price": 369,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "Cnoles蔻一女包京东自营旗舰店"
			},
			{
				"num_iid": "10060950966882",
				"detail_url": "https://item.jd.com/10060950966882.html",
				"title": "古伦尼（Gurun Vani）品牌奢侈品包包女包新款单肩斜挎包女士包包时尚小方包送女友送老婆生日礼物 咖啡色 【精美礼盒包装】【代写贺卡】",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/65978/24/23836/89314/63817f83E2b48fdf9/8bd51991b10cc7f2.jpg",
				"price": 1688,
				"promotion_price": 1688,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "古伦尼箱包旗舰店"
			},
			{
				"num_iid": "10061640277352",
				"detail_url": "https://item.jd.com/10061640277352.html",
				"title": "CADUNI＆KAISER CK奢侈品包包女包新款单肩包女大容量托特包时尚斜挎包送老婆生日礼物送女友 咖啡色",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/36964/40/20588/190292/63712b7fE4e95d273/a654b49ab4ea9fe0.jpg",
				"price": 1299,
				"promotion_price": 1299,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "CADUNI KAISER女包旗舰店"
			},
			{
				"num_iid": "10038076413413",
				"detail_url": "https://item.jd.com/10038076413413.html",
				"title": "酷奇女包轻奢品牌包包女包单肩包女气质女士包包奢侈品女包新款斜挎包时尚百搭ins网红宽肩带小方包单肩包 酷奇咖色 【两条肩带】",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/46406/36/22690/102797/634e3d43E75ddfba9/7e84485cc513a1d7.png",
				"price": 659,
				"promotion_price": 659,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "酷奇袋鼠芳惠专卖店"
			},
			{
				"num_iid": "100021522269",
				"detail_url": "https://item.jd.com/100021522269.html",
				"title": "viney牛皮单肩包女时尚包包女包大容量托特手提水桶包ck风品牌斜挎包奢侈品老婆生日礼物送女朋友女生米色",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/111791/17/32471/108312/638054b7E6ece42b7/84e6c5cbd330b82e.jpg",
				"price": 319,
				"promotion_price": 319,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "viney箱包京东自营旗舰店"
			},
			{
				"num_iid": "10048527180623",
				"detail_url": "https://item.jd.com/10048527180623.html",
				"title": "CAKNLS＆KALRY CK奢侈品包包女包单肩包女士斜挎小方包情人节平安夜圣诞节送老婆女友生日礼物 CK-05蓝色",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/30801/21/19396/124104/63759526E7ed4fde9/802751c49ee78b3e.jpg",
				"price": 1059,
				"promotion_price": 1059,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "Caknls Kalry官方旗舰店"
			},
			{
				"num_iid": "10043859585180",
				"detail_url": "https://item.jd.com/10043859585180.html",
				"title": "酷奇女包轻奢品牌女士包包托特包女手提包大女包2022新款潮时尚百搭大容量斜挎单肩包 字母印花咖啡色",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/5163/15/20251/198759/638398ebE37408d2c/04e1ea9bf2e3bb42.jpg",
				"price": 899,
				"promotion_price": 899,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "酷奇袋鼠印芝专卖店"
			},
			{
				"num_iid": "10046762284467",
				"detail_url": "https://item.jd.com/10046762284467.html",
				"title": "【专柜款】Cohnimkevin轻奢品牌女士包包女包奢侈品ck风格单肩斜挎手提生日礼物送女友老婆母亲 【专柜款】【顺丰发货】c02054米白色",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/187300/1/31178/44034/63786df1Ee75fd174/6e3062cee4818d59.jpg",
				"price": 1588,
				"promotion_price": 1588,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "科罗蒙凯文箱包旗舰店"
			},
			{
				"num_iid": "10035812852550",
				"detail_url": "https://item.jd.com/10035812852550.html",
				"title": "COOGI奢侈品包包女包单肩包女士斜挎包链条小方包生日平安夜圣诞节七夕情人节礼物送女友老婆 宝蓝色",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/182441/6/20275/104280/61205d2eE5503f926/b3210afc906739a0.jpg",
				"price": 989,
				"promotion_price": 989,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "COOGI旗舰店"
			},
			{
				"num_iid": "100034385468",
				"detail_url": "https://item.jd.com/100034385468.html",
				"title": "高尔夫GOLF包包女包牛皮手提包女时尚单肩斜挎包休闲大容量女士手提包袋生日礼物1C353067柔雾白礼盒套装",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/106832/5/35056/101727/63803c4dE41002338/01a498d50262082d.jpg",
				"price": 399,
				"promotion_price": 399,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "GOLF高尔夫女包京东自营旗舰店"
			},
			{
				"num_iid": "100010019737",
				"detail_url": "https://item.jd.com/100010019737.html",
				"title": "viney牛皮包包女包时尚百搭单肩包女休闲大容量水桶包ck风斜挎手提包腋下包奢侈品老婆生日礼物送女朋友女生",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/155825/14/33053/90358/638058b6Edefe9ea0/afb9ca451db725b9.jpg",
				"price": 298,
				"promotion_price": 298,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "viney箱包京东自营旗舰店"
			},
			{
				"num_iid": "100035968501",
				"detail_url": "https://item.jd.com/100035968501.html",
				"title": "YUYULA牛皮单肩包女时尚百搭包包女包休闲通勤手提包轻奢品牌斜挎包奢侈品送老婆生日礼物送女朋友妈妈 蓝色",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/181443/40/31191/136349/63805314E50fe308e/f64d256bfcf56671.jpg",
				"price": 279,
				"promotion_price": 279,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "YUYULA京东自营旗舰店"
			},
			{
				"num_iid": "100017030956",
				"detail_url": "https://item.jd.com/100017030956.html",
				"title": "viney牛皮包包女包时尚单肩包女休闲大容量托特包斜挎百搭手提包腋下包奢侈品送老婆生日礼物送女朋友女生",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/190482/24/28076/87387/6380541eE02fd2272/f0af6aad90e09a69.jpg",
				"price": 319,
				"promotion_price": 319,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "viney箱包京东自营旗舰店"
			},
			{
				"num_iid": "10046134604525",
				"detail_url": "https://item.jd.com/10046134604525.html",
				"title": "【顺丰速运】Cohnimkevin轻奢品牌女士包包女包奢侈品ck风格单肩斜挎手提生日礼物送女友老婆 【时尚轻奢】c02049米白色",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/115421/36/21731/171112/623a7a0cEab7d1513/f37ec84719a007b7.jpg",
				"price": 1369,
				"promotion_price": 1369,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "科罗蒙凯文箱包旗舰店"
			},
			{
				"num_iid": "100024814679",
				"detail_url": "https://item.jd.com/100024814679.html",
				"title": "YUYULA牛皮包包女包时尚百搭单肩包女通勤ck风斜挎包轻奢品牌手提包奢侈品送老婆生日礼物送女朋友闺蜜 棕色",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/194839/39/31026/115033/6381ac6fE8e95e104/bd13a1d63e323724.jpg",
				"price": 269,
				"promotion_price": 269,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "YUYULA京东自营旗舰店"
			},
			{
				"num_iid": "50273039575",
				"detail_url": "https://item.jd.com/50273039575.html",
				"title": "【2022限量版】啄木鸟包包女包2022新时尚小方包学生斜挎单肩女包鹿头链条女士包送女友老婆生日礼物 米白银色【寓意一鹿有你】",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/34874/31/20892/65377/638429b8E449bfe1f/5066b889f5960d66.png",
				"price": 239,
				"promotion_price": 239,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "啄木鸟旗舰店"
			},
			{
				"num_iid": "100017030968",
				"detail_url": "https://item.jd.com/100017030968.html",
				"title": "爱情海包包女包时尚百搭斜挎包女印花单肩包女大容量ck风小方包奢侈品送老婆生日礼物送女朋友女生闺蜜咖啡色",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/219394/14/24066/212020/637f238dE3cd65f5a/1e029f60499496db.jpg",
				"price": 239,
				"promotion_price": 239,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "爱情海京东自营旗舰店"
			},
			{
				"num_iid": "71684810087",
				"detail_url": "https://item.jd.com/71684810087.html",
				"title": "【商场同款】稻草人手提包女士包包新款潮时尚斜挎包大容量猫咪女包可爱单肩包包女 78721米白",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/108917/36/33749/74372/634e1e69E6f10c7c6/660b82826c43b6c1.jpg",
				"price": 339,
				"promotion_price": 339,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "稻草人优客专卖店"
			},
			{
				"num_iid": "100013501464",
				"detail_url": "https://item.jd.com/100013501464.html",
				"title": "蔻驰COACH【官方直供】奢侈品女士小号PVC配皮单肩斜挎链条包棕色配黑色91019IMCBI",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/11609/24/16926/57916/637ed50aE617783c5/e914abdb65372d1f.jpg",
				"price": 1799,
				"promotion_price": 1799,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "COACH京东自营店"
			}
		],
		"nav_catcamp": null,
		"nav_filter": null,
		"from": "pc"
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "0988d11e3fc736232addd52bd3b4a47c",
	"secache_time": 1669613812,
	"secache_date": "2022-11-28 13:36:52",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:52 max:10100 all[102=52+16+34];expires:2030-12-31",
	"execution_time": "3.25",
	"server_time": "Beijing/2022-11-28 13:36:52",
	"client_ip": "106.6.35.87",
	"call_args": {
		"q": "女士包包",
		"start_price": "0",
		"end_price": "0",
		"page": "1",
		"cat": "0"
	},
	"api_type": "jd",
	"translate_language": "zh-CN",
	"translate_engine": "baidu_api",
	"server_memory": "3.66MB",
	"request_id": "gw-3.638448f108f13",
	"last_id": "1381868351"
}