# JD.com Scraper (`automly/jd-scraper`) Actor

Scrape JD.com (京东) products by keyword, search link, shop or product ID: real price in yuan, shop, self-operated flag, review count, good rate, category, photos, plus brand, variants, stock, delivery, barcode and sales rank. No login.

- **URL**: https://apify.com/automly/jd-scraper.md
- **Developed by:** [Automly](https://apify.com/automly) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 6 total users, 3 monthly users, 99.4% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## JD.com Scraper

### What is JD.com Scraper?

**JD.com Scraper** is a tool that lets you **scrape products from JD.com (京东, Jingdong)**, China's largest online retailer: the real price in yuan, shop, whether JD sells it itself (京东自营), review count, good rate, category and photo for every product, with an option to add the brand, every photo, all variants, stock, delivery promise, shipping fee rule, services, weight, size, barcode, sales rank and purchase limit from the product page. Search by keyword in Chinese or English, paste JD links, give product IDs (SKUs) or shop IDs, click **Start**, and download the products as Excel, CSV or JSON.

- ⚡ **Fast:** 1,000 products from one search in under a minute, or about three minutes with product page details (our tests)
- 🔎 **Deep searches:** thousands of products per keyword, not just the first page
- 🏪 **Whole shops:** every product a JD shop lists, in the shop's own order, each with its price
- 💴 **Real prices:** the full price in yuan as a number, not the masked `6??9` of the product page
- 🔓 **No login:** no JD account, cookies or API key needed

### What can JD.com Scraper do?

- **Scrape JD search results** for any keyword, like `华为手机`, `蓝牙耳机`, `奶粉`, `lego` or `iphone 17`
- **Scrape a JD search link** copied from your browser, with its price filter (`search.jd.com/Search?keyword=...`)
- **Scrape every product of a JD shop** from its ID, its link (`mall.jd.com/index-1000004259.html`) or a brand store like `huawei.jd.com`
- **Scrape JD products by SKU or link**, one row each with the current price
- **Filter by price range** in yuan
- **Track JD prices** of your products and your competitors' with a daily schedule
- Export to Excel, CSV, JSON, HTML or XML, or send the data to Google Sheets, Make, Zapier and more

### What data can you extract from JD.com?

| | | |
|---|---|---|
| 🏷️ Title and product link | 💴 Price in yuan | 🆔 Product ID (SKU) and group ID |
| 🏪 Shop name and ID | ✅ Sold by JD (自营) | 💬 Review count and good rate |
| 🗂️ Category IDs | 📸 Main photo | 🏷️ Promotion, installments, 百亿补贴 |
| 🏭 Brand\* | 🖼️ Every photo\* | 🎨 Variants with their IDs\* |
| 📦 Stock\* | 🚚 Delivery promise and shipping fee rule\* | 🛡️ Services (JD Logistics, price protection...)\* |
| ⚖️ Weight and size\* | 🔢 Barcode (UPC/EAN)\* | 🏆 Sales rank and purchase limit\* |

\* With **Include product page details** (on by default).

### How to scrape JD.com

1. [Create a free Apify account](https://console.apify.com/sign-up).
2. Open **JD.com Scraper**.
3. Enter search words, or paste JD links, product IDs or shop IDs, one per line.
4. Set a price range and how many products you want per search or shop.
5. Click **Start**, then download the products as Excel, CSV, JSON or HTML.

### How much does it cost to scrape JD.com?

You pay per product saved. A product with page details costs a little more than a product from search alone. The **Pricing** tab shows the exact price per 1,000 products on your Apify plan, with lower prices on paid plans.

Every Apify account gets **$5 of free usage each month**, which is plenty to try the scraper on real searches. **Max products per search or shop** keeps the cost of a run under control, and you can also set a maximum cost per run.

### ⬇️ Input

| Setting | What it does |
|---|---|
| **Search words** | What to search JD for, like `华为手机`, one search per line |
| **JD links** | Product pages (`item.jd.com/<id>.html`, mobile and JD Worldwide pages too), search pages and shop pages, in any mix |
| **Product IDs (SKU)** | JD product numbers, like `100012043978`; one row each |
| **Shop IDs** | JD shop numbers, like `1000004259`; the shop's products in its own order |
| **Max products per search or shop** | How many products to save for each search or shop (default 50). Set 0 for as many as JD shows |
| **Min / Max price (yuan)** | Price range, like 1000 to 3000 |
| **Include product page details** | On by default: brand, photos, variants, stock, delivery, barcode, sales rank and more |
| **Proxy configuration** | Leave the default |

Huawei phones between 1,000 and 3,000 yuan:

```json
{
  "keywords": ["华为手机"],
  "minPrice": 1000,
  "maxPrice": 3000,
  "maxItems": 500
}
```

A shop, a search link and two products by SKU, without page details:

```json
{
  "shopIds": ["1000004259"],
  "startUrls": ["https://search.jd.com/Search?keyword=乐高&enc=utf-8"],
  "productIds": ["100012043978", "100320690657"],
  "includeDetails": false,
  "maxItems": 200
}
```

### ⬆️ Output

Every product is one row. A product with page details (variants shortened):

```json
{
  "id": "100012043978",
  "productId": null,
  "title": "茅台飞天 53%vol 500ml 贵州茅台酒（带杯）【需预约购买】",
  "url": "https://item.jd.com/100012043978.html",
  "mobileUrl": "https://item.m.jd.com/product/100012043978.html",
  "price": 1759.0,
  "currency": "CNY",
  "shopId": "1000475228",
  "shopName": "贵州茅台",
  "venderId": "1000475228",
  "isSelfOperated": true,
  "isJdWorldwide": null,
  "reviewCount": 2000000,
  "reviewCountText": "200万+",
  "goodRatePercent": 99,
  "categoryIds": ["12259", "12260", "9435"],
  "image": "https://img14.360buyimg.com/n1/jfs/t1/498128/6/14354/78100/6a8678aeFd76e6a0c/008332032059c4fa.jpg",
  "sellingPoints": [],
  "promotion": null,
  "installment": null,
  "isPresale": false,
  "isBillionSubsidy": null,
  "listedAt": null,
  "shortTitle": "【预约抢购】茅台飞天 单瓶",
  "brand": "茅台",
  "brandId": "12310",
  "images": [
    "https://img14.360buyimg.com/n1/jfs/t1/498128/6/14354/78100/6a8678aeFd76e6a0c/008332032059c4fa.jpg",
    "https://img14.360buyimg.com/n1/jfs/t1/328343/40/20658/89686/68c8f511Fbe85d4bc/e7ed9d2dc2c37101.jpg"
  ],
  "isOnSale": true,
  "stockState": "in_stock",
  "inStock": true,
  "deliveryPromise": "11:00前付款，最快今天送达",
  "shippingNote": "所选地址自营订单满59元免基础运费(20kg内)，超出重量加收1元/kg续重运费。",
  "services": ["今日达", "211限时达", "京东物流", "7天价保", "破损包退换"],
  "weightKg": 1.1,
  "sizeMm": [238.0, 90.0, 88.0],
  "barcode": "6902952880294",
  "salesRank": "纪念日白酒热卖榜第17名",
  "salesRankPosition": 17,
  "purchaseLimit": 2,
  "variantAttributes": ["规格", "其他信息"],
  "variants": [
    {"id": "100153291833", "attributes": {"规格": "2026年", "其他信息": "单瓶装"}, "image": "https://img14.360buyimg.com/n1/jfs/t1/538344/32/1045/88182/6aba0a86F8862dac1/00833203209ef461.jpg"}
  ],
  "isReservation": true,
  "position": null,
  "source": "100012043978",
  "scrapedAt": "2026-10-27T20:56:01Z"
}
```

Prices are in Chinese yuan (CNY), as JD shows them to a shopper in mainland China. `reviewCount` is the count JD prints rounded down (`200万+` gives 2,000,000); `reviewCountText` keeps JD's own text. Rows without page details stop at `listedAt`. The **Overview** and **Details** tabs show the main fields as tables; every field is in the downloads. The run report lists, for each search and shop, how many products were found and saved, and names any product or shop that does not exist.

### How can I use JD.com data?

- **Price monitoring:** follow JD prices of your products and your competitors', including 百亿补贴 and installment offers
- **China market research:** which brands, price points and shops fill a category on JD
- **Brand protection:** find every seller listing your brand and whether JD sells it itself
- **Shop and competitor analysis:** everything a JD shop sells and at what prices
- **Catalog building:** titles, photos, barcodes, weights and variants for comparison sites and apps

### How many products can I scrape from one search?

Thousands. JD shows 48 products per search page and the pages repeat many products, so the scraper keeps reading until a search stops bringing new ones, then reads the same search again inside JD's own price ranges. A broad keyword like `蓝牙耳机` gives several thousand products; a brand plus a model number ends sooner, with everything JD shows for it. Each product is saved once per run, even when several searches or shops find it.

### Use with AI agents (MCP)

AI agents can run this scraper through the Apify MCP server. Ask for example "Find Huawei phones under 3,000 yuan on JD.com with their stock and delivery promise" and the agent sends:

```json
{
  "keywords": ["华为手机"],
  "maxPrice": 3000,
  "includeDetails": true,
  "maxItems": 50
}
```

### Integrations and API

Run the scraper from your own code with the [Apify API](https://docs.apify.com/api/v2), or connect it to Make, Zapier, n8n, Google Sheets, Airtable, Slack and webhooks from the **Integrations** tab. Schedules run it every hour, day or week.

### ❓FAQ

#### How much does it cost to scrape JD.com?

See the **Pricing** tab for the price per 1,000 products on your plan. You only pay for products saved, and free accounts get $5 of usage every month.

#### Do I need a JD account?

No. The scraper reads only what anyone can see on JD.com without logging in. No cookies, no API key.

#### Why does JD show me `6??9` instead of a price?

JD hides the price on its product pages from visitors who are not logged in. The scraper gives the full price as a number for every product it finds by search, by shop or by SKU.

#### Does it give buyer reviews?

It gives the review count and the share of positive reviews for each product. The text of individual reviews is not part of the data.

#### Can I search in English?

Yes, but Chinese words match the way JD shoppers search and usually give more and better results: `蓝牙耳机` rather than `bluetooth earphones`.

#### What do stock and delivery refer to?

JD's default delivery area in mainland China. Stock and delivery promises can differ for other addresses.

#### What happens with a product or shop that does not exist?

It is listed in the run report as not found, and the run still succeeds with everything else.

#### Is it legal to scrape JD.com?

The scraper collects public product listings that anyone can see without logging in, and no personal data. You are responsible for how you use the data. JD.com Scraper is not affiliated with or endorsed by JD.com, Inc.

#### Something does not work. What can I do?

Open the **Issues** tab and tell us the input you used.

If the scraper saves you time, a short review on the Store helps other people find it.

# Actor input Schema

## `keywords` (type: `array`):

What to search JD.com for, one search per line, in Chinese or English, e.g. 华为手机, 蓝牙耳机, lego, 奶粉. Chinese words match the way JD shoppers search.

## `startUrls` (type: `array`):

Paste JD links in any mix, e.g. a product (https://item.jd.com/100012043978.html, item.m.jd.com/product/..., npcitem.jd.hk/...), a search page (search.jd.com/Search?keyword=茅台, with its price filter if any) or a shop (mall.jd.com/index-1000004259.html, shop.m.jd.com/?shopId=..., or a brand store like huawei.jd.com).

## `productIds` (type: `array`):

JD product numbers, one per line, e.g. 100012043978 (the number in item.jd.com/100012043978.html). Each gives one row with its price.

## `shopIds` (type: `array`):

JD shop numbers, one per line, e.g. 1000004259 (the number in mall.jd.com/index-1000004259.html). Gives the shop's products in the shop's own order, each with its price.

## `maxItems` (type: `integer`):

How many products to save for each search word, search link or shop, e.g. 100. Set 0 for as many as JD shows (often several thousand for a broad search). A product ID or product link always gives one row.

## `minPrice` (type: `integer`):

Lowest price to keep, in Chinese yuan, e.g. 1000. Applies to searches and shops.

## `maxPrice` (type: `integer`):

Highest price to keep, in Chinese yuan, e.g. 3000. Applies to searches and shops.

## `includeDetails` (type: `boolean`):

Open each product's page to add brand, all photos, variants (color, size, edition with their IDs), stock, delivery promise, shipping note, services, weight, size, barcode, sales rank and purchase limit. Charged as a detailed product. Turn off for faster, cheaper rows with price, shop, reviews and category only.

## `proxyConfiguration` (type: `object`):

Leave the default.

## Actor input object example

```json
{
  "keywords": [
    "华为手机"
  ],
  "maxItems": 20,
  "includeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `products` (type: `string`):

No description

## `details` (type: `string`):

No description

## `results` (type: `string`):

No description

## `report` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "华为手机"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("automly/jd-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["华为手机"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("automly/jd-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "华为手机"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call automly/jd-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automly/jd-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/JsAOdJRSzecL6VKIz/builds/r8sO6xCQ07Sq0a2AA/openapi.json
