Jd.com API for obtaining recommended product list

Common parameters

Request address : https://api-gw.onebound.cn/jd/item_recommend

Go to obtain key and secret

name	type	must	describe
key	String	yes	call key（ Must be GET Way of splicing in URL in ）
secret	String	yes	Call key
api_name	String	yes	API The name of the interface （ Included in the request address ）[item_search,item_get,item_search_shop etc. ]
cache	String	no	[yes,no] Default yes, The cached data... Will be called , It's quite fast
result_type	String	no	[json,jsonu,xml,serialize,var_export] Return data format , The default is json,jsonu The output content can be read directly in Chinese
lang	String	no	[cn,en,ru] Translation language , Default cn Simplified Chinese
version	String	no	API edition

Request parameters

Request parameters ：type=

Parameter description ：type: Recommended type

Response parameter

name	type	Privacy	Example value	describe
items	items[]			Get a list of recommended products
num_iid	Bigint		10021415166448	baby ID
detail_url	String		https://item.jd.com/10021415166448.html	Product details page
title	String		Yu Zhaolin 2 One piece half high collar bottomed shirt autumn winter long sleeve foreign style solid color underwear inner top black thin women's autumn clothes women's spring and autumn warm underwear women's sweater black + Shallow Khaki （80-130 Jin ）	Commodity title
pic_url	String		//img13.360buyimg.com/n7/jfs/t1/115150/13/17438/307259/5f58be2fE727cfb0d/aa76563060a56420.png	Baby pictures
price	Float		188	Price
promotion_price	Float		188	concessional rate
sales	Int			sales
sample_id	Bigint			Product style logo ID
post_fee	Float			Logistics expenses
area	String			The location of the shop
seller	String		Yu Zhaolin YZL Flagship store	Seller nickname

Request example

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

	
--  Request example  url  The default request parameters have been URL Encoding processing 
curl -i "https://api-gw.onebound.cn/jd/item_recommend/?key=< Your own apiKey>&secret=< Your own apiSecret>&type="

Response example

