京东获取推荐商品列表 API-摩杜云开发者社区

一、参数

公共参数

请求地址: https://api-gw.onebound.cn/jd/item_recommend

名称	类型	必须	描述
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版本

请求参数

请求参数：type=

参数说明：type:推荐类型

响应参数

名称	类型	是否隐私	示例值	描述
items	items[]			获取推荐商品列表
num_iid	Bigint		10021415166448	宝贝ID
detail_url	String		https://item.jd.com/10021415166448.html	商品详情页
title	String		俞兆林2件装半高领打底衫秋冬长袖洋气纯色内衣内搭上衣黑色薄款女士秋衣女春秋保暖内衣女针织衫黑色+浅卡其（80-130斤）	商品标题
pic_url	String		//img13.360buyimg.com/n7/jfs/t1/115150/13/17438/307259/5f58be2fE727cfb0d/aa76563060a56420.png	宝贝图片
price	Float		188	价格
promotion_price	Float		188	优惠价
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_recommend/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&type="

前往获取key和secret

响应示例

{
	"url": "https://search.jd.com/Search?keyword=手链&enc=utf-8&wq=手链&pvid=33dbb420d9fa4ca483a869f2e4c5625c",
	"keyword": "手链",
	"page": "",
	"real_total_results": "885843",
	"total_results": 6000,
	"pagecount": 100,
	"products_total": "",
	"list_count": "",
	"page_size": "60",
	"item": [
		{
			"num_iid": "68567099335",
			"detail_url": "https://item.jd.com/68567099335.html",
			"title": "【镶嵌施华洛世奇锆】四叶草手链女银项链生日礼物女生送老婆女友女朋友情侣白色情人节礼品S925纯银新婚 四叶草手链【镶嵌施华洛世奇锆】+独角...",
			"pic_url": "//img10.360buyimg.com/n7/jfs/t1/142952/34/20594/98681/5fe939f8E9bc3285d/0e4c1a84241a68ac.jpg",
			"price": 199,
			"promotion_price": 199,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "礼意久久专卖店"
		},
		{
			"num_iid": "40906757975",
			"detail_url": "https://item.jd.com/40906757975.html",
			"title": "唯一（Winy）999纯银手链女爱心时尚饰品手镯女士手环银饰首饰礼盒送女友闺蜜情侣生日礼物 精美礼盒包装",
			"pic_url": "//img10.360buyimg.com/n7/jfs/t1/158308/10/6062/98751/601d3bbdE27f3be75/060304b4d0ae147a.jpg",
			"price": 158,
			"promotion_price": 158,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "唯一珠宝官方旗舰店"
		},
		{
			"num_iid": "8325460",
			"detail_url": "https://item.jd.com/8325460.html",
			"title": "【品牌授权】施华洛世奇 镀玫瑰金色 闪耀经典 DIY REMIX手链女 女友礼物 5435651",
			"pic_url": "//img10.360buyimg.com/n7/jfs/t1/160276/39/7157/71723/602f1e7bEad7df7cb/e06c851c042a975a.jpg",
			"price": 649,
			"promotion_price": 649,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "施华洛世奇京东自营旗舰店"
		},
		{
			"num_iid": "100010211616",
			"detail_url": "https://item.jd.com/100010211616.html",
			"title": "礼意久久一鹿有你银手链镶施华洛世奇锆38女神三八节三八妇女节员工生日礼物女生送老婆送女友女朋友礼品结婚",
			"pic_url": "//img11.360buyimg.com/n7/jfs/t1/159188/34/4742/122577/600e2b31E98e55e6d/62eda310ac9b5582.jpg",
			"price": 258,
			"promotion_price": 258,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "礼意久久京东自营旗舰店"
		},
		{
			"num_iid": "2674499",
			"detail_url": "https://item.jd.com/2674499.html",
			"title": "卡蒂罗四叶草925银手链女款闺蜜手链学生饰品时尚生日礼物送女友",
			"pic_url": "//img14.360buyimg.com/n7/jfs/t1/165156/1/10942/235521/6045f00bE5e665130/40e38894f6a78eb4.jpg",
			"price": 108,
			"promotion_price": 108,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "卡蒂罗京东自营旗舰店"
		},
		{
			"num_iid": "4408563",
			"detail_url": "https://item.jd.com/4408563.html",
			"title": "affiner阿菲娜14K金手链女士38节礼物送女友送爱人 幸运四叶草淡水珍珠时尚手镯 首饰品礼物 AFB2013K",
			"pic_url": "//img13.360buyimg.com/n7/jfs/t1/165963/1/11512/99868/604715f9E4398a7f9/374fcefca2428fd3.jpg",
			"price": 1976,
			"promotion_price": 1976,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "AFFINER珠宝京东自营旗舰店"
		},
		{
			"num_iid": "100016735410",
			"detail_url": "https://item.jd.com/100016735410.html",
			"title": "1℃中国风一鹿有你银手链女生日礼物女生38三八节三八妇女节礼物女神送女友女朋友送老婆闺蜜结婚礼品饰盒",
			"pic_url": "//img10.360buyimg.com/n7/jfs/t1/164499/30/3008/186200/60056223E876e9d5a/72ac1111bf934c74.jpg",
			"price": 169,
			"promotion_price": 169,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "1℃京东自营旗舰店"
		},
		{
			"num_iid": "100006589764",
			"detail_url": "https://item.jd.com/100006589764.html",
			"title": "唯一（Winy）银手链女情侣手环999足银时尚饰品学生首饰送女友生日礼物配证书",
			"pic_url": "//img14.360buyimg.com/n7/jfs/t1/157755/22/10362/104299/604733e1Edf6d5da5/0f7554e01496d815.jpg",
			"price": 129,
			"promotion_price": 129,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "唯一京东自营旗舰店"
		},
		{
			"num_iid": "100006439773",
			"detail_url": "https://item.jd.com/100006439773.html",
			"title": "卡蒂罗&故宫上新联名款925银手链女本命年红绳学生女士饰品生日礼物送女友感温变色",
			"pic_url": "//img13.360buyimg.com/n7/jfs/t1/171018/26/11031/546761/6046d480E67757cb9/2e8b41c813d22733.jpg",
			"price": 248,
			"promotion_price": 248,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "卡蒂罗京东自营旗舰店"
		},
		{
			"num_iid": "100002160369",
			"detail_url": "https://item.jd.com/100002160369.html",
			"title": "周生生 足金侧身水波纹黄金手链女款 素圈金手环饰品09240B计价 17厘米3.4克",
			"pic_url": "//img14.360buyimg.com/n7/jfs/t1/167086/28/10928/177193/60471eb4Ebaf1dfa0/20ae6a1316561c3d.jpg",
			"price": 1704,
			"promotion_price": 1704,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "周生生京东自营旗舰店"
		},
		{
			"num_iid": "10027147584652",
			"detail_url": "https://item.jd.com/10027147584652.html",
			"title": "四叶草手链女925纯银ins手饰手镯节日礼物镶施华洛世奇锆网红手链送老婆闺蜜朋友首饰品生日礼物 镶施华洛世奇四叶草手链",
			"pic_url": "//img12.360buyimg.com/n7/jfs/t1/161978/19/9038/110748/603f368aE76e16938/64eb9dd6ae27ec6f.jpg",
			"price": 520,
			"promotion_price": 520,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "TANDU官方旗舰店"
		},
		{
			"num_iid": "5901307",
			"detail_url": "https://item.jd.com/5901307.html",
			"title": "周六福珠宝 女款时尚转运黄18K金手链KH072149 约1.1-1.29g 16+2cm",
			"pic_url": "//img12.360buyimg.com/n7/jfs/t1/164545/9/11226/165001/60475565Edc7734ac/3e01c45f669bb4cc.jpg",
			"price": 790,
			"promotion_price": 790,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "周六福珠宝京东自营旗舰店"
		},
		{
			"num_iid": "59864449621",
			"detail_url": "https://item.jd.com/59864449621.html",
			"title": "沉鱼落雁一路鹿有你s925纯银手链女士学生银手环女情侣手链银手镯时尚饰品闺蜜手链送女友生日礼物 福鹿手链-白钻",
			"pic_url": "//img11.360buyimg.com/n7/jfs/t1/105541/16/791/100031/5db39d55Ef68a16f2/3cf2d57c519d1d21.jpg",
			"price": 138,
			"promotion_price": 138,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "沉鱼落雁优戴专卖店"
		},
		{
			"num_iid": "100002673948",
			"detail_url": "https://item.jd.com/100002673948.html",
			"title": "GIVENCHY纪梵希 清新系列闪耀仿水晶玫瑰金色女士手链60404220-9DH",
			"pic_url": "//img13.360buyimg.com/n7/jfs/t1/9078/29/11619/47085/5c2dbce1E77901c71/29c63bbca4406036.jpg",
			"price": 699,
			"promotion_price": 699,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "纪梵希GIVENCHY京东自营专区"
		},
		{
			"num_iid": "10022283770265",
			"detail_url": "https://item.jd.com/10022283770265.html",
			"title": "【配送证书】沫兰 S925银四叶草手链女款文艺女士镶嵌玛瑙轻奢情侣手串百搭闺蜜送女友新年情人节礼物 玛瑙四叶草双层手链",
			"pic_url": "//img10.360buyimg.com/n7/jfs/t1/161215/19/8928/90497/603ef5ccEe0ab29c7/6cebfac6c04a7f77.jpg",
			"price": 268,
			"promotion_price": 268,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "沫兰京东自营旗舰店"
		},
		{
			"num_iid": "4498857",
			"detail_url": "https://item.jd.com/4498857.html",
			"title": "JOLEE手链S925银托帕石手镯日韩风格简约时尚彩色宝石爱心春季饰品送女生礼物",
			"pic_url": "//img12.360buyimg.com/n7/jfs/t1/165973/26/9669/81718/60418b5fE8a78ee70/e68390e9d293c9ba.jpg",
			"price": 328,
			"promotion_price": 328,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "JOLEE京东自营旗舰店"
		},
		{
			"num_iid": "100010656930",
			"detail_url": "https://item.jd.com/100010656930.html",
			"title": "【品牌授权】施华洛世奇 挚爱无尽 SWA INFINITY手链时尚饰品 女友礼物 5524421",
			"pic_url": "//img10.360buyimg.com/n7/jfs/t1/162963/22/11013/224286/60461727E8a7fbd45/a35627c5a09fb585.jpg",
			"price": 649,
			"promotion_price": 649,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "施华洛世奇京东自营旗舰店"
		},
		{
			"num_iid": "10020488917451",
			"detail_url": "https://item.jd.com/10020488917451.html",
			"title": "艾素（ANSN)双链四叶草手链女士轻奢银饰品手镯镀18k玫瑰彩金镶玛瑙送女友情人节礼物 四叶草手链【红+白】",
			"pic_url": "//img11.360buyimg.com/n7/jfs/t1/138432/11/13775/237335/60472d18E8d007353/3649581499768254.jpg",
			"price": 520,
			"promotion_price": 520,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "艾素官方旗舰店"
		},
		{
			"num_iid": "70945259481",
			"detail_url": "https://item.jd.com/70945259481.html",
			"title": "FZOG恋心与你手链女银镀白金时尚饰品镶嵌施华洛世奇锆石首饰白色情人节生日礼物送女友 【七仓配送/当次日达】恋心手链白锆款/不刻字",
			"pic_url": "//img11.360buyimg.com/n7/jfs/t1/121200/38/19938/186558/5fbe1503E2dbf710c/063bff6cb73afb2d.jpg",
			"price": 520,
			"promotion_price": 520,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "FZOG时尚饰品旗舰店"
		},
		{
			"num_iid": "10023906678101",
			"detail_url": "https://item.jd.com/10023906678101.html",
			"title": "I&U925银手链女士送老婆女朋友节日生日礼物时尚饰品首饰一鹿有你红绳手环女士感温变色玫瑰金手镯礼品 一鹿有你手链-玫瑰金",
			"pic_url": "//img11.360buyimg.com/n7/jfs/t1/168819/28/10992/123950/6046d128E1c0c9690/d1d504da69ae7bcb.jpg",
			"price": 169,
			"promotion_price": 169,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "I&U京东自营旗舰店"
		},
		{
			"num_iid": "10021383811184",
			"detail_url": "https://item.jd.com/10021383811184.html",
			"title": "妮爱999金手链女士首饰品黄硬金石榴石手镯手串女生情人节礼物送女友女朋友老婆媳妇妈妈母亲实用生日礼物 999金玫瑰手链+礼盒包装",
			"pic_url": "//img14.360buyimg.com/n7/jfs/t1/145958/29/17488/92897/5fd08212E930847e0/8df8c57141e3eba7.jpg",
			"price": 1314,
			"promotion_price": 1314,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "妮爱珠宝京东自营旗舰店"
		},
		{
			"num_iid": "43235821805",
			"detail_url": "https://item.jd.com/43235821805.html",
			"title": "慕洛菲四叶草手链女925银镶施华洛世奇锆镀白金时尚饰品手镯网红情侣老婆首饰品生日情人节礼物 镶施华洛世奇白金色手链(全国七仓直发，不可刻字...",
			"pic_url": "//img10.360buyimg.com/n7/jfs/t1/154769/7/19421/136811/6034e5c3Ea04cb4c0/bbdf2729a6fc490e.jpg",
			"price": 520,
			"promotion_price": 520,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "慕洛菲珠宝旗舰店"
		},
		{
			"num_iid": "6063560",
			"detail_url": "https://item.jd.com/6063560.html",
			"title": "【品牌授权】施华洛世奇 幸运四叶草手链女 时尚饰品 女友礼物 5253672",
			"pic_url": "//img10.360buyimg.com/n7/jfs/t1/166903/11/11059/218510/6046148cEfa434285/959cf93768d3df98.jpg",
			"price": 1290,
			"promotion_price": 1290,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "施华洛世奇京东自营旗舰店"
		},
		{
			"num_iid": "100010205899",
			"detail_url": "https://item.jd.com/100010205899.html",
			"title": "APM Monaco开口转运手镯女 多圈手链手饰 生日礼物银色送女友礼物女气质潮流时尚饰品",
			"pic_url": "//img14.360buyimg.com/n7/jfs/t1/165060/36/10881/208993/60464db9E0d234d11/39955a33ff9c6c4c.jpg",
			"price": 1980,
			"promotion_price": 1980,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "APM Monaco京东自营旗舰店"
		},
		{
			"num_iid": "100013437258",
			"detail_url": "https://item.jd.com/100013437258.html",
			"title": "AGATHA 瑷嘉莎 925银手链女小雏菊闺蜜情侣手链时尚饰品送女友生日礼物 242098C-709-TU",
			"pic_url": "//img13.360buyimg.com/n7/jfs/t1/150135/40/18651/68521/5fd864ecEa9240585/a78366a46a33b5be.jpg",
			"price": 420,
			"promotion_price": 420,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "AGATHA京东自营旗舰店"
		},
		{
			"num_iid": "65824569534",
			"detail_url": "https://item.jd.com/65824569534.html",
			"title": "YYEU 925银银杏叶手链简约甜美清新设计感女森系学生手环韩版 925银 银杏叶手链",
			"pic_url": "//img14.360buyimg.com/n7/jfs/t1/140060/7/14431/434563/5fae5815E84f43192/3476fbb1872b1b57.jpg",
			"price": 39,
			"promotion_price": 39,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "YYEU珠宝官方旗舰店"
		},
		{
			"num_iid": "72257513919",
			"detail_url": "https://item.jd.com/72257513919.html",
			"title": "isyou/是你 三生三世小红心手链女18k玫瑰彩金铂金闺蜜手饰手镯七夕生日情人节礼物 陪你三生18k金手链",
			"pic_url": "//img14.360buyimg.com/n7/jfs/t1/147159/38/4470/350300/5f290fbeE57f85f21/efb5c0e7b85d7a46.jpg",
			"price": 959,
			"promotion_price": 959,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "是你珠宝官方旗舰店"
		},
		{
			"num_iid": "100006439769",
			"detail_url": "https://item.jd.com/100006439769.html",
			"title": "卡蒂罗999银小蛮腰手链女玫瑰金手镯镶嵌施华洛世奇锆生日礼物送女友",
			"pic_url": "//img14.360buyimg.com/n7/jfs/t1/162577/6/10919/232245/6045f034Efdcae3df/ffcaff907ead4077.jpg",
			"price": 268,
			"promotion_price": 268,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "卡蒂罗京东自营旗舰店"
		},
		{
			"num_iid": "100008393784",
			"detail_url": "https://item.jd.com/100008393784.html",
			"title": "纪梵希 GIVENCHY 清秀系列仿水晶玫瑰金色按扣式女士手镯 60154499-9DH 玫瑰金色",
			"pic_url": "//img14.360buyimg.com/n7/jfs/t1/132692/33/15713/43884/5facb488E0b3534a7/bc6df94b133479c7.jpg",
			"price": 699,
			"promotion_price": 699,
			"sales": null,
			"sample_id": "",
			"post_fee": "",
			"area": "",
			"seller": "纪梵希GIVENCHY京东自营专区"
		}
	],
	"nav_catcamp": null,
	"nav_filter": null,
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:16 max:10000",
	"execution_time": 2.118,
	"server_time": "Beijing/2021-03-10 16:36:33",
	"client_ip": "106.6.35.144",
	"call_args": [],
	"api_type": "jd",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "3.18MB",
	"request_id": "gw-3.6048850fc119d"
}

异常示例

{
  "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	未知错误	否