京东商品数据 API

按关键词搜索京东商品、获取单个商品的详情与准确价格，适用于比价、找供应商、选品等场景。无需自己维护采集程序，一个 HTTP 请求即可拿到结构化 JSON 数据。

快速开始

1. 向管理员获取你的 API Key（形如 jdk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），并充值余额。

2. 发起一次搜索：

curl --max-time 120 -G 'https://api.askhong.com/v1/jd/search' \
  --data-urlencode 'keyword=螺丝' \
  --data-urlencode 'key=YOUR_API_KEY'

中文等非 ASCII 参数需要 URL 编码（如上用 --data-urlencode；Python requests / 浏览器 fetch 会自动编码）。

3. 从结果中取出商品编号 wareId，查询该商品的详情与准确价格：

curl --max-time 120 'https://api.askhong.com/v1/jd/item-detail?itemId=100188556171&key=YOUR_API_KEY'

你可以在 客户中心 用 API Key 登录，查看余额、每一次调用的扣费记录，以及在线充值。

鉴权

每个请求都需要携带 API Key，以下三种方式任选其一：

请妥善保管 API Key，不要放在网页前端代码中。如果泄露，请联系管理员重置，旧 Key 会立即失效。

计费规则

• 按次计费，从账户余额中扣除：商品搜索 ¥0.40/次，商品详情 ¥0.35/次。
• 只有 code = 0（成功返回数据）才扣费。参数错误、采集失败、超时、限流等所有失败情况都不扣费。
• 每次成功调用的响应中会带上本次扣费 charge 和剩余余额 balance（单位：元）。
• 余额不足一次调用的价格时，请求会被拒绝（错误码 40201），请先充值。

返回格式与错误码

所有接口返回统一结构，请通过返回体中的 code 字段判断结果，code = 0 表示成功：

{
  "code": 0,              // 0 = 成功，其他见下表
  "message": "success",
  "data": { ... },        // 业务数据，失败时为 null
  "requestId": "9f3c1a2b7e4d5c60",  // 请求编号，排查问题时提供给我们
  "charge": "0.40",       // 本次扣费（元），仅成功时返回
  "balance": "9.60"       // 扣费后余额（元），仅成功时返回
}

以上所有非 0 的情况均不扣费。

限流与超时

• 默认每个 API Key 每分钟最多 30 次请求，超出返回 42901。如需更高频率请联系管理员。
• 数据实时采集，单次请求通常 2~15 秒返回，偶尔更久。请把客户端超时设置为 120 秒（至少 60 秒）。
• 服务端已对「采集失败」做了自动重试；若仍返回 50201，请稍后再次请求。

商品搜索

按关键词搜索京东商品（含广告位商品），支持类目筛选、分页、排序、价格区间和品牌筛选。用于发现商品和店铺、初步比较价格。

也支持 POST，参数以 JSON 或表单形式放在请求体中。

请求参数

代码示例

curl --max-time 120 -G 'https://api.askhong.com/v1/jd/search' \
  -H 'X-API-Key: YOUR_API_KEY' \
  --data-urlencode 'keyword=螺丝' \
  --data-urlencode 'sort=3' \
  --data-urlencode 'priceInterval=0-100'

import requests

API_BASE = "https://api.askhong.com"
API_KEY = "YOUR_API_KEY"

resp = requests.get(
    f"{API_BASE}/v1/jd/search",
    params={"keyword": "螺丝", "sort": "3", "page": "1"},
    headers={"X-API-Key": API_KEY},
    timeout=120,
)
body = resp.json()
if body["code"] == 0:
    for item in body["data"]["wareInfo"]:
        print(item["wareId"], item["wname"], item["jdPrice"])
    print("本次扣费", body["charge"], "剩余余额", body["balance"])
elif body["code"] == 50201:
    print("采集失败，请重试（未扣费）")
else:
    print("失败:", body["code"], body["message"])

const API_BASE = "https://api.askhong.com";
const API_KEY = "YOUR_API_KEY";

const url = new URL(API_BASE + "/v1/jd/search");
url.searchParams.set("keyword", "螺丝");
url.searchParams.set("sort", "3");

const resp = await fetch(url, {
  headers: { "X-API-Key": API_KEY },
  signal: AbortSignal.timeout(120000),
});
const body = await resp.json();
if (body.code === 0) {
  for (const item of body.data.wareInfo) {
    console.log(item.wareId, item.wname, item.jdPrice);
  }
} else {
  console.error(body.code, body.message);
}

响应示例（节选）

