JD.com Product price API
Read the current price of one JD.com product by item_id, together with currency, available and, when it cannot be bought, unavailable_reason, for $5.56 per 1,000 calls.
- It returns the price and the sale status only, not the product record.
- One call reads one product, which suits polling prices by
item_id. - Failed calls and empty results are not charged.
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "jd", "action": "product_price", "params": { "item_id": "100012043978" } }2JSON response
{ "results": { "item_id": "100012043978", "price": 1699, "currency": "CNY", "available": true, … } }3Fields
item_id price currency available 100012043978 1699 CNY true 4CSV
jd-product_price-sample.csv item_id,url,price,currency,available,unavailable_reason,platform
item_id goes in, and one JSON object with only the price and sale status comes back, 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 one object. Your own calls return these fields as listed in the field reference.
| item_id | url | price | currency | available | unavailable_reason | platform |
|---|---|---|---|---|---|---|
| 100012043978 | https://item.jd.com/100012043978.html | 1699 | CNY | true | null | jd |
Use cases
Price tracking
Read
pricebyitem_idon a schedule and store it as a price series.Clean a product list
Read every
item_idon your list and drop the products whereavailableisfalse.Spot-check search prices
Compare the
pricefromsearchorshopwith thepriceread here.
JD Help Center: price tag explanation vs EveryInfra
Here is how the JD Help Center price tag explanation and EveryInfra product_price compare on which buyer-status prices the page price leaves out.
| Compared | JD Help Center: price tag explanation | EveryInfra |
|---|---|---|
| Prices left out | The live price on the product page does not include prices tied to a special buyer status, such as Plus, student, enterprise, new-user, Sam's, fan or shop-member prices. | price is the price visible at capture time; it may not include member, new-user, regional or targeted-coupon offers, or offers applied at checkout. |
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 explains prices to buyers; it is not an interface document for reading prices. Official sources: Price tag explanation
Limits and gotchas
item_idis required: a numeric JD product ID, or https://item.jd.com/<number>.html with no query string or fragment.- It returns the price and the sale status only; for the title, shop and stock, use
product_detail. pricehas no currency symbol, so read it withcurrency; whenpricehas a value andcurrencyisnull, do not assume a currency.unavailable_reasonappears only when the product cannot be bought, and it is the reason JD shows publicly.
Pricing
You pay $0.005556 per call, and one call reads one product. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $55.56 |
| 100,000 | $555.56 |
| 1,000,000 | $5,555.56 |
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": "product_price",
"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 product_price, 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 Product price endpoint (jd/product_price).
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 product_price, 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.
- Returns one object. Main fields: item_id (JD numeric product ID), url, price, currency, available (Whether the item could be bought when i…), unavailable_reason (Public reason JD shows when an item is…).
- Example request body:
{
"platform": "jd",
"action": "product_price",
"params": {
"item_id": "100012043978"
}
}
- Price: $5.56 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 | product_price | 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. |
Response example
#{ "id": "req_…", "platform": "jd", "action": "product_price", "results": { "item_id": "100012043978", "url": "https://item.jd.com/100012043978.html", "price": 1699, "currency": "CNY", "available": true, "platform": "jd" }, "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 |
|---|---|
item_id | JD numeric product ID. From search results you can pass it straight to detail, reviews, or price calls. |
url | Link to the record on the platform. |
price | Price as a number without a currency symbol; see currency. |
currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
available | Whether the item could be bought when it was read (product_detail, product_price and shop rows); false when out of stock, null when the page did not say. |
unavailable_reason | Public reason JD shows when an item is not sellable. |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
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: Displayed-price Labels and Conditional Purchase Prices ↗
JD.com distinguishes a real-time displayed label from final item prices and member, new-user, regional, or targeted benefits, while noting that some comparison information can be delayed or incomplete. Treat a returned price as the visible request-time snapshot, not a personal transaction price, settlement amount, or guarantee of absolute accuracy.
Checked 2026-09-11
FAQ
Which fields does the JD product price API return?
item_id, url, price, currency and available, plus unavailable_reason when the product cannot be bought.
Are price_display and price_masked here?
No. To see whether JD masks the price of a product, use product_detail.
How much does one price read cost?
It costs $0.005556 per call, or $5.56 per 1,000 calls. Failed calls and empty results are not charged.
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. - Reviews
reviews$8 per 1,000 callsRead up to 10 buyer reviews of a JD.com product per call, and page through for more. - 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. - 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.