JD.com Reviews API

Read the public reviews of one JD.com product by item_id, with text, review_append, rating, rating_scale, posted_at, color, size and useful_count on each row, for $8 per 1,000 calls.

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.

  • Each page holds up to 10 reviews; follow next_page_token for more.
  • images carries the links to the photos in a review.
  • Each page counts as one call. Failed calls and empty results are not charged.

API health

24h health
27%
24h average time
42.84 s
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Mostly down

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "jd",
      "action": "reviews",
      "params": {
        "item_id": "100012043978"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "author_name": "j•••℡",
          "item_id": "100012043978",
          "text": "物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试",
          "rating": 5
        },
        …
      ],
      "count": 10
    }
  3. 3Rows

    author_nameitem_idtextrating
    j•••℡100012043978物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试5
    陈•••7100012043978东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验5
  4. 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

A request with item_id goes in, and one page of public reviews comes back; each row in results is one review, listed as a field table and a CSV file.

What data you get

The table shows a real call for 100012043978, captured November 7, 2026 at 14:47 (UTC), that returned 10 rows; gray bars mark the removed review IDs, reviewer nicknames and avatar links (••• in the CSV). Your own calls return these fields as listed in the field reference.

iditem_idtextreview_appendratingrating_scaleposted_atcolorsizeuseful_countimagesauthor_nameauthor_avatar_urlauthor_is_plusbuy_countplatformnext_page_token
100012043978物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试null552026-11-07 14:34:451699(需预约)单瓶装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•••℡false11jdnull
100012043978东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验null552026-11-05 18:31:461699(需预约)单瓶装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"]陈•••7false3jdnull

Use cases

  • Sort complaints by cause

    Take the reviews with a low rating, read text and review_append, and group the complaints.

  • Compare feedback by variant

    Group by color and size to see how reviews differ between variants.

  • Spot-check review photos

    images holds the links to buyers' photos, which you can check against the product page.

  • See when reviews cluster

    After a few pages, count rows by posted_at to see which dates the new reviews fall on.

JD Help Center: review and photo rules vs EveryInfra

Here is how the JD Help Center rules for reviews and photos and EveryInfra reviews compare on follow-up reviews, how nicknames show and which reviews are displayed.

ComparedJD Help Center: review and photo rulesEveryInfra
Follow-up reviewA customer can post a first review with photos within 60 days after the order completes, review the service within 90 days, and add a follow-up review within 180 days (some special categories excepted).review_append holds the follow-up text a buyer added; it comes back apart from text, the first review.
How nicknames showTo protect user privacy, the review section of the product page shows user nicknames with asterisks in place of some characters.author_name comes back exactly as the JD page shows it; JD may have masked part of it.
Which reviews showJD reviews review and photo content, and only content that follows the rules and passes review is shown to other users.reviews reads the reviews shown publicly on the product page. One page is only a part of them, not the full set of reviews for the product.

The JD Help Center documentation is in Chinese. The table shows a translation, checked against the page on 2026-11-22; the page shows no update date. The page is a rules notice for buyers, not an interface document for reading reviews. Official sources: Review and photo rules (JD Help Center)

Limits and gotchas

  • item_id is required: a numeric JD product ID, or https://item.jd.com/<number>.html with no query string or fragment.
  • You can only page forward with next_page_token; JD reviews cannot be read by page number. A response with no next_page_token (pagination.has_more is false) is the end.
  • 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 merge by review id.
  • Read rating_scale on the same row before you compare ratings; it is the maximum of rating.

Pricing

Each page counts as one call at $0.008, not per review; an empty page is not charged. Failed calls and empty results are not charged.

CallsCost
10,000$80.00
100,000$800.00
1,000,000$8,000.00

Totals use the list price per call.

Code samples

#
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"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for reviews, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra JD.com Reviews endpoint (jd/reviews).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to jd and action to reviews, and put the parameters inside params.
- Required parameters:
  - item_id: 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.
- Optional parameters:
  - page_token: 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).
  - limit: 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. (default: 10)
- Returns a list of records. Main fields of each record: id, item_id (JD numeric product ID), text, review_append (Buyer's follow-up (appended) review tex…), rating, rating_scale, posted_at, color (This SKU's color (or finish) as shown o…), size (This SKU's size, capacity or specificat…), useful_count, images, author_name (Reviewer nickname, returned as JD shows…); 16 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=jd.
- Example request body:
{
  "platform": "jd",
  "action": "reviews",
  "params": {
    "item_id": "100012043978"
  }
}
- Price: $8 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesjdPlatform identifier, fixed value.
actionbodystringYesreviewsCapability identifier, fixed value.
item_idbody.paramsstringYes-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_tokenbody.paramsstringNo-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.
limitbody.paramsinteger (1–10)No10The 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 example

#
Captured November 7, 2026 at 14:47 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "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": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
item_idJD numeric product ID. From search results you can pass it straight to detail, reviews, or price calls.
textBody 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_appendBuyer's follow-up (appended) review text.
ratingRating. 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_scaleMaximum 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_atPublish 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.
colorThis SKU's color (or finish) as shown on the JD page.
sizeThis SKU's size, capacity or specification value as shown on the JD page.
useful_countKeeps the platform's own meaning
imagesArray of image links in the platform's display order; absent when there are no images.
author_nameReviewer nickname, returned as JD shows it (JD may already partially mask it).
author_avatar_urlReviewer avatar URL.
author_is_plusWhether the reviewer is a JD PLUS member.
buy_countHow many times the reviewer bought this item, as the page shows ('purchased N times').
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
next_page_tokenPage 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.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

Official references

#

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

  • JD.com: Review and Photo-posting Rules ↗

    JD.com distinguishes reviews, follow-up reviews, images, replies, moderation, folded content, and masked nicknames. Public visibility can depend on review and privacy rules, so a returned set must not be described as the complete review history or as permission to redistribute reviewer content.

    Checked 2026-09-11

  • JD.com User Service Agreement (Effective January 20, 2026): Public Reviews and Access Boundaries ↗

    The JD.com User Service Agreement says review information is public and JD.com may use it under the agreement. It also says personal information generally is not disclosed to third parties without permission and prohibits stealing personal information or infringing lawful rights. This supports access and permission boundaries only; it does not grant EveryInfra or callers rights to redistribute, train on, or commercially reuse text, images, or user information.

    Checked 2026-09-11

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.

Which fields does the JD reviews API return?

id, item_id, text, review_append, rating, rating_scale, posted_at, color, size, useful_count, images, author_name, author_avatar_url, author_is_plus and buy_count.

What do color and size mean on a review?

They are the variant the review belongs to: the color (or look) and the size, capacity or similar value of that SKU on the JD page. Use them to group reviews by variant.

You can call the other JD.com endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy