京东 JD.com 店铺资料 API

按 shop_id 读一个京东店铺里的商品行:item_id、title、price、currency、image_url、available,每行带店铺的 shop_id、shop_name 和 shop_url,按返回条数分档计费,每档 $0.02881。

店铺资料按 shop_id 读取一个京东店铺里的商品行:商品 item_id、标题 title、价格 price 和 currency、主图 image_url、是否可售 available,每行还带店铺自己的 shop_id、shop_name 和 shop_url。它回答「这家店在卖什么、定价在什么位置」,适合盯竞品店铺的商品与定价,或者给选品调研建一份店铺商品清单。

shop_id 是数字字符串,不是商品 ID,也不是店铺名称;也可以填不带 query 和 fragment 的店铺链接 https://mall.jd.com/index-<数字>.html。目前一次最多 24 条,默认也是 24 条。

  • limit 上限 60,用 page 或 page_token 往后翻
  • item_id 可交给 product_detail、product_price 和 skus
  • 失败和空结果不收费
免费开始

接口健康状态

24h 健康值
正常
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
    {
      "platform": "jd",
      "action": "shop",
      "params": {
        "shop_id": "1000004259"
      }
    }
  2. 2JSON 响应

    {
      "results": [
        {
          "item_id": "100386940168",
          "title": "HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表",
          "price": 2688,
          "currency": "CNY"
        },
        …
      ],
      "count": 24
    }
  3. 3行

    item_idtitlepricecurrency
    100386940168HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表2688CNY
    100343412080华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘7599CNY
  4. 4CSV

    jd-shop-sample.csv item_id,url,title,price,currency,shop_id,shop_name,shop_url,image_url,available,platform

请求带 shop_id,返回一页该店铺的商品,results 里每行是一件商品,列成字段表,也可下载为 CSV。

能拿到什么数据

下表取自对 1000004259 的一次真实调用,采集于 2026年11月7日 22:47(UTC),共返回 24 行。你自己调用时,按字段表返回这些字段。

item_idurltitlepricecurrencyshop_idshop_nameshop_urlimage_urlavailableplatform
100386940168https://item.jd.com/100386940168.htmlHUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表2688CNY1000004259华为京东自营旗舰店https://mall.jd.com/index-1000004259.htmlhttps://img14.360buyimg.com/n0/jfs/t1/550965/17/7947/140219/6ae2b424F7cc9d94c/00835a05a09af40b.jpgnulljd
100343412080https://item.jd.com/100343412080.html华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘7599CNY1000004259华为京东自营旗舰店https://mall.jd.com/index-1000004259.htmlhttps://img14.360buyimg.com/n0/jfs/t1/537470/34/12588/89809/6acef399F2a2483a1/00835a05a01f9084.jpgnulljd

用途

  • 盯竞品店铺的定价

    定期读同一家店,按 item_id 对比 price 的变化。

  • 建店铺商品清单

    把 item_id、title 和 image_url 存成清单,当选品调研的底表。

  • 核对授权经销商的上架情况

    品牌方读各家店铺的商品行,看 title 和 price 是不是按约定上架。

  • 看店铺的价格带

    用读到的商品行的 price 看这家店的价格分布。

限制和注意事项

  • shop_id 必填:京东店铺数字 ID,或不带 query、fragment 的 https://mall.jd.com/index-<数字>.html;不是商品 ID。
  • 一页条数用 limit,上限 60;每页按这一页返回的条数分档计费,没返回的条数对应的档退回,空页不扣费。
  • 翻页有两种:从第 1 页起把 next_page_token 原样作为 page_token 传回,或用 page 直接跳到第 N 页;两个同传时以 page_token 为准。
  • 能读到的商品有固定的深度上限,最深一页没有 next_page_token,pagination.stop_reason 为 depth_limit;返回的条数不是店里的商品总数。
  • 第 2 页起的商品取自一份保存下来的列表,最多是一小时前的;用 page 直接跳页时可能有商品重复或缺漏,合并时按 item_id 去重。
  • available 为 null 表示页面没给;单个商品的缺货原因用 product_price 读。

价格

按这一页返回的商品条数分档计费,每一档算一次调用,每次 $0.02881;没返回的条数对应的档退回,空页不扣费。用 page 直接跳到第 N 页,按前面各页整页加上第 N 页本身一起收,和一页页翻到第 N 页收得一样。失败和空结果不收费。

