JD.com+API.SH

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
JD.com product details
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}
1 credit · $1 per 1,000 calls

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.

sku100066896338urlhttps://item.jd.com/100066896338…titleApple/苹果/苹果 iPhone 15 (A3092) 25…short_title苹果 15 256GB 黑色brand苹果brand_id14026modeliPhone15spu_id100066896214price_shown5??9price_noteJD masks the price for visitors …color黑色size256GBspec公开版stock_state34weight0.300kgupc195949034800warranty1年质保origin中国大陆
shop[]id · name · vendor_id · url · self_operated
dimensions_mm[]length · width · height

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

Products, listings and places1
JD.com product details
/jd/v1/product
params iddocstry
$1 · $2 PAYG
1 credit

Call the JD.com API

JD.com product details: GET https://api.api.sh/jd/v1/product

curl "https://api.api.sh/jd/v1/product?id=100066896338" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More e-commerce APIs all e-commerce APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key