京东 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请求
POST /api/v1/social { "platform": "jd", "action": "shop", "params": { "shop_id": "1000004259" } }2JSON 响应
{ "results": [ { "item_id": "100386940168", "title": "HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表", "price": 2688, "currency": "CNY" }, … ], "count": 24 }3行
item_id title price currency 100386940168 HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表 2688 CNY 100343412080 华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘 7599 CNY 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_id | url | title | price | currency | shop_id | shop_name | shop_url | image_url | available | platform |
|---|---|---|---|---|---|---|---|---|---|---|
| 100386940168 | https://item.jd.com/100386940168.html | HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表 | 2688 | CNY | 1000004259 | 华为京东自营旗舰店 | https://mall.jd.com/index-1000004259.html | https://img14.360buyimg.com/n0/jfs/t1/550965/17/7947/140219/6ae2b424F7cc9d94c/00835a05a09af40b.jpg | null | jd |
| 100343412080 | https://item.jd.com/100343412080.html | 华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘 | 7599 | CNY | 1000004259 | 华为京东自营旗舰店 | https://mall.jd.com/index-1000004259.html | https://img14.360buyimg.com/n0/jfs/t1/537470/34/12588/89809/6acef399F2a2483a1/00835a05a01f9084.jpg | null | jd |
用途
盯竞品店铺的定价
定期读同一家店,按
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 |
合计按每次调用的标价算。
代码示例
#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 助手。
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 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | jd | 平台标识,固定值。 |
action | body | string | 是 | shop | 能力标识,固定值。 |
shop_id | body.params | string | 是 | - | 京东店铺数字 ID,或不带 query/fragment 的 https://mall.jd.com/index-<数字>.html;不是商品 ID。 |
page | body.params | integer | 否 | - | 店铺商品的页码,整数;不传或传 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_token | body.params | string | 否 | - | 翻页令牌。第 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 都能用它。 |
limit | body.params | integer (1–60) | 否 | 24 | 这次调用最多返回的条数,整数,1–60;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。 |
响应示例
#{ "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。失败和空结果不收费。
相关的 京东 JD.com 能力
同一把 Key 还能调用京东的其他能力。
- 关键词搜索
search每千次 $2.47关键词搜索:返回列表,默认 5 条、单次最多 30 条;主要字段 item_id、url、title、short_title、price、currency。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页按这一页的条数计费,每 5 条算一次调用;最深 150 条。 - 商品详情
product_detail每千次 $2.44商品详情:返回单个对象;主要字段 item_id、url、title、price、price_display、price_masked。 - 评价
reviews每千次 $8评价:返回列表,默认 10 条、单次最多 10 条;主要字段 id、item_id、text、review_append、rating、rating_scale。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 商品价格
product_price每千次 $5.56商品价格:返回单个对象;主要字段 item_id、url、price、currency、available、unavailable_reason。 - 全部 SKU 与价格
skus每千次 $2.44全部 SKU 与价格:返回列表。每个 SKU 一行,第一行是请求里的那个(is_requested 为 true),其后是京东为它列出的其他颜色、尺码或容量;每行各有 properties(规格)、price、on_sale、in_stock、stock_state、stock。price 是京东对未登录买家展示的价格,不含结算时才使用的优惠券,不是券后到手价。每返回一个 SKU 算一次调用:按 limit(1–100,默认 100)先扣,没返回的当场退回;只能同步调用。 - 商品介绍详情图
description_images每千次 $8商品介绍详情图:返回列表。每张图一行,按「商品介绍」从上到下排:position 从 1 开始,image_url 是京东图床的 https 原图,image_count 是这次一共返回几张。主图与图集在 product_detail 的 image_urls,product_detail 不含详情图;商品没有详情图时按空结果退款。