调用次数费用
10,000$288.06
100,000$2,880.56
1,000,000$28,805.56

合计按每次调用的标价算。

代码示例

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "jd",
  "action": "shop",
  "params": {
    "shop_id": "1000004259"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。

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

API 参考

下面是 shop 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。

POST

AI 提示词

#
请帮我用 EveryInfra 的「京东 JD.com 店铺资料」接口(jd/shop)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 jd,action 填 shop,参数放在 params 里。
- 必填参数:
  - shop_id:京东店铺数字 ID,或不带 query/fragment 的 https://mall.jd.com/index-<数字>.html;不是商品 ID。
- 可选参数:
  - page:店铺商品的页码,整数;不传或传 1 就是第 1 页。取值范围是 1 到 168 ÷ limit(向上取整):默认 limit 24 时 1–7,limit 60 时 1–3。
  - page_token:翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数保持不变。
  - limit:这次调用最多返回的条数,整数,1–60;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 24)
- 返回一组记录,每条记录的主要字段:item_id(京东商品数字 ID)、url、title、price、currency、shop_id(京东店铺数字 ID)、shop_name(公开店铺名称)、shop_url(京东店铺公开页面)、image_url(图片链接:search、produ…)、available(采集时是否可售(product_d…)。
- 示例请求体:
{
  "platform": "jd",
  "action": "shop",
  "params": {
    "shop_id": "1000004259"
  }
}
- 计费:$28.81 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是jd平台标识,固定值。
actionbodystring是shop能力标识,固定值。
shop_idbody.paramsstring是-京东店铺数字 ID,或不带 query/fragment 的 https://mall.jd.com/index-<数字>.html;不是商品 ID。
pagebody.paramsinteger否-店铺商品的页码,整数;不传或传 1 就是第 1 页。取值范围是 1 到 168 ÷ limit(向上取整):默认 limit 24 时 1–7,limit 60 时 1–3。用 page 时,每页条数就是这次请求的 limit(1–60)。每一页都按第 1 页的价收,只按这一页自己的条数分档,每 24 条算一次调用:limit 24 时每页算 1 次;limit 60 时每页 60 条算 3 次,最后一页(第 121–168 条,48 条)算 2 次。用 page=N 直接跳到第 N 页,这一次按 N 页收,和一页页翻到第 N 页收得一样(前面 N − 1 页按整页算,加上第 N 页本身):limit 24、page 5 算 5 次调用;limit 60、page 3 算 3 + 3 + 2 = 8 次调用。第 N 页没返回的条数对应的档退回;第 N 页是空的(比如列表没那么长),整次不扣费。page 超出范围、是 0、负数、小数、字符串(如 "2")或布尔值时,扣费前返回 422,不扣费。同步请求就能翻到最深那一页(第 168 条),不用加 "mode": "async"。最深那一页(limit 24 时是第 7 页)没有 next_page_token,pagination.stop_reason 为 depth_limit;列表本来就短、翻到头时为 end_of_list。第 1 页每次都现取。第 2 页起从一份保存下来的完整列表(最多 168 条)里按顺序切;第一次要第 2 页或更后面的页时,这份列表最多是一小时前的。用 page 直接要的页,从这份列表里按原位置切(第 N 页 = 列表里第 (N − 1) × limit + 1 条起的 limit 条)。它不知道你之前拿到的第 1 页是什么样,所以和单独取的第 1 页之间、或者跨了整点再要的页之间,可能有几件商品重复或缺漏,合并时按 item_id 去重。要一页不重复地读完整个列表,从第 1 页起跟着 next_page_token 翻。pagination.page 是这一页的页码;pagination.has_more 为 true 就还有下一页:接着传 page + 1,或把 next_page_token 作为 page_token 传回。page 和 page_token 同传时以 page_token 为准。按页码要到的页也会给 next_page_token,下一次带不带 page 都能用它。
page_tokenbody.paramsstring否-翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数保持不变。每页条数沿用拿到这个令牌的那次请求的 limit,之后改 limit 不起作用。也可以不用令牌,用 page 直接要第 N 页;page 和 page_token 同传时以 page_token 为准。令牌 24 小时内有效,只能用于同一个店铺、同一个账户;换了店铺会被拒(422,不扣费)。每一页都按第 1 页的价收,只按这一页自己的条数分档,每 24 条算一次调用:limit 24 时每页算 1 次,翻到第 5 页一共 5 次调用;limit 60 时每页 60 条算 3 次,最后一页(第 121–168 条,48 条)算 2 次。没返回的条数对应的档退回,一条都没返回的空页(比如翻过了短列表的末页)不扣费。最多翻到第 168 条(limit 24 时是 7 页),同步请求就能翻到,不用加 "mode": "async"。第 168 条所在的那一页没有 next_page_token,pagination.stop_reason 为 depth_limit;列表本来就短、翻到头时为 end_of_list。第 1 页每次都现取。第 2 页起从一份保存下来的完整列表(最多 168 条)里按顺序切;第一次要第 2 页或更后面的页时,这份列表最多是一小时前的。用 page_token 从第 1 页一路翻下去,后面每一页都从同一份列表里切:第 1 页已经给过的商品不再出现,中间也不漏,所以各页之间没有重复的商品。翻得慢也一样,这条令牌链一直用它第一次到第 2 页时的那一份。pagination.page 是这一页的页码;pagination.has_more 为 true 就还有下一页,把 next_page_token 作为 page_token 传回。按页码要到的页也会给 next_page_token,下一次带不带 page 都能用它。
limitbody.paramsinteger (1–60)否24这次调用最多返回的条数,整数,1–60;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。

响应示例

#
2026年11月7日 22:47(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。
json
{  "id": "req_…",  "platform": "jd",  "action": "shop",  "results": [    {      "item_id": "100386940168",      "url": "https://item.jd.com/100386940168.html",      "title": "HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表",      "price": 2688,      "currency": "CNY",      "shop_id": "1000004259",      "shop_name": "华为京东自营旗舰店",      "shop_url": "https://mall.jd.com/index-1000004259.html",      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/550965/17/7947/140219/6ae2b424F7cc9d94c/00835a05a09af40b.jpg",      "platform": "jd"    },    {      "item_id": "100343412080",      "url": "https://item.jd.com/100343412080.html",      "title": "华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘",      "price": 7599,      "currency": "CNY",      "shop_id": "1000004259",      "shop_name": "华为京东自营旗舰店",      "shop_url": "https://mall.jd.com/index-1000004259.html",      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/537470/34/12588/89809/6acef399F2a2483a1/00835a05a01f9084.jpg",      "platform": "jd"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 24,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。

字段含义
item_id京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
url该记录在原平台上的可访问链接。
title标题。平台无标题概念时(如纯文本帖)为 null。
price价格数值,不含货币符号;币种见 currency。
currency价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
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 表示页面没给。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

错误与计费

#
401
缺少 Key 或 Key 无效。
402
余额不足,先充值。
422
参数名或取值不对,按错误信息给的候选改;不扣费。
429
超过每分钟请求上限,按 Retry-After 等待后再试。
503
暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
200 空结果
没有数据,不扣费。

错误码

常见问题

店里的商品超过 24 个怎么办?

目前最多 24 条,这一页也没有翻页参数,所以店里商品更多时,一次只能读到其中一部分。做竞品监测时,要把这个上限写进口径,不要把返回的条数当作这家店的商品总数。

shop_id 在哪里找,能填店铺名称吗?

不能填店铺名称,也不能填商品 ID。要填店铺的数字 ID,或者店铺链接 https://mall.jd.com/index-<数字>.html,链接里 index- 后面的数字就是 shop_id。链接不要带 query 或 fragment。

读到商品行之后,怎么看单个商品的缺货原因?

把行里的 item_id 交给商品价格那一页,单个商品的价格、币种和可售状态都在那里,缺货时还有京东页面给出的原因。这一页的 image_url 是商品主图(封面),要做商品清单展示时直接用它。

京东店铺接口返回哪些字段?

每行是一件商品:item_id、url、title、price、currency、image_url、available,另带店铺的 shop_id、shop_name 和 shop_url。

读一页店铺商品怎么收费?

按这一页返回的条数分档,每一档算一次调用,每次 $0.02881,每千次 $28.81。失败和空结果不收费。

同一把 Key 还能调用京东的其他能力。

Google Analytics 同意才加载 隐私