京东 JD.com API

京东 JD.com 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

{
  "platform": "jd",
  "action": "search",
  "params": {
    "keyword": "华为手机"
  }
}

{
  "platform": "jd",
  "action": "product_detail",
  "params": {
    "item_id": "https://item.jd.com/100012043978.html"
  }
}

{
  "platform": "jd",
  "action": "reviews",
  "params": {
    "item_id": "100012043978"
  }
}

{
  "platform": "jd",
  "action": "shop",
  "params": {
    "shop_id": "1000004259"
  }
}

{
  "platform": "jd",
  "action": "product_price",
  "params": {
    "item_id": "100012043978"
  }
}

京东 JD.com 的独有字段名（当前目录）

全站 88 个平台的当前目录中，这 11 个字段名只在 京东 JD.com 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

• short_title
• is_jd_self
• promotion
• sell_point
• category_ids
• price_display
• price_masked
• unavailable_reason
• stock_state
• weight
• review_append

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

item_id

京东商品数字 ID；search 可把它直接交给详情、评价或价格能力。

url

该记录在原平台上的可访问链接。

title

标题。平台无标题概念时（如纯文本帖）为 null。

short_title

京东返回的商品短标题。

price

价格数值，不含货币符号；币种见 currency。

currency

价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。

review_count

评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。

good_rate

京东公开的好评率百分比。

shop_id

京东店铺数字 ID。

shop_name

公开店铺名称。

shop_url

京东店铺公开页面。

is_jd_self

是否为京东自营商品。

promotion

商品列表中的促销标签。

sell_point

商品列表中的公开卖点。

category_ids

京东类目 ID 路径。

image_url

图片链接。多图能力可能返回 image_urls 数组。

platform

数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

price_display

京东页面显示的价格原文；可能因登录或会员条件被遮罩。

price_masked

详情页价格是否被京东遮罩；为 true 时不要把 price_display 当精确成交价。

available

价格能力返回的当前可售状态。

unavailable_reason

不可售时京东页面给出的公开原因。

category

分类名称，取值为原平台的分类体系，未做跨平台归一。

stock_state

京东公开的库存状态码。

id

该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。

text

正文内容，已去除 HTML 标签。长文可能被截断。

review_append

买家追加评价。

rating

评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。

rating_scale

上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。

posted_at

发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。

当前目录另列出 sold_count · category_id · stock · color · size · weight · useful_count · images，这些字段尚无逐项释义；请先核对 京东 JD.com 对应接口的用例与实际响应，不按字段名猜测类型或含义。