# JD.com Reviews API (jd.reviews)

- Canonical page: [https://everyinfra.com/en/jd-api/reviews](https://everyinfra.com/en/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

JD.com Reviews reads the public reviews of one product by `item_id`. Each row carries the review text, any follow-up review the buyer added later, the rating, publish time, the color and size bought, the reviewer's nickname, whether they are a PLUS member and how many times they bought. Use it to hear what buyers say: reputation analysis, sorting complaints by cause, or comparing a competitor's product on the details.

`review_append` holds the follow-up review a buyer posts after the first one, which often speaks to durability and after-sales service better than the first impression, so analyze it separately. Nicknames come back exactly as JD shows them and may be partly masked; they cannot identify a person. Check `rating_scale` on the same row before comparing ratings.

## 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 | Identifies one JD.com product for `product_detail`, `reviews`, or `product_price`. Pass the digit string returned by `search` or the canonical legacy URL `https://item.jd.com/<digits>.html` without a query or fragment; arbitrary, opaque, or cross-host URLs are not accepted as equivalent item identifiers. |
| page_token | not declared | no | not declared | Page token. Leave it out for the first page. When the response has a `next_page_token`, pass it back as `page_token`, exactly as received, to get the next page, with the other parameters unchanged (`limit` can change). A token is valid for 24 hours and works only for the same product and the same account; a token used with another product is rejected with 422 and not charged. No `next_page_token` (or `pagination.has_more` false) means you have reached the end. Each page holds at most 10 reviews and is one call; an empty page is not charged. With `limit` below 10, the next page first returns what the previous page left over, so a page can hold fewer than `limit` reviews. That does not mean the end: only a missing `next_page_token` does. If new reviews arrive while you page, neighbouring pages can repeat a review or two, so dedupe by review `id` when merging. JD reviews cannot jump to a page number; page forward one page at a time with `next_page_token`. |
| limit | integer (1–10) | no | 10 | The most rows to return in this call, an integer from 1 to 10. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| item_id | JD numeric product ID. From search results you can pass it straight to detail, reviews, or price calls. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| review_append | Buyer's follow-up (appended) review text. |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| color | This SKU's color (or finish) as shown on the JD page. |
| size | This SKU's size, capacity or specification value as shown on the JD page. |
| useful_count | platform-native meaning |
| images | Array of image links in the platform's display order; absent when there are no images. |
| author_name | Reviewer nickname, returned as JD shows it (JD may already partially mask it). |
| author_avatar_url | Reviewer avatar URL. |
| author_is_plus | Whether the reviewer is a JD PLUS member. |
| buy_count | How many times the reviewer bought this item, as the page shows ('purchased N times'). |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| next_page_token | Page token: pass it back unchanged as `page_token`, with the other parameters the same, to fetch the next page; valid for 24 hours and only for the same product. Every row of a page carries the same value, which also appears at the top level of the response. Absent on the last page; with `limit` below 10 a page can hold fewer than `limit` reviews, so only this field's absence marks the end. |

## 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

### What is a follow-up review good for?

`review_append` is what a buyer added after the first review, often after using the product for a while: durability, defects, after-sales service. Analyzing it apart from the first review separates short-term from long-term satisfaction.

### How much do I learn about each reviewer?

What the page shows publicly: nickname, avatar, PLUS membership and how many times they bought the product. JD may partly mask nicknames. Use this to understand the buyer mix, not to identify individuals.

### Can I page through more reviews, and how is it billed?

Yes. Each page holds up to 10 reviews (`limit` 1–10, default 10) and is one call; an empty page is not charged. Call as usual for the first page, then pass the response's `next_page_token` back unchanged as `page_token`, keeping the other parameters the same (`limit` can change). With `limit` below 10, a page can hold fewer than `limit` reviews without being the last; only a missing `next_page_token` marks the end. If new reviews arrive while you page, neighbouring pages can share a review or two, so dedupe by `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
