前言
京东商品详情API接口的作用是获取京东平台上某个商品的详细信息,包括商品标题、价格、图片、规格、参数、店铺信息等。开发者可以通过该接口获取到商品的原始数据,方便进行数据分析、价格比较、爬取等操作。
通过该接口获取到的商品详情数据可以结合其他数据进行深度挖掘,例如可以将商品数据对比分析,找出同类商品中的价格优势点和竞争对手,也可以基于商品和用户的交互数据,对用户进行画像分析和个性化推荐等。
总的来说,该接口可以帮助开发者深度挖掘京东平台上的商品数据,从而更好地为客户提供个性化服务和优质商品推荐。
jd.item_get-获得JD商品详情(注册免费获取调用测试请私信)
公共参数
名称 |
类型 |
必须 |
描述 |
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版本 |
请求参数
请求参数:num_iid=10335871600
参数说明:num_iid:JD商品ID
响应参数
名称 |
类型 |
是否隐私 |
示例值 |
描述 |
items |
items[] |
获得JD商品详情 |
||
num_iid |
Bigint |
29186819959 |
商品ID |
|
title |
String |
MOCO2018夏季新品时尚V领条纹连衣裙 摩安珂 蓝白条色 S |
商品标题 |
|
desc_short |
String |
商品简介 |
||
price |
Float |
719.0 |
价格 |
|
total_price |
Float |
0 |
||
suggestive_price |
Float |
0 |
||
orginal_price |
Float |
1199.00 |
原价 |
|
nick |
String |
MO&Co.官方旗舰店 |
掌柜昵称 |
|
num |
Int |
999 |
||
min_num |
Int |
0 |
||
detail_url |
String |
http://item.jd.com/29186819959.html |
商品链接 |
|
pic_url |
String |
//img14.360buyimg.com/n0/jfs/t22033/147/1051007175/85125/c44dd0df/5b1f2855Ncbe35858.jpg |
商品图片 |
|
brand |
String |
品牌名称 |
||
brandId |
Int |
品牌ID |
||
rootCatId |
Int |
1343 |
顶级分类ID |
|
cid |
Int |
9719 |
||
crumbs |
Mix |
[] |
||
created_time |
String |
|||
modified_time |
String |
|||
delist_time |
String |
|||
desc |
String |
|||
desc_img |
Mix |
[] |
||
item_imgs |
Mix |
[{ "url": "//img14.360buyimg.com/n0/jfs/t22033/147/1051007175/85125/c44dd0df/5b1f2855Ncbe35858.jpg"}] |
商品图片 |
|
item_weight |
String |
|||
item_size |
String |
|||
location |
String |
发货地 |
||
post_fee |
Float |
6.00 |
物流费用 |
|
express_fee |
Float |
6.00 |
快递费用 |
|
ems_fee |
Float |
6.00 |
EMS费用 |
|
shipping_to |
String |
发货至 |
||
has_discount |
Boolean |
false |
||
video |
Mix |
[] |
商品视频 |
|
is_virtual |
String |
|||
sample_id |
String |
商品风格标识ID |
||
is_promotion |
Boolean |
|||
props_name |
String |
0:0:尺码:S;0:1:尺码:XS;0:2:尺码:M;0:3:尺码:L;0:4:尺码:XL |
商品属性名 |
|
prop_imgs |
Mix |
{"prop_img": []} |
商品属性图片列表 |
|
property_alias |
String |
0:0:S;0:1:XS;0:2:M;0:3:L;0:4:XL |
商品属性别名 |
|
props |
Mix |
[{ "name": "尺码","value": "S XS M L XL" }] |
商品详情 |
|
total_sold |
Int |
|||
skus |
Mix |
{"sku": [{"price": "719.00", "orginal_price": "1199.00", "properties": "0:0", "properties_name": "0:0:尺码:S", "quantity": 99, "sku_id": 29186819959, "sku_url": "http://item.jd.com/29186819959.html"}] |
商品规格信息 |
|
seller_id |
Int |
卖家ID |
||
sales |
Int |
销量 |
||
shop_id |
Int |
店铺ID |
||
props_list |
Mix |
{"0:0": "尺码:S"} |
商品属性 |
|
seller_info |
Mix |
{"level": null, "shop_type": null, "user_num_id": 57467, "cid": null, "delivery_score": null, "item_score": null, "score_p": null, "zhuy": "//moco.jd.com", "search_id": "", "nick": "MO&Co.官方旗舰店", "shop_name": "MO&Co.官方旗舰店", "title": "MO&Co.官方旗舰店" } |
卖家信息 |
|
tmall |
Boolean |
false |
是否天猫 |
|
error |
String |
错误信息 |
||
warning |
String |
警告信息 |
||
url_log |
Mix |
[] |
||
props_img |
Mix |
[] |
属性图片 |
|
shop_item |
Mix |
[] |
||
relate_items |
Mix |
[] |
Java请求示例
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;
public class Example {
private static String readAll(Reader rd) throws IOException {
StringBuilder sb = new StringBuilder();
int cp;
while ((cp = rd.read()) != -1) {
sb.append((char) cp);
}
return sb.toString();
}
public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter out = new PrintWriter(conn.getOutputStream());
out.print(body);
out.flush();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static void main(String[] args) throws IOException, JSONException {
// 请求示例 url 默认请求参数已经URL编码处理
String url = "https://jd/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=10335871600";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}