JD.com Scraper — Product Detail & Seller Store Data

Extract public product and seller data from JD.com (京东 / Jingdong) — China's #2 e-commerce platform with ~600M annual active users and the dominant non-marketplace direct-retail model. Two production-ready modes: full product detail (with real-time price, JD-self-run flag, and decoded service tags) and seller store metadata (with store type and trust scores). No login. No CAPTCHA. Built for competitive pricing intelligence, brand authorization audit, gray-market detection, and JD-self-run vs marketplace tracking.

Part of the Chinese Digital Intelligence Suite by zhorex — pairs natively with the Weibo, RedNote, Bilibili, Xueqiu, and Douban scrapers for full-stack China data coverage.

---

What it scrapes

Mode	Returns	Best for
product_detail	Full product page — title, brand, category breadcrumb, specs, all images, real-time price, stock status, JD-self-run flag, service tags (7-day return, JD Plus, warranty)	Single-product enrichment, watchlist refresh, real-time price tracking
seller_store	Seller / shop metadata — store type (flagship / franchise / specialty / self-run), establishment date, service & logistics scores, popular products	Gray-market detection, supplier vetting, brand authorization audit

---

What you get

product_detail — every field a competitive-intel team needs

For each JD product URL or SKU ID you submit, you get one record with:

• Identifiers: productId, productUrl, brandName, categoryPath (full breadcrumb)
• Specs — the full JD specs panel as a {key: value} dict (商品名称, 商品编号, 上架时间, dimensions, color options, etc.)
• Images — primaryImageUrl plus full descriptionImages array for catalog ingestion
• Pricing — realtimePrice queried fresh at scrape time (not stale page-load price)
• Seller — sellerId, sellerName, isJdSelfRun flag (true = JD's own warehouse + warranty + return logistics, false = third-party merchant)
• Stock — stockStatus enum (in_stock / low_stock / out_of_stock), best-effort stockCount
• Service tags — JD's protection options decoded to human-readable English: 7-day return, 30-day price protection, JD Plus exclusive, extended warranty, cash on delivery
• Origin — shippingCity (defaults to Beijing — JD ships from its central warehouses)
• Timestamp — scrapedAt UTC ISO 8601

seller_store — brand authorization in one call

For each JD seller URL or shop ID:

• Identity — sellerId, sellerName, sellerUrl
• Type — sellerType enum: flagship_store (官方旗舰店), franchise_store (品牌专营店), specialty_store (专卖店), or jd_self_run (京东自营). This is the key field for gray-market detection.
• Trust — serviceScore, logisticsScore, descriptionAccuracyScore (0-5 each, JD's official seller ratings)
• Tenure — establishedDate, productCountTotal
• Catalog — popularProducts (top items by sales)

---

Why this Actor, not a generic e-commerce scraper

• isJdSelfRun flag — JD's hybrid model means each SKU is either fulfilled by JD itself (own logistics, warranty, return path) or by a third-party merchant on the marketplace. Generic scrapers don't distinguish. This Actor surfaces the flag on every record.
• Service tag decoding — JD's protection options arrive as opaque numeric codes; this Actor maps them to human-readable English tags so downstream pipelines don't have to maintain the code table.
• Real-time price — realtimePrice is fetched fresh at scrape time, not parsed from cached HTML, so it captures flash-discount cycles that move within hours.
• Seller type as commerce signal — sellerType decoded to flagship_store / franchise_store / specialty_store / jd_self_run is the cleanest single field for gray-market and unauthorized-reseller detection on Chinese e-commerce.

---

Example inputs

product_detail

{
    "mode": "product_detail",
    "productUrls": [
        "https://item.jd.com/100009082476.html",
        "100012345678"
    ]
}

(The Actor accepts mixed URLs and bare SKU IDs.)

seller_store

{
    "mode": "seller_store",
    "sellerUrls": [
        "https://mall.jd.com/index-1000003566.html",
        "1000003566"
    ]
}

---

Example outputs (truncated)

Product detail

{
    "mode": "product_detail",
    "productId": "100009082476",
    "productTitle": "...",
    "brandName": "Apple",
    "categoryPath": ["手机通讯", "手机", "Apple"],
    "specs": {"商品名称": "Apple iPhone 17 Pro", "上架时间": "2026-09-22"},
    "realtimePrice": "9999.00",
    "isJdSelfRun": true,
    "stockStatus": "in_stock",
    "serviceTags": ["7-day return", "JD Plus exclusive"],
    "primaryImageUrl": "https://...",
    "scrapedAt": "2026-05-15T10:00:00+00:00"
}

Seller store

{
    "mode": "seller_store",
    "sellerId": "1000003566",
    "sellerName": "Apple产品京东自营旗舰店",
    "sellerType": "flagship_store",
    "establishedDate": "2014-09-25",
    "serviceScore": 4.9,
    "logisticsScore": 4.8,
    "descriptionAccuracyScore": 4.9,
    "popularProducts": [{"productId": "...", "title": "...", "price": "..."}],
    "sellerUrl": "https://mall.jd.com/index-1000003566.html",
    "scrapedAt": "2026-05-15T10:00:00+00:00"
}

---

Pricing (Pay-Per-Event)

Event	Mode	Price
product-detail-scraped	product_detail	$0.008 / product
seller-scraped	seller_store	$0.02 / seller

Realistic workflow costs

Workflow	Volume	Cost
Watchlist refresh — 200 SKUs daily	6,000 details / month	~$48 / month
Competitor pricing intel — 50 SKUs hourly	36,000 details / month	~$288 / month
Brand authorization audit	500 sellers	$10
Gray-market sweep — 200 SKUs + 50 sellers	200 details + 50 sellers	$2.60

---

Recommended proxy

The Actor's input schema defaults to Apify residential proxy with apifyProxyCountry: "CN" — recommended for both modes. Datacenter IPs may be rate-limited by JD; residential IPs from Mainland China (or Hong Kong / Singapore as alternatives) work reliably. Apify's residential proxy is billed separately from the per-event price.

---

Use cases

1. Watchlist refresh — submit a list of competitor SKU URLs; get the current price, stock, seller, and JD-self-run flag in a single batch. Daily cron-friendly.
2. Real-time competitor pricing — realtimePrice is fetched fresh on every run, capturing flash-sale and limited-time discount cycles.
3. Brand authorization audit — combine product_detail (which sellers list your brand's SKUs?) with seller_store (what type of store is each?) to flag unauthorized resellers operating outside your flagship channel.
4. Gray-market detection — when a "specialty_store" prices a flagship SKU 20-40% below MSRP, that's a gray-market signal worth alerting on.
5. JD-self-run vs marketplace allocation tracking — quarterly snapshots of which of your SKUs migrated to JD's direct retail model versus marketplace fulfillment.
6. Cross-platform brand intelligence — combine with the sister Chinese-platform scrapers (Weibo for sentiment, RedNote for lifestyle, Bilibili for video reviews) for full coverage of the same brand across the China digital stack.

---

Known limitations

• No login mode. All scraping is anonymous; private orders, wishlist, cart, member-only price tiers (e.g., JD Plus member-exclusive discounts), and account-bound coupons are not accessible.
• No flash-sale (秒杀) real-time inventory. Flash-sale stock is served by a separate channel not implemented in this Actor.
• No JD International (jd.hk). This Actor targets Mainland JD only.
• No B2B (1688.com). Alibaba's wholesale platform is a separate project.
• No order placement / cart simulation. Read-only by design.
• No search discovery or review scraping. This Actor is scoped to product detail enrichment + seller metadata. If you need to discover new SKUs by keyword, bring an external URL list (or use one of the many JD search scrapers on Apify).

---

Part of the Chinese Digital Intelligence Suite

Actor	What it covers
Weibo Scraper	Broad public sentiment, hot search trending, KOL posts
RedNote (Xiaohongshu) Scraper	Lifestyle / consumer brand discovery and reviews
Bilibili Scraper	Video platform comments and creator data
Xueqiu Scraper	Chinese stock-cashtag discussion & sentiment
Douban Scraper	Film / book / music long-form reviews
JD.com Scraper (this Actor)	Product detail & seller store — commerce layer

Buy one, get a workflow; buy several, get an intelligence stack.

---

Compliance posture

• Only public JD data — same data any anonymous browser visitor sees on item and mall pages.
• No login bypass. No attempts to access account-only or paywalled content.
• No personal data harvesting. No reviewer nicknames or seller employee data is collected.
• No private message access. No follower lists. No cross-platform identity enrichment.

Buyers running this Actor for commercial workflows are responsible for downstream compliance with their own jurisdiction's data laws (GDPR, PIPL, CCPA, etc.).

---

Support

Found a bug? Edge case in a mode? Open an issue on the Actor page — typical turnaround is 48 hours.

If this Actor saves you time, a 30-second review is the single biggest thing that helps. Reviews bring the tool to other buyers and pay for continued maintenance.