API文档中心

热门接口：产品ID找同款全量维权查询万能转链字符串ID转换 （有API需求可联系本站）

京东联盟商品图文详情查询接口

调用权限：核心接口会员卡调用
 接口测试 
接口使用场景等说明：

本接口用于商品详情查询，大字段信息，包括：商品图文详情介绍（主要），以及分类等信息。

2024年12月10日后，参数入参为数字商品ID时，必须有场景ID2的权限。


API支持批量查询商品详情。

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/jd/bigfield 暂无

请求方式：GET 或 POST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String 是 V123M56 公共参数，接口秘钥，请在会员中心获取
skuIds Number 是 29357345299，100008656851 skuId集合，最多支持批量入参10个sku。该接口目前只支持数字ID入参，但需要您具备场景ID2的权限，参考这里
fields String 否 categoryInfo 查询域集合，不填写则查询全部，目目前支持：categoryInfo（类目信息）,imageInfo（图片信息）,baseBigFieldInfo（基础大字段信息）,bookBigFieldInfo（图书大字段信息）,videoBigFieldInfo（影音大字段信息）,detailImages（商详图）
itemIds String[] 否 [Q9Z2ZdyMsa9g7jpsfgQNVA0R_3SD7M7ISbsR0zCKPoF] 联盟商品ID集合(一次最多支持查询20个itemId)，为字符串数组类型，开发时记得加[]；仅sceneId=1时支持入参
sceneId Number 否 1 场景ID，支持入参1,2；2需要权限申请。参考这里

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=112165
使用curl函数，curl不是php原生库，需要安装才能使用

$api="http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=112165";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流，不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool，以hutool为例：

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=112165";
        // JDK 8u111版本后，若目标页面为HTTPS协议，请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时，毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests，支持访问http,https网页：

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=112165"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值（JSON）

参数名称 参数类型 是否必选 示例值 描述
skuId Number 是 100008656851 skuId
skuName String 是 手机 商品名称
categoryInfo Map 是 无 类目信息
 └─ cid1 Number 是 6144 一级类目ID
 └─ cid1Name String 是 珠宝首饰 一级类目名称
 └─ cid2 Number 是 12041 二级类目ID
 └─ cid2Name String 是 木手串/把件 二级类目名称
 └─ cid3 Number 是 12052 三级类目ID
 └─ cid3Name String 是 其他 三级类目名称
imageInfo Map 是 无 图片信息
 └─ url String 是 http://img14.360buyimg.com/ads/jfs/t22495/56/628456568/380476/9befc935/5b39fb01N7d1af390.jpg 主图链接
baseBigFieldInfo Map 是   基础大字段信息
 └─ wdis String 是 无 商品介绍
 └─ propCode String 是 无 规格参数【废弃】
 └─ wareQD String 是 无 包装清单(仅自营商品)
 └─ propGroups String 否 JSON串 规格参数
 └─ bookBigFieldInfo Bookbigfieldinfo 是 无 图书大字段信息
 └─ comments String 是 无 媒体评论
 └─ image String 是 无 精彩文摘与插图(插图)
 └─ contentDesc String 是 无 内容摘要(内容简介)
 └─ relatedProducts String 是 无 产品描述(相关商品)
 └─ editerDesc String 是 无 编辑推荐
 └─ catalogue String 是 无 目录
 └─ bookAbstract String 是 无 精彩摘要(精彩书摘)
 └─ authorDesc String 是 无 作者简介
 └─ introduction String 是 无 前言(前言/序言)
 └─ productFeatures String 是 无 产品特色
videoBigFieldInfo Map 是 无 影音大字段信息
 └─ comments String 是 无 评论
 └─ image String 是 无 商品描述(精彩剧照)
 └─ contentDesc String 是 无 内容摘要(内容简介)
 └─ editerDesc String 是 无 编辑推荐
 └─ catalogue String 是 无 目录
 └─ box_Contents String 是 无 包装清单
 └─ material_Description String 是 无 特殊说明
 └─ manual String 是 无 说明书
 └─ productFeatures String 是 无 产品特色
 └─ mainSkuId Number 否 6161111 自营主skuId
productId Number 否 1236547 非自营商品Id
skuStatus Number 否 1 sku上下架状态 1：上架(可搜索，可购买)， 0：下架(可通过skuid搜索，不可购买)， 2：可上架（可通过skuid搜索，不可购买）， 10：pop 删除（不可搜索，不可购买））
owner String 否 g g=自营，p=pop
detailImages String 否 http://img30.360buyimg.com/vc/jfs/t1/144028/20/5850/1105845/5f3cceb8Ec52ab631/da3cb259e0d83f42.jpg 商详图
itemId String 否 Q9Z2ZdyMsa9g7jpsfgQNVA0R_3SD7M7ISbsR0zCKPoF 联盟商品ID