{
  "code": 0,
  "message": "success",
  "data": {
    "wareCount": 811,
    "curPage": "1",
    "hasNextPage": true,
    "wareInfo": [
      {
        "wareId": "100188556171",
        "spuId": "100188556169",
        "wname": "固万基（GUWANJI）螺丝组合套装 主机电脑固态硬盘电子数码小螺丝钉 台式电脑螺丝套装15种[1盒]",
        "jdPrice": "¥11.5",
        "toCPrice": "11.50",
        "priceTag": "已补¥2.02",
        "good": "99%好评",
        "reviews": "2万+条评价",
        "shopId": "1000450829",
        "venderId": "1000450829",
        "self": true,
        "catid": "14132",
        "imageurl": "https://m.360buyimg.com/mobilecms/s534x534_jfs/t1/432956/....jpg"
      }
    ]
  },
  "requestId": "9f3c1a2b7e4d5c60",
  "charge": "0.40",
  "balance": "9.60"
}

主要字段说明

商品详情

按商品编号获取单个京东商品的准确价格、店铺、品牌、规格型号、参数和图片等。

请求参数

代码示例

curl --max-time 120 'https://api.askhong.com/v1/jd/item-detail?itemId=100188556171' \
  -H 'X-API-Key: YOUR_API_KEY'

import requests

resp = requests.get(
    "https://api.askhong.com/v1/jd/item-detail",
    params={"itemId": "100188556171"},
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=120,
)
body = resp.json()
if body["code"] == 0:
    d = body["data"]
    print("价格:", d["priceInfo"]["jdPrice"])
    print("店铺:", d["shop_infos"]["shopName"])
    print("品牌:", d["itemOnly"]["brandName"])
    print("型号:", d["itemInfo"]["product"]["model"])
else:
    print("失败:", body["code"], body["message"])

const resp = await fetch(
  "https://api.askhong.com/v1/jd/item-detail?itemId=100188556171",
  { headers: { "X-API-Key": "YOUR_API_KEY" }, signal: AbortSignal.timeout(120000) }
);
const body = await resp.json();
if (body.code === 0) {
  const d = body.data;
  console.log(d.priceInfo.jdPrice, d.shop_infos.shopName, d.itemInfo.product.skuName);
} else {
  console.error(body.code, body.message);
}

响应示例（节选）

{
  "code": 0,
  "message": "success",
  "data": {
    "priceInfo": {
      "skuId": 100188556171,
      "jdPrice": 13.52,
      "kaPrice": 11.42,
      "productPrice": { "jdPrice": 13.52, "marketPrice": 23.65, "kaPrice": 11.42 }
    },
    "shop_infos": {
      "shopId": 1000450829,
      "shopName": "固万基（GUWANJI）京东自营旗舰店",
      "venderId": 1000450829,
      "url": "https://shop.m.jd.com/shop/home?shopld=1000450829"
    },
    "itemOnly": {
      "skuId": "100188556171",
      "brandName": "固万基（GUWANJI）",
      "newColorSize": [
        { "skuId": "100188556181", "color": "螺丝套装B款18种[1盒]" },
        { "skuId": "100188556171", "color": "台式电脑螺丝套装15种[1盒]" }
      ]
    },
    "itemInfo": {
      "product": {
        "skuId": "100188556171",
        "skuName": "固万基（GUWANJI）螺丝组合套装 主机电脑固态硬盘电子数码小螺丝钉 台式电脑螺丝套装15种[1盒]",
        "brandName": "固万基（GUWANJI）",
        "model": "螺丝组合套装",
        "color": "台式电脑螺丝套装15种[1盒]",
        "category": "14065,14130,14132",
        "shopId": "1000450829"
      }
    },
    "products_introduction": [
      { "groupName": "主体参数", "atts": [ { "attName": "类型", "vals": ["螺丝套装"] }, { "attName": "规格", "vals": ["15种"] } ] }
    ],
    "img_list": ["http://img13.360buyimg.com/n12/jfs/t1/310140/....jpg"],
    "description": "<style>...商品详情 HTML..."
  },
  "requestId": "4be0a7d2c9f13e85",
  "charge": "0.35",
  "balance": "9.25"
}

主要字段说明

查询余额

查询当前 API Key 的剩余余额，免费。

curl 'https://api.askhong.com/v1/account/balance' -H 'X-API-Key: YOUR_API_KEY'

{ "code": 0, "message": "success", "data": { "name": "你的账户名", "balance": "9.25" }, "requestId": "..." }

如有问题，请联系管理员并提供请求返回的 requestId。