# JD.com Product Scraper | Search, Prices & Barcodes (`monkey.d.scraping/jd-product-search-scraper`) Actor

Search JD.com products by keyword for $1 per 1,000 products + $0.005/start. Get CNY prices, brands, barcodes, variants, shops and return policies as JSON or CSV. Use the API or Server endpoint for ecommerce research.

- **URL**: https://apify.com/monkey.d.scraping/jd-product-search-scraper.md
- **Developed by:** [Monkey D. Scraping](https://apify.com/monkey.d.scraping) (community)
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 products

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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 Product Scraper — Search, Prices & Barcodes

Search JD.com (Jingdong / 京东) by product keyword and export product prices, brands, barcodes, variants, shops and purchase conditions. Built for ecommerce analysts, product researchers and AI workflows comparing products sold in China.

**$1 per 1,000 saved products + $0.005 per run start.** Product details are included at the same price. A standard run with 50 saved products costs $0.055, including Apify platform usage.

### What can I use it for?

- Compare JD.com product prices in Chinese yuan (CNY).
- Find brands, models and UPC barcodes for product matching.
- Research product variants, sellers, return policies and stock availability.
- Send structured product research to spreadsheets, data pipelines and AI tools through Apify API/MCP.

### Quick start

Enter a product keyword in Chinese, choose products per keyword and start the Actor. For example, 华为手机 means Huawei phones, 咖啡豆 means coffee beans, and 儿童绘本 means children's picture books.

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

The example saves up to 20 products for a total of up to $0.025 per standard run. JSON contains nested variants and services; CSV and Excel exports provide product rows for spreadsheets.

### Input

| Field | Purpose |
|---|---|
| `keywords` | One to three product search terms. Use Chinese keywords for the Chinese JD.com catalog. |
| `maxItems` | Products to save per keyword, from 1 to 50; default 20. |
| `includeDetails` | Include available product details; default true. The per-product price is unchanged. |

### Output

Each row describes one product in its keyword context. The same product found for two different keywords creates two result rows. Repeated identical keywords are collected once.

| Fields | Meaning |
|---|---|
| `id`, `resultId`, `title`, `url` | JD SKU, result identifier, product title and product page. |
| `searchQuery`, `position` | Original search term and result position. |
| `price`, `currency` | Product price in CNY. A price not displayed as a numeric value is `null`. |
| `brand`, `model`, `upc` | Brand, model and UPC barcode when available. |
| `variants`, `variantAttributes` | Related variants and the selected variant's attributes. |
| `shopName`, `shopId`, `shopUrl` | Seller or shop references. |
| `stockState`, `inStock`, `stockLocation` | Availability for JD's displayed default destination, not a buyer-specific shipping quote. |
| `services`, `returnPolicy`, `isSevenDayReturn` | Available services and return conditions. |
| `deliveryDate`, `shippingFee` | Delivery date when displayed and shipping conditions. |
| `purchaseLimit`, `maxOrderQuantity`, `maxCartQuantity` | Purchase restrictions, general order quantity and current cart quantity. Apply the purchase conditions together. |
| `reviewsCountText`, `reviewsCount`, `goodRate` | Displayed review count, its numeric lower bound when rounded, and positive-review percentage. These are not sales counts. |
| `listedAt`, `scrapedAt` | Listing date as displayed in China local time and collection time in UTC. |

Optional values remain `null` or empty when not provided. With details enabled, only products whose details were successfully read are saved and charged. A collection summary reports the delivered count and any products that could not be completed.

Example of a saved product:

```json
{
  "id": "100309589315",
  "title": "HUAWEI Pura X View  12GB+512GB 亚麻灰 华为阔直屏手机 沉浸阔直板 超轻薄长续航 新品",
  "price": 6999,
  "currency": "CNY",
  "brand": "华为（HUAWEI）",
  "upc": "6942711320913",
  "shopName": "华为京东自营旗舰店",
  "stockState": "available_to_order",
  "isSevenDayReturn": true,
  "url": "https://item.jd.com/100309589315.html"
}
```

### Pricing and spending control

- **Product:** $0.001 per saved row ($1 per 1,000).
- **Start:** $0.005 per run or Server instance, with the configured 512 MB memory.
- **Standard runs:** platform usage is included.
- **Server:** the same product/start rates apply; Apify charges platform usage separately for single-tenant Server instances.

Set a maximum total charge to control product-event spending. Products with unavailable requested details are not saved or charged. The start event applies when a run starts, including a run that finds no products.

### Server API

Send a POST request to `https://monkey-d-scraping--jd-product-search-scraper.apify.actor/products` with an Apify API token and the same JSON input. The response contains `items` and `summary`; delivered products are also saved in that Server instance's dataset with a `collectionId` identifying the request.

Each request performs a fresh collection and its saved products are charged. An active instance is reused for sequential calls and stops after 30 seconds without requests. A newly started instance incurs the start event. Use standard runs for batch work and the Server endpoint for direct HTTP responses.

### FAQ

#### Does this Actor search products or autocomplete keywords?

It searches JD.com products and returns product rows. It is designed for product discovery, price comparison and catalog research.

#### Are prices and details charged separately?

No. One saved product row costs $0.001 whether product details are enabled or disabled. The start charge is $0.005; standard platform usage is included.

#### Can I use the output with AI agents?

Yes. Apify's API/MCP workflows can run the Actor with product keywords and consume structured JSON. Input names, product fields and the summary make the result usable for product comparison and research workflows.

#### Does it return reviews or sales estimates?

It returns available review counts and positive-review rates as product metadata. Review bodies and estimated sales volume are not part of the output.

#### Is this an official JD.com service?

No. This is an independent data collection tool, not affiliated with JD.com.

### Related Actor

For US marketplace research, try [TikTok Shop Products & Creators](https://apify.com/monkey.d.scraping/tiktok-shop-product-video-lab) to connect TikTok Shop products with creator videos.

# Actor input Schema

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

Enter Chinese product keywords, such as 华为手机 (Huawei phones), 咖啡豆 (coffee beans), or 儿童绘本 (picture books).

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

Maximum number of products to save for each keyword.

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

Add available brands, barcodes, variants, stock and purchase conditions at the same product price.

## Actor input object example

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

# Actor output Schema

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

No description

## `summary` (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,
    "includeDetails": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("monkey.d.scraping/jd-product-search-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,
    "includeDetails": True,
}

# Run the Actor and wait for it to finish
run = client.actor("monkey.d.scraping/jd-product-search-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,
  "includeDetails": true
}' |
apify call monkey.d.scraping/jd-product-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,monkey.d.scraping/jd-product-search-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/9HayRiIOmj62aXtBu/builds/5kQjIoSBKMuW9EtLF/openapi.json