返回示例

【提示】推广链接通常有时效性，示例中的链接为创建文档时生成，仅用于展示返回结果使用，有可能已失效。
{ "error": "0", "msg": "查询成功！", "data": [ { "baseBigFieldInfo": { "propCode": "", "propGroups": "[{\"atts\":[{\"attDictUrl\":\"\",\"attId\":3626,\"attName\":\"型号\",\"attVals\":[{\"attValName\":\"EB20-4\"}],\"categoryGroupAttId\":\"152328\",\"inputType\":3,\"sort\":2,\"vals\":[\"EB20-4\"]},{\"attDictUrl\":\"\",\"attId\":13402,\"attName\":\"适配牙刷\",\"attVals\":[{\"attValName\":\"D12;D100;D200;D16;D16+;P2000;P4000;P4500;P9000;DB4510\"}],\"categoryGroupAttId\":\"152537\",\"inputType\":3,\"sort\":3,\"vals\":[\"D12;D100;D200;D16;D16+;P2000;P4000;P4500;P9000;DB4510\"]}],\"groupId\":2,\"groupName\":\"主体参数\",\"sort\":1},{\"atts\":[{\"attDictUrl\":\"\",\"attId\":2606,\"attName\":\"产品尺寸（mm）\",\"attVals\":[{\"attValName\":\"221*60*17\"}],\"categoryGroupAttId\":\"152329\",\"inputType\":3,\"sort\":1,\"vals\":[\"221*60*17\"]},{\"attDictUrl\":\"\",\"attId\":13717,\"attName\":\"产品净重\",\"attVals\":[{\"attValName\":\"40g\"}],\"categoryGroupAttId\":\"160969\",\"inputType\":3,\"sort\":2,\"vals\":[\"40g\"]}],\"groupId\":173,\"groupName\":\"规格参数\",\"sort\":2},{\"atts\":[{\"attDictUrl\":\"\",\"attId\":3883,\"attName\":\"上市时间\",\"attType\":\"0\",\"attVals\":[{\"attValName\":\"2015-07\"}],\"categoryGroupAttId\":\"190872\",\"inputType\":3,\"sort\":0,\"vals\":[\"2015-07\"]}],\"groupId\":894,\"groupName\":\"上市时间\",\"sort\":0}]", "wareQD": "欧乐B电动牙刷头 4支装 精准清洁型", "wdis": [ "//img30.360buyimg.com/sku/jfs/t1/210559/37/8915/387744/618b7a4aE897354fb/af0282e9209358b6.jpg", "//img30.360buyimg.com/sku/jfs/t1/4210/7/20506/41825/62fb66feE8af2feb9/1e33eca26eb2a156.jpg", "//img30.360buyimg.com/sku/jfs/t1/80292/39/22151/25750/62fb66feE5f6d7496/0d6cb949366e6aee.jpg", "//img30.360buyimg.com/sku/jfs/t1/135258/33/27327/100232/63368886E115f6c80/577529d07ea57a0d.jpg", "//img30.360buyimg.com/sku/jfs/t1/77039/39/22346/137874/63368886E9cbb4127/0f2d0aa23928c187.jpg", "//img30.360buyimg.com/sku/jfs/t1/76370/40/21979/137863/63368886Ed119f39b/d7e093347bfef73d.jpg", "//img30.360buyimg.com/sku/jfs/t1/167108/22/30712/116064/63368886E702cc633/fd24602c246bd9ce.jpg", "//img30.360buyimg.com/sku/jfs/t1/79426/26/16415/96638/63368886Ef825c0aa/f803dbe3af898888.jpg", "//img30.360buyimg.com/sku/jfs/t1/107726/39/20322/96787/63368886E124f2075/97a487fe8b71e62b.jpg", "//img30.360buyimg.com/sku/jfs/t1/45321/17/20902/207309/63368886E3fd73e31/dfe858ca605f79a5.jpg", "//img30.360buyimg.com/sku/jfs/t1/181169/28/28696/111681/63368886E5909dff2/04b994c2c0a668a6.jpg", "//img30.360buyimg.com/sku/jfs/t1/135737/1/29600/100291/63368886E81cdf8fb/8dc4cb452c0b6bee.jpg", "//img30.360buyimg.com/sku/jfs/t1/222655/30/21762/105020/63368886E9c6a2cef/d122b9ef4d3f863a.jpg", "//img30.360buyimg.com/sku/jfs/t1/203109/18/27667/61410/63368886E06c86217/012a7a292090d93d.jpg", "//img30.360buyimg.com/sku/jfs/t1/136590/37/29424/66752/63368886Ec756a5c4/9db158921f22d749.jpg", "//img30.360buyimg.com/sku/jfs/t1/11309/13/18587/75880/63368886E99768780/2ebf0c32640b1f96.jpg" ] }, "categoryInfo": { "cid1": 737, "cid1Name": "家用电器", "cid2": 1276, "cid2Name": "个护健康", "cid3": 17404, "cid3Name": "电动牙刷头" }, "detailImages": "http://img30.360buyimg.com/sku/jfs/t1/210559/37/8915/387744/618b7a4aE897354fb/af0282e9209358b6.jpg,http://img30.360buyimg.com/sku/jfs/t1/4210/7/20506/41825/62fb66feE8af2feb9/1e33eca26eb2a156.jpg,http://img30.360buyimg.com/sku/jfs/t1/80292/39/22151/25750/62fb66feE5f6d7496/0d6cb949366e6aee.jpg,http://img30.360buyimg.com/sku/jfs/t1/135258/33/27327/100232/63368886E115f6c80/577529d07ea57a0d.jpg,http://img30.360buyimg.com/sku/jfs/t1/77039/39/22346/137874/63368886E9cbb4127/0f2d0aa23928c187.jpg,http://img30.360buyimg.com/sku/jfs/t1/76370/40/21979/137863/63368886Ed119f39b/d7e093347bfef73d.jpg,http://img30.360buyimg.com/sku/jfs/t1/167108/22/30712/116064/63368886E702cc633/fd24602c246bd9ce.jpg,http://img30.360buyimg.com/sku/jfs/t1/79426/26/16415/96638/63368886Ef825c0aa/f803dbe3af898888.jpg,http://img30.360buyimg.com/sku/jfs/t1/107726/39/20322/96787/63368886E124f2075/97a487fe8b71e62b.jpg,http://img30.360buyimg.com/sku/jfs/t1/45321/17/20902/207309/63368886E3fd73e31/dfe858ca605f79a5.jpg,http://img30.360buyimg.com/sku/jfs/t1/181169/28/28696/111681/63368886E5909dff2/04b994c2c0a668a6.jpg,http://img30.360buyimg.com/sku/jfs/t1/135737/1/29600/100291/63368886E81cdf8fb/8dc4cb452c0b6bee.jpg,http://img30.360buyimg.com/sku/jfs/t1/222655/30/21762/105020/63368886E9c6a2cef/d122b9ef4d3f863a.jpg,http://img30.360buyimg.com/sku/jfs/t1/203109/18/27667/61410/63368886E06c86217/012a7a292090d93d.jpg,http://img30.360buyimg.com/sku/jfs/t1/136590/37/29424/66752/63368886Ec756a5c4/9db158921f22d749.jpg,http://img30.360buyimg.com/sku/jfs/t1/11309/13/18587/75880/63368886E99768780/2ebf0c32640b1f96.jpg", "imageInfo": { "imageList": [ { "url": "https://img14.360buyimg.com/pop/jfs/t1/214588/18/24688/76704/63b7eb7bF546d56b2/da9ea0e3c2d79cd2.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/95973/7/32215/102672/63368849E7fb6f6fe/5216da6806494b36.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/154509/10/26076/170566/618a4f41Eb7e04645/875395cbbf02844d.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/128761/8/26900/156661/63368849Ec973202c/68768ab14f44896e.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/84946/10/20672/436650/61de58d1Ea0301424/b26b78eeb6beaa04.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/98369/12/32215/109523/63368849E94807907/c00a895646ee5bad.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/214955/23/21771/77143/6336884aE22f8360b/b5e5290e2e4496c1.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/199387/31/29180/111052/63368849E90e4b7b8/fd448b08623ae345.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/88970/11/31799/74952/637f7e2aE16fe7a62/2019532c95739bf9.jpg" } ] }, "mainSkuId": 112165, "owner": "g", "productId": 112165, "skuId": 112165, "skuName": "欧乐B电动牙刷头 成人精准清洁型4支装 EB20-4 适配成人D/P/Pro系列小圆头牙刷", "skuStatus": 1 } ], "request_id": "Np6r3xE" }

错误码

如果error不为0时，请点此查看错误码表格

在线
客服

点此【QQ在线咨询】QQ号：3252444923

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部