# JD.com Product details API (jd.product_detail)

- Canonical page: [https://everyinfra.com/en/jd-api/product_detail](https://everyinfra.com/en/jd-api/product_detail?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "jd", "action": "product_detail", "params": {...}}
- Price: $0.002444 per call ($2.44 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

JD.com Product details reads one JD product by `item_id`: title, brand and model, price and original price, availability, stock state, every product image, variants, barcode, origin and warranty text, plus the shop, whether JD sells it directly and whether JD Logistics delivers it. Use it to see what a product costs right now, whether it can be bought and who ships it, for price monitoring, competitor spec sheets and catalog enrichment.

Pass a numeric product ID or a plain item.jd.com product page link without query or fragment; newer opaque product links are not accepted. Before reading the price, check `price_masked`: JD hides prices behind sign-in or membership conditions, and when it is true `price_display` is not a precise selling price. `available` and `unavailable_reason` say whether the product can be bought now.

## Health

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

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

## Response fields (items in `results`)

| 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. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| price | Price as a number without a currency symbol; see currency. |
| price_display | Price string exactly as shown on the JD page; may be masked by login or membership conditions. |
| price_masked | Whether JD masked the price on the detail page. When true, do not treat price_display as the exact transaction price. |
| 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. |
| shop_id | JD numeric shop ID. |
| shop_name | Public shop name. |
| shop_url | Public JD shop page. |
| category_id | JD leaf category ID of the product (product_detail). |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| stock | Stock quantity JD shows publicly; null means the page did not give one, not zero. |
| stock_state | Public JD stock status code. |
| 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. |
| weight | Product weight as written on the JD page (product_detail); null when the page gives none. |
| image_url | Image URL: in search, product_detail, shop and skus it is the product's main (cover) image; in description_images it is the description image of that row (the full-size https image on JD's image host). |
| image_urls | Product gallery image URLs (cover included, in the order shown on the JD page). The singular image_url is the first of them. The long images in the product's description section are not here; get them with description_images. |
| is_jd_self | Whether this is a JD self-operated (JD.com retail) product. |
| brand | Product brand. |
| model | Product model number. |
| original_price | List (original) price shown by JD; may differ from the promotional price. null when the page does not provide one. |
| upc | Product barcode (UPC/EAN). null when the page does not provide one. |
| warranty | Warranty terms, as written on the page. |
| product_area | Place of origin. |
| is_jd_express | Whether the item ships via JD Logistics. |
| variant_count | Number of variants (SKUs). null when there are none or it is not provided. Every skus row carries the same value: when it is larger than the number of rows returned, limit cut the list short or some SKUs were not retrieved this time. |
| variants | Variant list. Each entry carries name, SKU ID, price, stock, stock state, and image URL where available; null when there are none or it is not provided. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## 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": "product_detail",
  "params": {
    "item_id": "https://item.jd.com/100012043978.html"
  }
}'
```

```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": "product_detail",
        "params": {
            "item_id": "https://item.jd.com/100012043978.html",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "jd",
  "action": "product_detail",
  "results": {
    "item_id": "100012043978",
    "url": "https://item.jd.com/100012043978.html",
    "title": "茅台飞天 53%vol 500ml 贵州茅台酒（带杯）【需预约购买】",
    "price": 1041,
    "price_display": "1??9",
    "currency": "CNY",
    "available": false,
    "shop_id": "1000475228",
    "shop_name": "贵州茅台",
    "shop_url": "https://mall.jd.com/index-1000475228.html",
    "category_id": "9435",
    "stock": 156,
    "stock_state": "out_of_stock",
    "color": "1759(需预约)",
    "size": "单瓶装",
    "weight": "1.1kg",
    "image_url": "https://img14.360buyimg.com/n1/jfs/t1/498128/6/14354/78100/6a8678aeFd76e6a0c/008332032059c4fa.jpg",
    "image_urls": [
      "https://img14.360buyimg.com/n1/jfs/t1/498128/6/14354/78100/6a8678aeFd76e6a0c/008332032059c4fa.jpg",
      "https://img14.360buyimg.com/n1/jfs/t1/442358/22/5618/62044/6a17b873F63dd4c14/00833203206f6884.jpg",
      "https://img14.360buyimg.com/n1/jfs/t1/538344/32/1045/88182/6aba0a86F8862dac1/00833203209ef461.jpg"
    ],
    "brand": "茅台",
    "model": "白酒",
    "original_price": 1041,
    "upc": "•••;•••",
    "warranty": "无质保",
    "product_area": "贵州仁怀",
    "is_jd_express": false,
    "variant_count": 9,
    "variants": [
      {
        "sku_id": "100278756721",
        "image_url": "https://img14.360buyimg.com/n1/jfs/t1/442358/22/5618/62044/6a17b873F63dd4c14/00833203206f6884.jpg"
      },
      {
        "sku_id": "100153291833",
        "image_url": "https://img14.360buyimg.com/n1/jfs/t1/538344/32/1045/88182/6aba0a86F8862dac1/00833203209ef461.jpg"
      },
      {
        "sku_id": "100371797016",
        "image_url": "https://img14.360buyimg.com/n1/jfs/t1/545564/17/1981/187886/6accddbdFb7d949e4/0083320320d24f2b.png"
      }
    ],
    "platform": "jd"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Which formats does `item_id` accept?

A numeric JD product ID, or https://item.jd.com/<number>.html with no query string or fragment. Newer opaque links under /product/ are not accepted. The `item_id` from JD search results works as is.

### Why is the price sometimes hidden?

JD masks product page prices behind sign-in or membership conditions. When `price_masked` is true, `price_display` is the text the page shows rather than a precise selling price, so flag those rows separately when you track prices.

### How do I tell if a product is unavailable?

Read `available`, the current sale status; when the product cannot be bought, `unavailable_reason` gives the reason shown on JD. `stock_state` is JD's public stock status code, worth storing alongside if you track availability over time.

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