Skip to Content

JD.com product data API

ShopAPIS extracts structured product data from JD.com — China’s leading 1P-plus-marketplace retailer — and returns it as clean JSON. For any JD listing you get title, current and historical price, the full structured spec table, a 1P-vs-3P seller flag, stock by region, warranty terms, rating, review count and the image gallery, without standing up your own China-based scraping infrastructure.

JD.com holds roughly 24% of Chinese domestic e-commerce with an estimated $506B GMV in 2024 (estimate) and ~400M monthly active users, anchored by self-operated logistics (plan2 research). Its first-party model produces cleaner, more structured product and spec data than any C2C peer — the best China source for normalized electronics and appliance attributes.

Why JD.com data is hard to get

JD pairs aggressive anti-bot defenses with client-side rendering. Expect GeeTest-style slider CAPTCHAs, device fingerprinting and Great Firewall (GFW) throttling of non-mainland traffic; prices, stock and specs load from rotating, token-verified endpoints. The JD Open Platform  exists but is gated and seller-scoped — it will not return arbitrary competitor catalogs. ShopAPIS runs in-region with mobile fingerprints and challenge solvers, returning parsed spec tables and price history directly.

Data fields returned

  • Identity — SKU ID, title, brand, category path, model number
  • Price — current price, list price, PLUS-member price, price history, currency (CNY)
  • Specs — structured spec table (key/value attributes), warranty
  • Seller — 1P (JD self-operated 自营) vs 3P flag, shop name, rating
  • Availability — in-stock flag, stock by region/warehouse
  • Reviews — count, rating, positive-rate %, review text
  • Media — image gallery, detail images
  • Logistics — JD Logistics eligibility, delivery estimate

Sample response

{ "platform": "jd", "sku_id": "100012043978", "url": "https://item.jd.com/100012043978.html", "title": "小米电视 65英寸 4K超高清 智能液晶电视", "brand": "Xiaomi / 小米", "model": "L65M7-EA", "category_path": ["家用电器", "电视", "智能电视"], "seller": { "type": "自营", "is_first_party": true, "shop_name": "小米电视京东自营旗舰店", "rating": 4.9 }, "price": { "current": 2799.00, "list": 3299.00, "plus_price": 2699.00, "currency": "CNY" }, "price_history": [{ "date": "2026-05-20", "price": 2999.00 }, { "date": "2026-06-01", "price": 2799.00 }], "specs": { "屏幕尺寸": "65英寸", "分辨率": "4K(3840x2160)", "刷新率": "120Hz", "操作系统": "MIUI for TV" }, "warranty": "整机三年质保", "stock": [{ "region": "北京", "in_stock": true }, { "region": "上海", "in_stock": false }], "reviews": { "count": 204000, "rating": 4.9, "positive_rate": 98 }, "images": ["https://img.jd.com/.../1.jpg"] }

Markets and domains covered

JD.com is China-domestic: domains jd.com and item.jd.com, CNY-priced, Simplified Chinese. JD also runs JD Worldwide for cross-border import listings. ShopAPIS resolves by SKU ID or URL and returns both raw and normalized fields.

Use cases

  • Catalog enrichment — JD’s structured spec tables are ideal for normalizing electronics and appliance attributes (/solutions/catalog-enrichment).
  • Price monitoring — track current, PLUS-member and historical prices (/solutions/price-monitoring).
  • Inventory tracking — monitor regional stock for 1P self-operated SKUs (/solutions/inventory-tracking).
  • Competitive intelligence — compare 1P vs 3P pricing and assortment.

The seller.is_first_party flag distinguishes JD self-operated (自营) listings from third-party marketplace sellers — essential for accurate price and warranty comparison.

Last updated on