京东 JD.com 评价 API
按 item_id 读一件京东商品的公开评价,每条返回 text、review_append、rating、rating_scale、posted_at、color、size 和 useful_count,每千次 $8。
京东评价接口按 item_id 读取一件商品的公开评价,每条带正文、买家追加评价、评分、发布时间、购买的颜色和尺码、评价人昵称、是否 PLUS 会员和购买次数。它回答「买过的人怎么说」,适合做口碑分析、差评原因归类,以及对比竞品在细节上的优劣。
review_append 是买家在首评之后追加的内容,往往比首评更能说明耐用性和售后问题,值得单独分析。评价人昵称按京东页面原样返回,可能已部分打码,不能用来识别个人。比较评分前先看同一行的 rating_scale。
- 一页最多 10 条,用
next_page_token往后翻 images给评价里的晒单图链接- 每页算一次调用;失败和空结果不收费
接口健康状态
- 24h 健康值
- 27%
- 24h 平均耗时
- 42.84 s
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
24 小时趋势
30 天趋势
1请求
POST /api/v1/social { "platform": "jd", "action": "reviews", "params": { "item_id": "100012043978" } }2JSON 响应
{ "results": [ { "author_name": "j•••℡", "item_id": "100012043978", "text": "物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试", "rating": 5 }, … ], "count": 10 }3行
author_name item_id text rating j•••℡ 100012043978 物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试 5 陈•••7 100012043978 东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验 5 4CSV
jd-reviews-sample.csv 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,next_page_token
item_id,返回一页公开评价,results 里每行是一条评价,列成字段表,也可下载为 CSV。能拿到什么数据
下表取自对 100012043978 的一次真实调用,采集于 2026年11月7日 22:47(UTC),共返回 10 行;灰条是隐去的评价 ID、评价人昵称和头像链接(CSV 里是 •••)。你自己调用时,按字段表返回这些字段。
| 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 | next_page_token |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 100012043978 | 物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试 | null | 5 | 5 | 2026-11-07 14:34:45 | 1699(需预约) | 单瓶装 | 0 | ["https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/557810/23/10814/50965/6aeec685F7fa2380d/00a94387803e2e5c.jpg.dpg","https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/568876/20/7224/105703/6aeec685Fb32a61e9/00a9438780d6819f.jpg.dpg"] | j•••℡ | false | 11 | jd | null | ||
| 100012043978 | 东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验 | null | 5 | 5 | 2026-11-05 18:31:46 | 1699(需预约) | 单瓶装 | 0 | ["https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/568910/26/5643/80138/6aec5b11F8b1fc87a/00a94387808839c8.jpg.dpg","https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/563156/26/7646/104649/6aec5b11Fb763e1e5/00a943878073852a.jpg.dpg"] | 陈•••7 | false | 3 | jd | null |
用途
差评原因归类
取
rating低的评价,读text和review_append,把抱怨归成几类。比不同规格的反馈
按
color和size分组,看各规格的评价有什么差别。抽查晒单图
images是评价里的晒单图链接,用来抽查实物和商品页是否一致。看评价集中在哪几天
翻几页后按
posted_at统计,看新评价集中在哪些日期。
京东帮助中心:评价晒单规则 与 EveryInfra 对比
下面从追加评价、昵称显示和评价的展示范围三方面,比较京东帮助中心的评价晒单规则和 EveryInfra reviews。
| 对比项 | 京东帮助中心:评价晒单规则 | EveryInfra |
|---|---|---|
| 追加评价 | "客户可在订单完成后60日内对所购商品作出首次评价晒单,90日内对商品服务作出评价,180天进行追加评价(某些特殊品类除外)"。 | review_append 是买家追加的评价内容,和首次评价的 text 分开返回。 |
| 昵称显示 | "在商品详情页评价模块会对用户昵称星号脱敏展示,比如:小***西。" | author_name 按京东页面原样返回,京东可能已部分打码。 |
| 展示范围 | "京东平台将对评价和晒单内容进行审核,符合规则且审核通过的评价和晒单才能展示给其他用户。" | reviews 读的是商品页上公开显示的评价;一页只有一部分,不是这件商品全部评价的集合。 |
引文出自京东帮助中心的评价晒单规则,2026-11-22 核对;页面没有标更新日期。这是面向买家的规则说明,不是读取评价的接口文档。 官方出处: 评价晒单规则(京东帮助中心)
限制和注意事项
item_id必填:京东商品数字 ID,或不带 query、fragment 的 https://item.jd.com/<数字>.html。- 只能用
next_page_token一页一页往后翻,京东评价不支持按页码跳页;响应里没有next_page_token(pagination.has_more为 false)就是到底。 limit小于 10 时,某一页可能少于limit条,这不代表到底;到底只看有没有next_page_token。- 翻页期间有新评价进来,相邻两页可能有一两条重复,合并时按评价
id去重。 - 比较评分前先看同一行的
rating_scale,它是rating的满分。
价格
每页算一次调用,每次 $0.008,不按评价条数算;空页不扣费。失败和空结果不收费。
| 调用次数 | 费用 |
|---|---|
| 10,000 | $80.00 |
| 100,000 | $800.00 |
| 1,000,000 | $8,000.00 |
合计按每次调用的标价算。
代码示例
#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": "reviews",
"params": {
"item_id": "100012043978"
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
使用 search 返回的 item_id,目前固定一页,最多 10 条公开评价。
API 参考
下面是 reviews 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。
AI 提示词
#请帮我用 EveryInfra 的「京东 JD.com 评价」接口(jd/reviews)写一个数据采集脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 jd,action 填 reviews,参数放在 params 里。
- 必填参数:
- item_id:京东商品数字 ID,或不带 query/fragment 的 https://item.jd.com/<数字>.html;返回最多 10 条公开评价。
- 可选参数:
- page_token:翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数保持不变(limit 可以改)。
- limit:这次调用最多返回的条数,整数,1–10;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 10)
- 返回一组记录,每条记录的主要字段:id、item_id(京东商品数字 ID)、text、review_append(买家追加评价)、rating、rating_scale、posted_at、color(京东页面上这个 SKU 的颜色(或…)、size(京东页面上这个 SKU 的尺码、容…)、useful_count、images、author_name(评价人昵称);一共 16 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=jd。
- 示例请求体:
{
"platform": "jd",
"action": "reviews",
"params": {
"item_id": "100012043978"
}
}
- 计费:$8 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "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 | 是 | reviews | 能力标识,固定值。 |
item_id | body.params | string | 是 | - | 京东商品数字 ID,或不带 query/fragment 的 https://item.jd.com/<数字>.html;返回最多 10 条公开评价。 |
page_token | body.params | string | 否 | - | 翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数保持不变(limit 可以改)。令牌 24 小时内有效,只能用于同一个商品、同一个账户;换了商品会被拒(422,不扣费)。响应里没有 next_page_token(pagination.has_more 为 false)就是到底了。每页最多 10 条,每页算一次调用,空页不扣费。limit 小于 10 时,下一页会先补上上一页没取完的那一批评价,所以某一页可能少于 limit 条,这不代表到底;到底只看有没有 next_page_token。翻页期间有新评价进来,相邻两页可能有一两条重复,合并时按评价 id 去重。京东评价不支持按页码跳页,只能用 next_page_token 一页一页往后翻。 |
limit | body.params | integer (1–10) | 否 | 10 | 这次调用最多返回的条数,整数,1–10;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。 |
响应示例
#{ "id": "req_…", "platform": "jd", "action": "reviews", "results": [ { "id": "•••", "item_id": "100012043978", "text": "物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试", "rating": 5, "posted_at": "2026-11-07 14:34:45", "color": "1699(需预约)", "size": "单瓶装", "useful_count": 0, "images": [ "https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/557810/23/10814/50965/6aeec685F7fa2380d/00a94387803e2e5c.jpg.dpg", "https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/568876/20/7224/105703/6aeec685Fb32a61e9/00a9438780d6819f.jpg.dpg" ], "author_name": "j•••℡", "author_avatar_url": "https://storage.360buyimg.com/•••", "author_is_plus": false, "buy_count": 11, "platform": "jd", "rating_scale": 5 }, { "id": "•••", "item_id": "100012043978", "text": "东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验", "rating": 5, "posted_at": "2026-11-05 18:31:46", "color": "1699(需预约)", "size": "单瓶装", "useful_count": 0, "images": [ "https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/568910/26/5643/80138/6aec5b11F8b1fc87a/00a94387808839c8.jpg.dpg", "https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/563156/26/7646/104649/6aec5b11Fb763e1e5/00a943878073852a.jpg.dpg" ], "author_name": "陈•••7", "author_avatar_url": "https://storage.360buyimg.com/•••", "author_is_plus": false, "buy_count": 3, "platform": "jd", "rating_scale": 5 } ], "next_page_token": …, "pagination": { … }, "count": 10, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
返回字段
#业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
id | 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。 |
item_id | 京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。 |
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 表示平台未公开。 |
color | 京东页面上这个 SKU 的颜色(或外观)属性值。 |
size | 京东页面上这个 SKU 的尺码、容量或规格属性值。 |
useful_count | 保留平台原语义 |
images | 图片链接数组,按平台展示顺序;没有图片时不出现这个字段。 |
author_name | 评价人昵称,按京东页面原样返回(京东可能已部分打码)。 |
author_avatar_url | 评价人头像链接。 |
author_is_plus | 评价人是否为京东 PLUS 会员。 |
buy_count | 评价人购买该商品的次数(页面显示的「购买 N 次」。 |
platform | 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。 |
next_page_token | 翻页令牌:作为下一次请求的 page_token 原样传回取下一页(其余参数不变,24 小时内有效,只能用于同一个商品);同一页每行的值相同,响应顶层也有同一个 next_page_token。没有该字段即到底;limit 小于 10 时某一页可能少于 limit 条,到底只看有没有这个字段。 |
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。
常见问题
追评有什么用?
review_append 是买家在首次评价之后追加的内容,常常写到用了一段时间后的体验,比如耐用性、质量问题和售后。把它和首评分开分析,能看出短期满意和长期满意的差别。
评价人的信息能拿到多少?
能拿到页面公开显示的昵称、头像、是否 PLUS 会员和购买次数,昵称可能已被京东部分打码。这些信息适合分析买家结构,不能用来识别具体的人。
能翻页拿更多评价吗?怎么算钱?
能。每一页最多 10 条(limit 1–10,默认 10),每一页算一次调用,空页不扣费。第 1 页照常调用;响应里有 next_page_token 时,把它原样作为 page_token 传回、其余参数不变(limit 可以改),就拿到下一页。limit 小于 10 时某一页可能少于 limit 条,这不代表到底;到底只看有没有 next_page_token。翻页期间有新评价进来,相邻两页可能重复一两条,合并时按 id 去重。
京东评价接口返回哪些字段?
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。
color 和 size 指什么?
指这条评价对应的商品规格:京东页面上这个 SKU 的颜色(或外观)和尺码、容量等属性值,可以拿来按规格分组。
相关的 京东 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。 - 店铺资料
shop每千次 $28.81店铺资料:返回列表,默认 24 条、单次最多 60 条;主要字段 item_id、url、title、price、currency、shop_id。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页按这一页的条数计费,每 24 条算一次调用;最深 168 条。 - 商品价格
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 不含详情图;商品没有详情图时按空结果退款。