京东 JD.com

京东 JD.com API

按关键词搜索京东商品,使用返回的数字 item_id 继续读取详情、公开评价或当前价格,或一次取齐这件商品全部 SKU 的规格、京东价与库存,也可按数字 shop_id 查看店铺商品;首发固定单页和有限条数,不把遮罩价格或不可售状态当成真实成交价。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

平台可用度

24h 健康值
正常
正常

30 天趋势

京东 JD.com 能力清单

能力做什么单价24 小时可用度
关键词搜索search用 search 按商品词取得候选,每条结果中由数字字符组成的 item_id 字符串可继续交给详情、评价或单品价格接口。$1.39 / 千次正常
商品详情product_detail把 search 返回的数字字符串 item_id 交给 product_detail,核对商品、店铺、价格显示和库存状态。$1.39 / 千次正常
评价reviews用 reviews 读取最多 10 条公开评价,区分首次评价、追加评价、评分、规格和有用数。$1.39 / 千次暂不可用
店铺资料shop用 shop 读取指定店铺当前取得的一页商品,只把 item_id、title 与 url 作为首发可承诺的商品身份字段。$1.39 / 千次暂不可用
商品价格product_price用 product_price 查询一个商品的当前公开价格与可售状态,不重复拉取详情对象。$1.39 / 千次暂不可用
全部 SKU 与价格skus把任一 SKU 的 item_id 或商品页链接交给 skus,按 SKU 逐行拿到规格、京东价、在售与库存,用于上货或比价。$1.39 / 千次每返回一条算一次正常
商品介绍详情图description_images把任一 SKU 的 item_id 或商品页链接交给 description_images,按页面从上到下逐张拿到详情长图的原图链接,用于上货、比价或竞品分析。$1.39 / 千次正常

点能力名进它的文档:参数、返回字段、代码示例和试用。

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

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

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

能力必填参数可选参数单次条数模式单价返回字段
searchkeyword—默认 5 · 最多 5同步$1.39 / 千次item_id · url · title · short_title · price · currency · sold_count · review_count · good_rate · shop_id · shop_name · shop_url · is_jd_self · promotion · sell_point · category_ids · image_url · platform
product_detailitem_id——同步$1.39 / 千次item_id · url · title · price · price_display · price_masked · currency · available · unavailable_reason · shop_id · shop_name · shop_url · category_id · category · stock · stock_state · color · size · weight · image_url · image_urls · is_jd_self · brand · model · original_price · upc · warranty · product_area · is_jd_express · variant_count · variants · platform
reviewsitem_id—默认 10 · 最多 10同步$1.39 / 千次id · item_id · text · review_append · rating · rating_scale · posted_at · color · size · useful_count · images · author_name · author_avatar_url · author_is_plus · buy_count · platform
shopshop_id—默认 24 · 最多 24同步$1.39 / 千次item_id · url · title · price · currency · shop_id · shop_name · shop_url · image_url · available · platform
product_priceitem_id——同步$1.39 / 千次item_id · url · price · currency · available · unavailable_reason · platform
skusitem_id—默认 100 · 最多 100同步$1.39 / 千次每返回一条算一次item_id · url · product_id · is_requested · title · properties · color · size · price · currency · on_sale · in_stock · stock_state · stock · purchase_limit · delivery_promise · is_presale · is_government_subsidy · is_billion_subsidy · is_flash_sale · promo_tags · upc · brand · image_url · shop_id · shop_name · is_jd_self · variant_count · platform
description_imagesitem_id——同步$1.39 / 千次item_id · position · image_url · image_count · platform

怎么调用 京东 JD.com 商品详情 API?

product_detail

使用 platform="jd"、action="product_detail" 调用“商品详情”能力;返回单个对象,主要包含 item_id、url、title、price、price_display、price_masked 等 32 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态 →

只接受纯数字 item_id 或不带 query/fragment 的旧式 item.jd.com 数字商品页,不接受任意京东 URL。

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

京东 JD.com product_detail 的参数分别是什么意思?

item_id必填
京东商品数字 ID,或不带 query/fragment 的 https://item.jd.com/<数字>.html;不接受 /product/<opaque>.html 等新式不透明链接。

