+JD.com API
Look up any JD.com (京东) product and get its title, brand, images, variants, shop and stock as JSON.
The API.SH JD.com API turns a public JD.com (京东) product page into structured JSON. Pass a SKU id or an item.jd.com link and get the title, brand, model, category ids, images, colour, size and spec, every variant with its SKU and image, the shop and whether JD runs it, stock state and delivery promise, weight, dimensions, UPC, warranty, origin and launch date. JD shows the exact price only to signed-in shoppers; the price is returned as JD displays it to everyone else, with masked digits.
- 1 endpoint
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/jd/v1/ product
{"sku": "100066896338","url": "https://item.jd.com/100066896338.html","title": "Apple/苹果/苹果 iPhone 15 (A3092) 256GB 黑色 支持移动联通电信5G 双卡双待","short_title": "苹果 15 256GB 黑色","brand": "苹果","brand_id": "14026","model": "iPhone15","category_ids": ["9987","653","… 1 more"],"spu_id": "100066896214","price_shown": "5??9","price_note": "JD masks the price for visitors who are not signed in","images": ["https://img14.360buyimg.com/n0/jfs/t1/267705/1/12707/18510/6788b9a1F81485818/10849a144f1ab085.jpg","https://img14.360buyimg.com/n0/jfs/t1/228715/33/23218/6631/668bc3c1F5d01f221/9cd925a54dc2f7e3.jpg","… 1 more"],"color": "黑色","size": "256GB","spec": "公开版","variant_options": [],"variants": [],"shop": {"id": 1000000127,"name": "Apple产品京东自营旗舰店","vendor_id": 1000000127,"url": "https://shop.m.jd.com/shop/home?shopld=1000000127","self_operated": true},"stock_state": 34,"delivery_promise": null,"shipping_note": null,"weight": "0.300kg","dimensions_mm": {"length": 160,"width": 89,"height": 29},"upc": "195949034800","warranty": "1年质保","origin": "中国大陆","launch_date": "2026-08-27 09:55:24","status": "0","cached": false,"credits_used": 1} What you can build with the JD.com API
Product catalog enrichment
Fill product records with JD titles, brands, images, UPCs and specs from a SKU or link.
Variant and SKU mapping
Map a product's colours, sizes and specs to their JD SKUs and images for cross-listing or matching.
Stock and delivery checks
Check a SKU's stock state and delivery promise on a schedule for supply and availability monitoring.
Brand and seller research
See which shop sells a product and whether it is JD self-operated, to track official stores and resellers.
JD.com data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
JD.com API endpoints and prices
Every JD.com endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| JD.com product details /jd/ | $1 · $2 PAYG 1 credit |
Call the JD.com API
JD.com product details: GET https://api.api.sh/jd/
curl "https://api.api.sh/jd/v1/product?id=100066896338" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/jd/v1/product",
params={"id": "100066896338"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/jd/v1/product");
url.searchParams.set("id", "100066896338");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/jd/v1/product", "id", "100066896338")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "JD.com" and "JD.com product details".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for JD.com data
- Public data only: no JD.com login, cookies or account needed
- One key and one response shape for JD.com and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official JD.com API
JD's open platform (jos.jd.com, 宙斯开发者中心) provides APIs for merchants, affiliates and service providers, with an approved developer account and app keys; it is in Chinese and tied to your own store or affiliate program. API.SH needs no JD developer account and returns public product data in English-keyed JSON.
Instead of writing and maintaining a JD.com scraper for a Chinese site, call API.SH with one key and get the same JSON conventions as our other e-commerce platforms.
JD.com API questions
What JD.com data can I get?+
Product details for a SKU or item.jd.com link (/jd/v1/product): title, brand, model, category ids, images, variants with SKUs, shop, self-operated flag, stock state, delivery promise, weight, dimensions, UPC, warranty, origin and launch date.
How much does the JD.com API cost?+
Every JD.com endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free trial?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /jd/v1/product at 1 credit each.
Is there an official JD.com API?+
Yes: the JD open platform (jos.jd.com) serves merchants, affiliates and service providers who register an app. API.SH is for reading public product data without a JD developer account.
Do I need a JD account or login?+
No. API.SH reads public JD pages only, as a visitor who is not signed in. For that reason JD shows the price with masked digits, and the API returns it as shown.
Why is the price masked?+
JD hides exact prices from visitors who are not signed in and shows digits like 5??9. API.SH never signs in to anyone's account, so price_shown is what any visitor sees.
Can I use it from Python?+
Yes. Call /jd/v1/product with requests, httpx or our Python SDK and read the JSON; field names are in English and text stays in the original Chinese.
How do I get started?+
1. Sign up at api.sh. 2. Copy your API key. 3. Call /jd/v1/product with a SKU id such as one from an item.jd.com link. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.
Does the JD.com API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many JD.com calls in parallel as you need and pay only for the calls that run. If JD.com itself slows down, the call returns 503 with a retry-after header and is not charged.