API文档中心

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

京东联盟商品图文详情查询接口:商品介绍和属性API

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

本接口用于商品详情查询,大字段信息,包括:商品图文详情介绍(主要),以及分类等信息。

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


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

接口请求地址

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

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
skuIds Number 29357345299,100008656851 skuId集合,最多支持批量入参10个sku。该接口目前只支持数字ID入参,但需要您具备场景ID2的权限,参考这里,如果没有该权限,需要购买本站的京东数字ID转英文ID的专用卡。
fields String categoryInfo 查询域集合,不填写则查询全部,目目前支持:categoryInfo(类目信息),imageInfo(图片信息),baseBigFieldInfo(基础大字段信息),bookBigFieldInfo(图书大字段信息),videoBigFieldInfo(影音大字段信息),detailImages(商详图)
itemIds String Q9Z2ZdyMsa9g7jpsfgQNVA0R_3SD7M7ISbsR0zCKPoF 联盟商品ID集合(一次最多支持查询20个itemId),为字符串数组类型,多个字符串ID时,用英文逗号相连;仅sceneId=1时支持入参。
sceneId Number 1 场景ID,支持入参1,2;默认值1。场景ID 2需要在具备一定订单量后再申请权限。当您查询的是skuIds数字商品ID时,需要传入本参数sceneId=2.参考这里

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=phrnmeeihZECLlC4da2Hx8Ys_3erEj60sqh1NwyQOTq 
【例子】查询数字商品ID查询,需传场景ID2
http://api.veapi.cn/jd/bigfield?vekey=xxx&skuIds=100056192043&sceneId=2
【例子】使用字符串ID查询多个商品
http://api.veapi.cn/jd/bigfield?vekey=xxx&itemIds=phrnmeeihZECLlC4da2Hx8Ys_3erEj60sqh1NwyQOTq,phrnmeeihZECOGU12a2QJpU5_3erEj60sqh1NwWd4hq
使用curl函数,curl不是php原生库,需要安装才能使用

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

$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=phrnmeeihZECLlC4da2Hx8Ys_3erEj60sqh1NwyQOTq";
        // 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=phrnmeeihZECLlC4da2Hx8Ys_3erEj60sqh1NwyQOTq"

# 发送请求
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时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部