# 京东 JD.com 评价 API (jd.reviews)

- Canonical page: [https://everyinfra.com/jd-api/reviews](https://everyinfra.com/jd-api/reviews?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "jd", "action": "reviews", "params": {...}}
- Price: $0.008 per call ($8 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 10, max 10 per call
- Pagination: pass next_page_token back as page_token for the next page, other params unchanged; one call per page, tokens last 24 hours
- Mode: sync; add "mode": "async" for slow tasks

京东评价接口按 `item_id` 读取一件商品的公开评价，每条带正文、买家追加评价、评分、发布时间、购买的颜色和尺码、评价人昵称、是否 PLUS 会员和购买次数。它回答「买过的人怎么说」，适合做口碑分析、差评原因归类，以及对比竞品在细节上的优劣。

`review_append` 是买家在首评之后追加的内容，往往比首评更能说明耐用性和售后问题，值得单独分析。评价人昵称按京东页面原样返回，可能已部分打码，不能用来识别个人。比较评分前先看同一行的 `rating_scale`。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=jd&action=reviews

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| item_id | not declared | yes | not declared | 京东商品数字 ID，或不带 query/fragment 的 https://item.jd.com/<数字>.html；返回最多 10 条公开评价。 |
| page_token | not declared | no | not declared | 翻页令牌。第 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 | integer (1–10) | no | 10 | 这次调用最多返回的条数，整数，1–10；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| 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 | platform-native meaning |
| 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 条，到底只看有没有这个字段。 |

## Example

```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": "reviews",
  "params": {
    "item_id": "100012043978"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "jd",
        "action": "reviews",
        "params": {
            "item_id": "100012043978",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-11-07T14:47:42Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "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": { … }
}
```

## FAQ

### 追评有什么用？

`review_append` 是买家在首次评价之后追加的内容，常常写到用了一段时间后的体验，比如耐用性、质量问题和售后。把它和首评分开分析，能看出短期满意和长期满意的差别。

### 评价人的信息能拿到多少？

能拿到页面公开显示的昵称、头像、是否 PLUS 会员和购买次数，昵称可能已被京东部分打码。这些信息适合分析买家结构，不能用来识别具体的人。

### 能翻页拿更多评价吗？怎么算钱？

能。每一页最多 10 条（`limit` 1–10，默认 10），每一页算一次调用，空页不扣费。第 1 页照常调用；响应里有 `next_page_token` 时，把它原样作为 `page_token` 传回、其余参数不变（`limit` 可以改），就拿到下一页。`limit` 小于 10 时某一页可能少于 `limit` 条，这不代表到底；到底只看有没有 `next_page_token`。翻页期间有新评价进来，相邻两页可能重复一两条，合并时按 `id` 去重。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=jd
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