{
	"url": "https://search.jd.com/Search?keyword= Hand catenary &enc=utf-8&wq= Hand catenary &pvid=33dbb420d9fa4ca483a869f2e4c5625c",
	"keyword": " Hand catenary ",
	"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": "【 Inlaid with Swarovski zirconium 】 Four leaf clover Bracelet female silver necklace birthday gift girl gives wife girlfriend girlfriend couple White Valentine's Day gift S925 Silver wedding   Clover Bracelet 【 Inlaid with Swarovski zirconium 】+ Unicorn ...",
			"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": " Gift meaning for a long time store "
		},
		{
			"num_iid": "40906757975",
			"detail_url": "https://item.jd.com/40906757975.html",
			"title": " only （Winy）999 Sterling Silver Bracelet women's love fashion jewelry bracelet women's Bracelet Silver jewelry gift box for girlfriend, girlfriends and lovers birthday gifts   Exquisite gift box packaging ",
			"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": " The only official jewelry flagship store "
		},
		{
			"num_iid": "8325460",
			"detail_url": "https://item.jd.com/8325460.html",
			"title": "【 Brand authorization 】 SWAROVSKI   Rose gold plating   Shine classic  DIY REMIX Bracelet girl   Girlfriend gift  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": " Swarovski Jingdong self operated flagship store "
		},
		{
			"num_iid": "100010211616",
			"detail_url": "https://item.jd.com/100010211616.html",
			"title": " Your silver bracelet inlaid with Swarovski zirconium 38 Goddess March 8th, March 8th women's day, employee birthday gifts, girls give wives give girlfriends gifts, girlfriends get married ",
			"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": " Jingdong self operated flagship store "
		},
		{
			"num_iid": "2674499",
			"detail_url": "https://item.jd.com/2674499.html",
			"title": " Cartillo clover 925 Silver Bracelet female girlfriends Bracelet student jewelry fashion birthday gift for girlfriend ",
			"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": " Cartillo jd.com self operated flagship store "
		},
		{
			"num_iid": "4408563",
			"detail_url": "https://item.jd.com/4408563.html",
			"title": "affiner Afina 14K Ms. gold bracelet 38 Give gifts to your girlfriend and your lover on this holiday   Lucky clover freshwater pearl fashion bracelet   Jewelry gift  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 Jewelry Jingdong self operated flagship store "
		},
		{
			"num_iid": "100016735410",
			"detail_url": "https://item.jd.com/100016735410.html",
			"title": "1℃ Chinese style Yilu has your silver bracelet, female birthday gift, female 38 Women's Day gifts on March 8th. The goddess gives girlfriends to girlfriends to wives and girlfriends. Wedding gift box ",
			"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℃ Jingdong self owned flagship store "
		},
		{
			"num_iid": "100006589764",
			"detail_url": "https://item.jd.com/100006589764.html",
			"title": " only （Winy） Silver Bracelet female couple Bracelet 999 Football silver fashion jewelry student jewelry gives his girlfriend a birthday gift with a certificate ",
			"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": " The only JD self operated flagship store "
		},
		{
			"num_iid": "100006439773",
			"detail_url": "https://item.jd.com/100006439773.html",
			"title": " Catillo & New co branded items on the Forbidden City 925 Silver Bracelet female benmingnian red rope student women's jewelry birthday gift for girlfriend warm change ",
			"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": " Cartillo jd.com self operated flagship store "
		},
		{
			"num_iid": "100002160369",
			"detail_url": "https://item.jd.com/100002160369.html",
			"title": " Zhou Shengsheng   Full gold side water ripple gold bracelet for women   Plain gold bracelet Jewelry 09240B valuation  17 centimeter 3.4 g ",
			"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": " Zhoushengsheng Jingdong self operated flagship store "
		},
		{
			"num_iid": "10027147584652",
			"detail_url": "https://item.jd.com/10027147584652.html",
			"title": " Clover Bracelet woman 925 Sterling Silver ins Hand Bracelet holiday gift set with Swarovski zirconium net red bracelet for wife, best friend, first jewelry birthday gift   Swarovski clover Bracelet inlaid ",
			"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 Official flagship store "
		},
		{
			"num_iid": "5901307",
			"detail_url": "https://item.jd.com/5901307.html",
			"title": " Zhou Liufu jewelry   Women's fashion transit yellow 18K Gold Bracelet KH072149  about 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": " Zhouliufu jewelry Jingdong self operated flagship store "
		},
		{
			"num_iid": "59864449621",
			"detail_url": "https://item.jd.com/59864449621.html",
			"title": " Sinking fish and falling geese have you all the way s925 Sterling Silver Bracelet for women students silver bracelet for women lovers silver bracelet for fashion jewelry girlfriends bracelets for girlfriends birthday gifts   Fulu Bracelet - White drill ",
			"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": " Sunken fish and wild goose Youdai specialty store "
		},
		{
			"num_iid": "100002673948",
			"detail_url": "https://item.jd.com/100002673948.html",
			"title": "GIVENCHY Givenchy   Fresh series sparkle imitation crystal rose gold women's bracelet 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 GIVENCHY Jingdong self support zone "
		},
		{
			"num_iid": "10022283770265",
			"detail_url": "https://item.jd.com/10022283770265.html",
			"title": "【 Delivery certificate 】 Mo LAN  S925 Silver clover Bracelet women's literature and art lady inlaid agate light extravagant lovers hand string versatile girlfriends to give girlfriends new year Valentine's Day gifts   Agate clover double-layer Bracelet ",
			"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": " Molan Jingdong self operated flagship store "
		},
		{
			"num_iid": "4498857",
			"detail_url": "https://item.jd.com/4498857.html",
			"title": "JOLEE Hand catenary S925 Silver Topaz Bracelet Japanese and Korean style simple fashion colorful gem love spring jewelry give girls a gift ",
			"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 Jingdong self owned flagship store "
		},
		{
			"num_iid": "100010656930",
			"detail_url": "https://item.jd.com/100010656930.html",
			"title": "【 Brand authorization 】 SWAROVSKI   Love is endless  SWA INFINITY Bracelet fashion accessories   Girlfriend gift  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": " Swarovski Jingdong self operated flagship store "
		},
		{
			"num_iid": "10020488917451",
			"detail_url": "https://item.jd.com/10020488917451.html",
			"title": " docetaxel  （ANSN) Double chain clover Bracelet women's light luxury silver jewelry bracelet plated 18k Rose colored gold inlaid with agate to give his girlfriend a Valentine's Day gift   Clover Bracelet 【 red + white 】",
			"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": " Aisu official flagship store "
		},
		{
			"num_iid": "70945259481",
			"detail_url": "https://item.jd.com/70945259481.html",
			"title": "FZOG Love and you Bracelet female Silver Plated Platinum fashion jewelry inlaid with Swarovski zircon jewelry White Valentine's day birthday gift for girlfriend  【 Seven warehouse delivery / The next day 】 Love heart bracelet white zirconium / No lettering ",
			"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 Fashion jewelry flagship store "
		},
		{
			"num_iid": "10023906678101",
			"detail_url": "https://item.jd.com/10023906678101.html",
			"title": "I&U925 Ms. silver bracelet gives her wife and girlfriend holiday birthday gifts, fashion jewelry, a deer has your red rope bracelet, Ms. warm color changing rose gold bracelet gifts   A deer has your bracelet - rose gold ",
			"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 Jingdong self owned flagship store "
		},
		{
			"num_iid": "10021383811184",
			"detail_url": "https://item.jd.com/10021383811184.html",
			"title": " Ni AI 999 Gold bracelet women's headdress yellow hard Gold Garnet Bracelet hand string girls' Valentine's Day gift for girlfriend girlfriend wife daughter-in-law mother practical birthday gift  999 Gold Rose Bracelet + Gift box packaging ",
			"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": " Ni'ai jewelry Jingdong self operated flagship store "
		},
		{
			"num_iid": "43235821805",
			"detail_url": "https://item.jd.com/43235821805.html",
			"title": " Murofi clover Bracelet female 925 Silver inlaid Swarovski zirconium Plated Platinum fashion jewelry bracelet net red couple wife first jewelry birthday Valentine's Day gift   Swarovski White Gold Bracelet ( National qicang direct delivery , Do not engrave ...",
			"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": " Murofi jewelry flagship store "
		},
		{
			"num_iid": "6063560",
			"detail_url": "https://item.jd.com/6063560.html",
			"title": "【 Brand authorization 】 SWAROVSKI   Lucky clover Bracelet girl   Fashion accessories   Girlfriend gift  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": " Swarovski Jingdong self operated flagship store "
		},
		{
			"num_iid": "100010205899",
			"detail_url": "https://item.jd.com/100010205899.html",
			"title": "APM Monaco Opening transfer Bracelet female   Multi loop bracelet bracelet   Birthday gift silver gift for girlfriend, feminine temperament, fashion jewelry ",
			"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 Jingdong self owned flagship store "
		},
		{
			"num_iid": "100013437258",
			"detail_url": "https://item.jd.com/100013437258.html",
			"title": "AGATHA  Jiasha  925 Silver Bracelet female Daisy girl friend couple bracelet fashion jewelry for girlfriend birthday gift  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 Jingdong self owned flagship store "
		},
		{
			"num_iid": "65824569534",
			"detail_url": "https://item.jd.com/65824569534.html",
			"title": "YYEU 925 Silver ginkgo leaf bracelet is simple, sweet and fresh, with a sense of design. Female Mori student Bracelet Korean version  925 silver   Ginkgo leaf Bracelet ",
			"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 Jewelry official flagship store "
		},
		{
			"num_iid": "72257513919",
			"detail_url": "https://item.jd.com/72257513919.html",
			"title": "isyou/ It's you   Sansheng III little red heart bracelet girl 18k Rose colored gold platinum girlfriends Bracelet Tanabata birthday Valentine's Day gift   Stay with you for three days 18k Gold Bracelet ",
			"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": " It's your official flagship jewelry store "
		},
		{
			"num_iid": "100006439769",
			"detail_url": "https://item.jd.com/100006439769.html",
			"title": " Catillo 999 Silver small waist Bracelet female rose gold bracelet inlaid with Swarovski zirconium birthday gift for girlfriend ",
			"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": " Cartillo jd.com self operated flagship store "
		},
		{
			"num_iid": "100008393784",
			"detail_url": "https://item.jd.com/100008393784.html",
			"title": " Givenchy  GIVENCHY  Qingxiu series imitation crystal rose gold snap type women's bracelet  60154499-9DH  Rose Gold ",
			"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 GIVENCHY Jingdong self support zone "
		}
	],
	"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"
}

  Exception example

{
  "error": "item-not-found",
  "reason": " Product not found ",
  "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"}