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_tokenfor more. imagescarries 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
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "jd", "action": "reviews", "params": { "item_id": "100012043978" } }2JSON response
{ "results": [ { "author_name": "j•••℡", "item_id": "100012043978", "text": "物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试", "rating": 5 }, … ], "count": 10 }3Rows
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 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.
| 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 |
Use cases
Sort complaints by cause
Take the reviews with a low
rating, readtextandreview_append, and group the complaints.Compare feedback by variant
Group by
colorandsizeto see how reviews differ between variants.Spot-check review photos
imagesholds 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_atto 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.
| Compared | JD Help Center: review and photo rules | EveryInfra |
|---|---|---|
| Follow-up review | A 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 show | To 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 show | JD 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_idis 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 nonext_page_token(pagination.has_moreis false) is the end. - With
limitbelow 10, a page can hold fewer thanlimitreviews without being the last; only a missingnext_page_tokenmarks the end. - If new reviews arrive while you page, neighbouring pages can share a review or two, so merge by review
id. - Read
rating_scaleon the same row before you compare ratings; it is the maximum ofrating.
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.
| Calls | Cost |
|---|---|
| 10,000 | $80.00 |
| 100,000 | $800.00 |
| 1,000,000 | $8,000.00 |
Totals use the list price per call.
Code samples
#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.
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
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | jd | Platform identifier, fixed value. |
action | body | string | Yes | reviews | Capability identifier, fixed value. |
item_id | body.params | string | Yes | - | 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 | body.params | string | No | - | 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 | body.params | 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 example
#{ "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.
| 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 | Keeps the platform's own 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. |
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.
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.
Related JD.com endpoints
You can call the other JD.com endpoints with the same EveryInfra API key.
- Search
search$2.47 per 1,000 callsLook up JD.com products for a search phrase and get up to five results. - Product details
product_detail$2.44 per 1,000 callsGet the full JD.com product record for oneitem_id. - Shop
shop$28.81 per 1,000 callsBrowse up to 24 products from one JD.com store, each with item ID, title, price, currency and availability. - Product price
product_price$5.56 per 1,000 callsCheck the current displayed price and availability of one JD.com product byitem_id. - All SKUs with prices
skus$2.44 per 1,000 callsList every SKU of a JD.com product from any one of its SKUs initem_id. - Description images
description_images$8 per 1,000 callsGet every image in the description section of a JD.com product, top to bottom.