京东官方帮助区分商品页面实时标价、单品到手价,以及会员、新人、地区、定向券等个人权益,并提示部分价格信息可能受数据、时效和技术条件影响。该来源只解释 item_id 所指商品的价格语境;EveryInfra 的 price 是抓取时可见快照,不等于个人成交价、结算页金额、历史最低价或绝对准确报价。官方来源:京东价格标签说明:页面标价、到手价与个性化权益来源核查:

京东 JD.com 返回字段与含义(26)
item_id
京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
shop_id
京东店铺数字 ID。
shop_name
公开店铺名称。
shop_url
京东店铺公开页面。
is_jd_self
是否为京东自营商品。
image_url
图片链接:search、product_detail、shop、skus 里是商品主图(封面);description_images 里是这一行的那张详情图(京东图床的 https 原图)。
price_display
京东页面显示的价格原文;可能因登录或会员条件被遮罩。
price_masked
详情页价格是否被京东遮罩;为 true 时不要把 price_display 当精确成交价。
available
采集时是否可售(product_detail、product_price、shop 的商品行);缺货时为 false,null 表示页面没给。
unavailable_reason
不可售时京东页面给出的公开原因。
category_id
商品所在的京东末级类目 ID(product_detail)。
weight
京东页面上的商品重量原文(product_detail);null 表示页面没写。
stock_state
京东公开的库存状态码。
brand
商品品牌。
model
商品型号。
original_price
京东展示的原价;null 表示页面未提供,可能与促销后的 price 不同。
upc
商品条码(UPC/EAN);null 表示页面未提供。
warranty
保修说明原文。
product_area
产地。
is_jd_express
是否由京东物流配送。
variant_count
变体(SKU)数量;null 表示无变体或未提供。skus 的每一行都带同一个值:它大于本次返回的行数时,说明被 limit 截断或有 SKU 这次没取到。
variants
变体列表,每项含名称、SKU、价格、库存状态等;null 表示无变体或未提供。
color
京东页面上这个 SKU 的颜色(或外观)属性值。
size
京东页面上这个 SKU 的尺码、容量或规格属性值。
stock
京东页面公开的库存数量;null 表示页面没给,不是 0。
image_urls
商品图集链接列表(含主图,按京东页面上的顺序);单数 image_url 是其中第一张。京东「商品介绍」区的详情长图不在这里,用 description_images 另取。

怎么调用 京东 JD.com 评价 API?

reviews

使用 platform="jd"、action="reviews" 调用“评价”能力;返回列表,默认 10 条、单次最多 10 条,主要包含 id、item_id、text、review_append、rating、rating_scale 等 16 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态 →

使用 search 返回的 item_id,首发固定一页,最多 10 条公开评价。

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

京东 JD.com reviews 的参数分别是什么意思?

item_id必填
京东商品数字 ID,或不带 query/fragment 的 https://item.jd.com/<数字>.html;返回最多 10 条公开评价。

京东官方规则区分首次评价、追加评价、晒单与回复,并说明审核、折叠、隐藏和昵称星号脱敏。该来源用于解释 item_id 所指商品下的公开评价对象及可见性变化;一页最多 10 条的 EveryInfra 首发契约仍不代表完整历史,也不保证每条评价、图片或作者字段始终可见。官方来源:京东评价晒单规则:评价、追评、审核与昵称脱敏来源核查:

京东 2026-01-20 生效的现行用户服务协议说明,评价信息会公开,京东可按协议使用评价内容;个人信息原则上未经许可不向第三方公开,用户也不得窃取个人信息或侵害他人合法权利。该来源只支持访问与许可边界,不向 EveryInfra 或调用方授予对 item_id 下文字、图片或用户信息的再分发、训练或商业使用权。官方来源:京东用户服务协议(2026-01-20 生效):公开评价与访问许可边界来源核查:

京东 JD.com 返回字段与含义(8)
item_id
京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
color
京东页面上这个 SKU 的颜色(或外观)属性值。
size
京东页面上这个 SKU 的尺码、容量或规格属性值。
review_append
买家追加评价。
author_name
评价人昵称,按京东页面原样返回(京东可能已部分打码)。
author_avatar_url
评价人头像链接。
author_is_plus
评价人是否为京东 PLUS 会员。
buy_count
评价人购买该商品的次数(页面显示的「购买 N 次」。

怎么调用 京东 JD.com 店铺资料 API?

shop

使用 platform="jd"、action="shop" 调用“店铺资料”能力;返回列表,默认 24 条、单次最多 24 条,主要包含 item_id、url、title、price、currency、shop_id 等 11 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态 →

shop_id 是由数字字符组成的店铺 ID 字符串,不是商品 ID 或店铺名称;首发最多 24 条。

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

京东 JD.com shop 的参数分别是什么意思?

shop_id必填
京东店铺数字 ID,或不带 query/fragment 的 https://mall.jd.com/index-<数字>.html;不是商品 ID。

京东官方 JSSDK 将 shopId 定义为店铺详情跳转目标,并与 skuId 的商品目标分开。EveryInfra 首发 shop_id 只接受纯数字或 mall.jd.com/index-<数字>.html;该来源不证明店铺商品目录完整、任意店铺可读或当前请求已获授权。官方来源:京东 JSSDK:shopId 指向店铺详情目标来源核查:

京东 JD.com 返回字段与含义(6)
item_id
京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
shop_id
京东店铺数字 ID。
shop_name
公开店铺名称。
shop_url
京东店铺公开页面。
image_url
图片链接:search、product_detail、shop、skus 里是商品主图(封面);description_images 里是这一行的那张详情图(京东图床的 https 原图)。
available
采集时是否可售(product_detail、product_price、shop 的商品行);缺货时为 false,null 表示页面没给。

怎么调用 京东 JD.com 商品价格 API?

product_price

使用 platform="jd"、action="product_price" 调用“商品价格”能力;返回单个对象,主要包含 item_id、url、price、currency、available、unavailable_reason 等 7 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态 →

查询单个商品的当前公开价格与可售状态,不把它写成个人结算价。

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

京东 JD.com product_price 的参数分别是什么意思?

item_id必填
京东商品数字 ID,或不带 query/fragment 的 https://item.jd.com/<数字>.html;只返回该商品的价格与可售状态。

京东官方帮助区分商品页面实时标价、单品到手价,以及会员、新人、地区、定向券等个人权益,并提示部分价格信息可能受数据、时效和技术条件影响。该来源只解释 item_id 所指商品的价格语境;EveryInfra 的 price 是抓取时可见快照,不等于个人成交价、结算页金额、历史最低价或绝对准确报价。官方来源:京东价格标签说明:页面标价、到手价与个性化权益来源核查:

京东 JD.com 返回字段与含义(3)
item_id
京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
available
采集时是否可售(product_detail、product_price、shop 的商品行);缺货时为 false,null 表示页面没给。
unavailable_reason
不可售时京东页面给出的公开原因。

怎么调用 京东 JD.com 全部 SKU 与价格 API?

skus

使用 platform="jd"、action="skus" 调用“全部 SKU 与价格”能力;返回列表,默认 100 条、单次最多 100 条,主要包含 item_id、url、product_id、is_requested、title、properties 等 29 个字段。

每个 SKU 一行,第一行是请求里的那个(is_requested 为 true),其后是京东为它列出的其他颜色、尺码或容量;每行各有 properties(规格)、price、on_sale、in_stock、stock_state、stock。price 是京东对未登录买家展示的价格,不含结算时才使用的优惠券,不是券后到手价。每返回一个 SKU 算一次调用:按 limit(1–100,默认 100)先扣,没返回的当场退回;只能同步调用。

查看完整接口文档:参数、代码示例、响应样例与健康状态 →

传任一 SKU 的数字 ID 或商品页链接,返回这件商品的全部 SKU;每返回一个 SKU 算一次调用,price 不含券、不是到手价。

{
  "platform": "jd",
  "action": "skus",
  "params": {
    "item_id": "https://item.m.jd.com/product/10232789210191.html"
  }
}

京东 JD.com skus 的参数分别是什么意思?

item_id必填
京东商品(任一 SKU)的数字 ID,或京东商品页链接(https://item.jd.com/<数字>.html、https://item.m.jd.com/product/<数字>.html、微信里打开的 wqitem.jd.com 商品页),也可以是只含一个这类链接的分享文本;链接里的跟踪参数不影响。3.cn、u.jd.com 等短链不收,请先在浏览器打开再复制商品页链接。

京东官方帮助区分商品页面实时标价、单品到手价,以及会员、新人、地区、定向券等个人权益,并提示部分价格信息可能受数据、时效和技术条件影响。该来源只解释 item_id 所指商品的价格语境;EveryInfra 的 price 是抓取时可见快照,不等于个人成交价、结算页金额、历史最低价或绝对准确报价。官方来源:京东价格标签说明:页面标价、到手价与个性化权益来源核查:

京东 JD.com 返回字段与含义(24)
item_id
京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
shop_id
京东店铺数字 ID。
shop_name
公开店铺名称。
is_jd_self
是否为京东自营商品。
image_url
图片链接:search、product_detail、shop、skus 里是商品主图(封面);description_images 里是这一行的那张详情图(京东图床的 https 原图)。
stock_state
京东公开的库存状态码。
brand
商品品牌。
upc
商品条码(UPC/EAN);null 表示页面未提供。
variant_count
变体(SKU)数量;null 表示无变体或未提供。skus 的每一行都带同一个值:它大于本次返回的行数时,说明被 limit 截断或有 SKU 这次没取到。
color
京东页面上这个 SKU 的颜色(或外观)属性值。
size
京东页面上这个 SKU 的尺码、容量或规格属性值。
stock
京东页面公开的库存数量;null 表示页面没给,不是 0。
product_id
京东商品组 ID:同一商品的所有 SKU 共用(skus)。它不是 SKU,不能当 item_id 去调详情、评价或价格。
is_requested
这一行是不是请求里传的那个 SKU(skus);同一商品的其他 SKU 为 false。
properties
这个 SKU 的销售属性,属性名 → 属性值,按京东页面原文(如 外观: 亚麻灰、存储容量: 12GB+512GB)(skus)。
on_sale
这个 SKU 是否在售(上架)(skus)。在售不等于有货,有货看 in_stock 与 stock_state。
in_stock
这个 SKU 现在能否直接下单(有现货)(skus)。预售、预约中的 SKU 为 false,详见 stock_state。
purchase_limit
每位买家限购件数;null 表示页面没写限购(skus)。
delivery_promise
京东页面上的配送或发货承诺原文,如「预计11月9日前发货」(skus);按京东未登录时的默认收货地区给出,换地区可能不同。
is_presale
是否为预售商品(skus)。
is_government_subsidy
京东是否给这个 SKU 标了国家补贴(国补)(skus);这个标记本身不说明 price 是否已扣除补贴。null 表示这次没拿到这个标记。
is_billion_subsidy
京东是否给这个 SKU 标了百亿补贴(skus);null 表示这次没拿到这个标记。
is_flash_sale
这个 SKU 是否在秒杀中(skus);null 表示这次没拿到这个标记。
promo_tags
京东给这个 SKU 标的促销标签原文列表(skus);null 表示没有或这次没拿到。

怎么调用 京东 JD.com 商品介绍详情图 API?

description_images

使用 platform="jd"、action="description_images" 调用“商品介绍详情图”能力;返回列表,主要包含 item_id、position、image_url、image_count、platform。

每张图一行,按「商品介绍」从上到下排:position 从 1 开始,image_url 是京东图床的 https 原图,image_count 是这次一共返回几张。主图与图集在 product_detail 的 image_urls,product_detail 不含详情图;商品没有详情图时按空结果退款。

查看完整接口文档:参数、代码示例、响应样例与健康状态 →

传任一 SKU 的数字 ID 或商品页链接,按页面顺序逐张返回「商品介绍」区的详情图原图;没有详情图按空结果退款。

{
  "platform": "jd",
  "action": "description_images",
  "params": {
    "item_id": "100248562389"
  }
}

京东 JD.com description_images 的参数分别是什么意思?

item_id必填
要取详情图的京东商品:任一 SKU 的数字 ID,或京东商品页链接(https://item.jd.com/<数字>.html、https://item.m.jd.com/product/<数字>.html、微信里打开的 wqitem.jd.com 商品页),也可以是只含一个这类链接的分享文本;链接里的跟踪参数不影响。3.cn、u.jd.com 等短链不收,请先在浏览器打开再复制商品页链接。
京东 JD.com 返回字段与含义(4)
item_id
京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
image_url
图片链接:search、product_detail、shop、skus 里是商品主图(封面);description_images 里是这一行的那张详情图(京东图床的 https 原图)。
position
这张图在「商品介绍」里的序号,从 1 开始、按页面从上到下(description_images)。
image_count
这个商品「商品介绍」区这次一共返回几张图,每行相同(description_images);大于本次拿到的行数说明被 limit 截断了。
京东 JD.com search 调用流程一次 京东 JD.com search 调用的全过程:向 POST /api/v1/social 发送 platform="jd"、action="search",以及必填参数 keyword;返回结构化 JSON,含 item_id、url、title、short_title、price 等字段;返回列表,单次最多 5 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "jd"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表item_idurltitleshort_titleprice
一次 京东 JD.com search 调用的全过程:向 POST /api/v1/social 发送 platform="jd"、action="search",以及必填参数 keyword;返回结构化 JSON,含 item_id、url、title、short_title、price 等字段;返回列表,单次最多 5 条,计费 $1.39 / 千次,失败与空结果不计费。

京东 JD.com 原始字段名

EveryInfra 统一字段名

左边是 京东 JD.com 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。90 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

京东 JD.com 的独有字段名(当前目录)

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

  • short_title
  • good_rate
  • is_jd_self
  • promotion
  • sell_point
  • price_display
  • price_masked
  • unavailable_reason
  • stock_state
  • model
  • warranty
  • product_area
  • is_jd_express
  • author_is_plus
  • is_requested
  • properties
  • purchase_limit
  • delivery_promise

返回字段含义

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

item_id
京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时(如纯文本帖)为 null。
short_title
京东返回的商品短标题。
price
价格数值,不含货币符号;币种见 currency。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
sold_count
搜索列表上显示的销量原文(search),是「10万+」这类文本、不是精确件数。
review_count
搜索列表上显示的评价数原文(search),是文本、可能是约数,不是精确条数。
good_rate
京东公开的好评率百分比。
shop_id
京东店铺数字 ID。
shop_name
公开店铺名称。
shop_url
京东店铺公开页面。
is_jd_self
是否为京东自营商品。
promotion
商品列表中的促销标签。
sell_point
商品列表中的公开卖点。
category_ids
京东类目 ID 路径。
image_url
图片链接:search、product_detail、shop、skus 里是商品主图(封面);description_images 里是这一行的那张详情图(京东图床的 https 原图)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
price_display
京东页面显示的价格原文;可能因登录或会员条件被遮罩。
price_masked
详情页价格是否被京东遮罩;为 true 时不要把 price_display 当精确成交价。
available
采集时是否可售(product_detail、product_price、shop 的商品行);缺货时为 false,null 表示页面没给。
unavailable_reason
不可售时京东页面给出的公开原因。
category_id
商品所在的京东末级类目 ID(product_detail)。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
stock
京东页面公开的库存数量;null 表示页面没给,不是 0。
stock_state
京东公开的库存状态码。
color
京东页面上这个 SKU 的颜色(或外观)属性值。
size
京东页面上这个 SKU 的尺码、容量或规格属性值。
weight
京东页面上的商品重量原文(product_detail);null 表示页面没写。
image_urls
商品图集链接列表(含主图,按京东页面上的顺序);单数 image_url 是其中第一张。京东「商品介绍」区的详情长图不在这里,用 description_images 另取。
brand
商品品牌。
model
商品型号。
original_price
京东展示的原价;null 表示页面未提供,可能与促销后的 price 不同。
upc
商品条码(UPC/EAN);null 表示页面未提供。
warranty
保修说明原文。
product_area
产地。
is_jd_express
是否由京东物流配送。
variant_count
变体(SKU)数量;null 表示无变体或未提供。skus 的每一行都带同一个值:它大于本次返回的行数时,说明被 limit 截断或有 SKU 这次没取到。
variants
变体列表,每项含名称、SKU、价格、库存状态等;null 表示无变体或未提供。
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 表示平台未公开。
images
图片链接数组,按平台展示顺序;没有图片时不出现这个字段。
author_name
评价人昵称,按京东页面原样返回(京东可能已部分打码)。
author_avatar_url
评价人头像链接。
author_is_plus
评价人是否为京东 PLUS 会员。
buy_count
评价人购买该商品的次数(页面显示的「购买 N 次」。
product_id
京东商品组 ID:同一商品的所有 SKU 共用(skus)。它不是 SKU,不能当 item_id 去调详情、评价或价格。
is_requested
这一行是不是请求里传的那个 SKU(skus);同一商品的其他 SKU 为 false。
properties
这个 SKU 的销售属性,属性名 → 属性值,按京东页面原文(如 外观: 亚麻灰、存储容量: 12GB+512GB)(skus)。
on_sale
这个 SKU 是否在售(上架)(skus)。在售不等于有货,有货看 in_stock 与 stock_state。
in_stock
这个 SKU 现在能否直接下单(有现货)(skus)。预售、预约中的 SKU 为 false,详见 stock_state。
purchase_limit
每位买家限购件数;null 表示页面没写限购(skus)。
delivery_promise
京东页面上的配送或发货承诺原文,如「预计11月9日前发货」(skus);按京东未登录时的默认收货地区给出,换地区可能不同。
is_presale
是否为预售商品(skus)。
is_government_subsidy
京东是否给这个 SKU 标了国家补贴(国补)(skus);这个标记本身不说明 price 是否已扣除补贴。null 表示这次没拿到这个标记。
is_billion_subsidy
京东是否给这个 SKU 标了百亿补贴(skus);null 表示这次没拿到这个标记。
is_flash_sale
这个 SKU 是否在秒杀中(skus);null 表示这次没拿到这个标记。
promo_tags
京东给这个 SKU 标的促销标签原文列表(skus);null 表示没有或这次没拿到。
position
这张图在「商品介绍」里的序号,从 1 开始、按页面从上到下(description_images)。
image_count
这个商品「商品介绍」区这次一共返回几张图,每行相同(description_images);大于本次拿到的行数说明被 limit 截断了。

当前目录另列出 useful_count,这些字段尚无逐项释义;请先核对 京东 JD.com 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

先搜索商品并保存返回的 item_id;详情、评价与价格继续使用同一个数字标识。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

jd_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer 你的 API Key" \
  -H "Content-Type: application/json" \
  -d '{"platform":"jd","action":"search","params":{"keyword":"华为手机"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "item_id": null,
  "url": null,
  "title": null,
  "short_title": null,
  "price": null,
  "currency": null,
  "sold_count": null,
  "review_count": null,
  "good_rate": null,
  "shop_id": null,
  "shop_name": null,
  "shop_url": null,
  "is_jd_self": null,
  "promotion": null,
  "sell_point": null,
  "category_ids": null,
  "image_url": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

怎样先搜索京东商品,再用 item_id 串联后续接口?

用 search 按商品词取得候选,每条结果中由数字字符组成的 item_id 字符串可继续交给详情、评价或单品价格接口。

查看 search 的 keyword 参数 →
  • keyword 是京东商品搜索词;首发固定只取一页,最多返回 25 条。item_id、shop_id 与 category_ids[] 都是字符串,不要转成 JavaScript number;先用它们连同 title、shop_name、price 与 currency 核对对象,不把展示销量或好评率写成实际成交与全量评价。
  • search 返回的 price 是抓取时可见价格快照,可能不包含会员、新人、地区、定向券或结算页权益。2026-09-04 曾出现 reviews 类型修复后整批为空;运行结束不等于结果非空、字段正确或已经可以交付。

怎样用京东 item_id 核对单品详情,而不是传任意商品 URL?

把 search 返回的数字字符串 item_id 交给 product_detail,核对商品、店铺、价格显示和库存状态。

查看 product_detail 的 item_id 参数 →
  • item_id 是由数字字符组成的字符串;输入只接受该字符串,或不带 query/fragment 的 https://item.jd.com/<数字>.html。不接受 /product/<opaque>.html、短链、其他域名或任意京东页面。
  • price_display 可能是遮罩原文;price_masked=true 时不能把它当精确价格。stock 缺失不等于零库存,available 与 unavailable_reason 也只描述当前取得的公开状态,不是下单或履约保证。

怎样按京东商品 item_id 读取公开评价并保留审核与隐私边界?

用 reviews 读取最多 10 条公开评价,区分首次评价、追加评价、评分、规格和有用数。

查看 reviews 的 item_id 参数 →
  • item_id 是数字字符串,格式与 product_detail 相同;text 是评价正文,review_append 是追加评价,rating 要与 rating_scale 一起理解,posted_at 是当前返回的评价时间。
  • 京东会审核、折叠或隐藏评价;一页结果不代表完整历史。评价人昵称(京东可能已部分打码)、头像、是否 PLUS 会员与购买次数在 author_name、author_avatar_url、author_is_plus、buy_count;公开展示也不自动授予下载者对文字、图片或用户标识的再分发、训练或商业使用权,使用方仍要核授权、目的、保存与删除规则。

怎样用 shop_id 查看京东店铺的一页商品?

用 shop 读取指定店铺当前取得的一页商品,只把 item_id、title 与 url 作为首发可承诺的商品身份字段。

查看 shop 的 shop_id 参数 →
  • shop_id 是由数字字符组成的字符串;输入只接受该字符串,或不带 query/fragment 的 https://mall.jd.com/index-<数字>.html。它不是商品 item_id、店铺名称或任意店铺内页。首发固定只取一页,最多 24 条,结果不是全店完整目录。
  • 后端当前候选目录还列出 price、currency、shop_id、shop_name、shop_url、image_url 与 available,但这些字段尚未经过最小真实 shop 样本证明或完成契约收窄;SEO 用例暂不承诺它们,也不从其他商品、店铺或页面补值。

怎样对京东 search 结果里的 item_id 做当前价格快照?

用 product_price 查询一个商品的当前公开价格与可售状态,不重复拉取详情对象。

查看 product_price 的 item_id 参数 →
  • item_id 是数字字符串,只接受该字符串或不带 query/fragment 的旧式 item.jd.com 数字商品页;price 与 currency 是本次取得的价格快照,available 与 unavailable_reason 用于区分可售、不可售和没有可用价格。
  • 当前公开价格不等于会员价、个人券后价、地区价、历史最低价或最终结算价。price 缺失时保留 unknown,不按零价处理,也不从一次成功运行推导价格必然存在。

怎样一次取齐京东商品的全部 SKU,以及每个 SKU 的价格和库存?

把任一 SKU 的 item_id 或商品页链接交给 skus,按 SKU 逐行拿到规格、京东价、在售与库存,用于上货或比价。

查看 skus 的 item_id 参数 →
  • item_id 可以是数字字符串、item.jd.com 或 item.m.jd.com 的商品页链接,或只含一个这类链接的分享文本;3.cn、u.jd.com 短链要先在浏览器打开再复制商品页链接。第一行是请求里的那个 SKU(is_requested 为 true),其后是京东为它列出的同款 SKU;properties 是规格原文,product_id 是同款共用的商品组 ID,不能当 item_id 再调详情。
  • price 是京东对未登录买家展示的价格,不含结算时才使用的优惠券,不是单品到手价;in_stock 为 false 时看 stock_state 区分预售、预约与无货,stock 缺失不等于零。每返回一个 SKU 算一次调用,按 limit(最多 100)先扣、没返回的当场退回;variant_count 大于返回行数时说明被 limit 截断或有 SKU 这次没取到。

怎样取京东商品「商品介绍」里的全部详情图?

把任一 SKU 的 item_id 或商品页链接交给 description_images,按页面从上到下逐张拿到详情长图的原图链接,用于上货、比价或竞品分析。

查看 description_images 的 item_id 参数 →
  • 每张图一行:position 从 1 开始按页面顺序编号,image_url 是京东图床的 https 原图,image_count 是这次一共返回几张(每行相同)。item_id 的写法与 skus 相同,3.cn、u.jd.com 短链要先在浏览器打开再复制商品页链接。
  • 这里只有「商品介绍」区的图;主图与图集在 product_detail 的 image_urls,product_detail 不含详情图。商品已下架或卖家没写介绍时没有详情图,按空结果退款;每次调用按标准档计一次,与 product_detail 同价。

京东 JD.com 教程与实战

先在本页核对当前 action、参数与字段,再按真实任务进入完整步骤或相邻方法;文章中的示例和边界不会替代本页机器目录。

指南

统一数据 API 入门:从能力目录到第一条可用结果

用 platform、action、params 接入多平台数据:读懂能力目录,完成最小请求,处理异步任务、部分结果与计费,并建立可追溯的数据记录。

阅读完整文章 →
Blog

价格抓取怎么商业化:做一款商家愿意续费的价格监控产品

商家为什么为价格监控付费,又为什么取消订阅?从商品匹配、经营例外清单和调价审批出发,拆解价格数据的交付方式、收费单位与试点验证。

阅读完整文章 →
指南

API 失败、返还与对账:如何核对一条请求的净扣款

把业务任务、调用尝试、交付状态与钱包事件分开,解释扣前拒绝、空结果和部分返还,避免把同一返还重复减项,并用整数离线示例核对单次请求。

阅读完整文章 →

京东 JD.com API 常见问题

京东 JD.com API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="jd"、action 和 params。以 search 为例,必填 keyword,没有可选参数。先搜索商品并保存返回的 item_id;详情、评价与价格继续使用同一个数字标识。 京东 JD.com 共 7 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 90 个平台。

京东 JD.com API 怎么收费?

$1.39 / 千次,京东 JD.com 全部 7 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 京东 JD.com 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

京东 JD.com API 一次能返回多少条数据?

京东 JD.com 有 5 个列表接口,包括 search、reviews、shop、skus、description_images。其余 2 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

京东 JD.com API 返回哪些字段?

当前目录为 search 列出 item_id、url、title、short_title、price、currency 等 18 个字段名。按全站当前目录统计,23 个字段名只在 京东 JD.com 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

京东 JD.com API 的能力都能异步调用吗?

skus 只能同步调用:一次请求里读完要返回的全部内容(批量里的每个目标,或一个商品的全部 SKU);请求体带 "mode": "async" 会在扣费前返回 422。其他能力可以在请求体加 "mode": "async",先拿到 job_id,再轮询 GET /api/v1/jobs/{job_id} 取结果。

怎样先搜索京东商品,再用 item_id 串联后续接口?

用 search 按商品词取得候选,每条结果中由数字字符组成的 item_id 字符串可继续交给详情、评价或单品价格接口。 keyword 是京东商品搜索词;首发固定只取一页,最多返回 25 条。item_id、shop_id 与 category_ids[] 都是字符串,不要转成 JavaScript number;先用它们连同 title、shop_name、price 与 currency 核对对象,不把展示销量或好评率写成实际成交与全量评价。 search 返回的 price 是抓取时可见价格快照,可能不包含会员、新人、地区、定向券或结算页权益。2026-09-04 曾出现 reviews 类型修复后整批为空;运行结束不等于结果非空、字段正确或已经可以交付。

怎样用京东 item_id 核对单品详情,而不是传任意商品 URL?

把 search 返回的数字字符串 item_id 交给 product_detail,核对商品、店铺、价格显示和库存状态。 item_id 是由数字字符组成的字符串;输入只接受该字符串,或不带 query/fragment 的 https://item.jd.com/<数字>.html。不接受 /product/<opaque>.html、短链、其他域名或任意京东页面。 price_display 可能是遮罩原文;price_masked=true 时不能把它当精确价格。stock 缺失不等于零库存,available 与 unavailable_reason 也只描述当前取得的公开状态,不是下单或履约保证。

怎样按京东商品 item_id 读取公开评价并保留审核与隐私边界?

用 reviews 读取最多 10 条公开评价,区分首次评价、追加评价、评分、规格和有用数。 item_id 是数字字符串,格式与 product_detail 相同;text 是评价正文,review_append 是追加评价,rating 要与 rating_scale 一起理解,posted_at 是当前返回的评价时间。 京东会审核、折叠或隐藏评价;一页结果不代表完整历史。评价人昵称(京东可能已部分打码)、头像、是否 PLUS 会员与购买次数在 author_name、author_avatar_url、author_is_plus、buy_count;公开展示也不自动授予下载者对文字、图片或用户标识的再分发、训练或商业使用权,使用方仍要核授权、目的、保存与删除规则。

怎样用 shop_id 查看京东店铺的一页商品?

用 shop 读取指定店铺当前取得的一页商品,只把 item_id、title 与 url 作为首发可承诺的商品身份字段。 shop_id 是由数字字符组成的字符串;输入只接受该字符串,或不带 query/fragment 的 https://mall.jd.com/index-<数字>.html。它不是商品 item_id、店铺名称或任意店铺内页。首发固定只取一页,最多 24 条,结果不是全店完整目录。 后端当前候选目录还列出 price、currency、shop_id、shop_name、shop_url、image_url 与 available,但这些字段尚未经过最小真实 shop 样本证明或完成契约收窄;SEO 用例暂不承诺它们,也不从其他商品、店铺或页面补值。

可以先免费试用 京东 JD.com API 吗?

可以。注册免费,加微信领 $1 额度码(≈720 次数据调用),注册后在控制台「余额与充值」兑换,进入赠送余额,24 小⁠时内有效。请先选择 京东 JD.com 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 7 个能力。无需信用卡。

开始调用 京东 JD.com API

加微信领 $1 额度码,注册后在控制台兑换,24 小⁠时内有效,先选一个 京东 JD.com 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始