# JD.com Search Scraper: Products with Real Prices (`themineworks/jd-scraper`) Actor

Search JD.com (Jingdong) by keyword: 48 products a page with the real shop price in yuan, shop, self operated flag, review count, good rate and category ids. Plain HTTP, no login.

- **URL**: https://apify.com/themineworks/jd-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.68 / 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 Search Scraper: Products with Real Prices by Keyword

[![JD.com Search Scraper: 50 products with real prices](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/jd-scraper-hero.png)](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)

**Part of The Mine Works E-commerce and marketplaces family:** [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

Updated 10 Nov 2026: rebuilt on plain HTTP. Keyword search on JD.com (京东, Jingdong) with the real shop price in yuan, 48 products a page, review count, good rate, shop, self operated flag and category ids, one flat row per product. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **The real price, not a mask.** JD hides the shopper price from signed-out visitors on its product pages (`1??9`). The search results page prints it in full, and this actor reads that page. In our test runs `price`, `title`, `sku_id` and `url` were filled on 750 of 750 rows and `shop_name` on 99.6 percent of them.
- **Keyword search that works.** Type 华为手机 and get the products JD lists for it: 48 per page, as many pages as you ask for, up to 2,000 per keyword. JD says it lists about 7,600 products for that keyword.
- **Shop, reviews and offer in the same row.** Shop name and id, `is_self_operated` (JD sells and ships it itself), review count as JD shows it, good rate in percent, instalment offer, promo tag and the review phrases shoppers pick most.
- **Price band filter.** `minPrice` and `maxPrice` keep the products of a band, in yuan.
- **Pay per product, nothing for errors.** Duplicates, empty keywords, blocked pages and the summary row are never charged. No JD account, cookies or API key.

**What this is, said plainly.** The rows come from JD's public hot-sale search page (京东热卖) for the keyword. The order is that page's order, not the order inside the JD app, and some of the products are promoted listings. For stock, delivery, barcode and variants of a SKU, use the JD.com Scraper by SKU id.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)

### Try it in one minute

Paste this into the input (JSON view) and press Start. It reads 25 products for each of two keywords:

```json
{
  "keywords": ["华为手机", "蓝牙耳机"],
  "maxItemsPerKeyword": 25
}
```

Apify's free plan includes $5 of credit every month, which covers about 2,500 products at this actor's price.

#### Copy to your AI assistant

```text
themineworks/jd-scraper on Apify. Searches JD.com (京东) by keyword and returns one flat row per product with the real shop price in yuan, shop, is_self_operated, review count label, good rate, category ids and rank, no login. Call ApifyClient("TOKEN").actor("themineworks/jd-scraper").call(run_input={"keywords": ["华为手机"], "maxItemsPerKeyword": 48}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give keywords (list of strings, Chinese works best). Optional: maxItemsPerKeyword (default 48, 1 to 2000), maxItems (default 10000, whole run), minPrice and maxPrice (CNY). Product rows have no _type field and carry sku_id, title, price, price_currency, shop_id, shop_name, is_self_operated, is_cross_border, review_count_label, good_rate_percent, review_tags, selling_point, installment_label, promo_tag, is_presale, is_flash_sale, category_ids, category_id_path, listed_at, image_url, url, mobile_url, keyword, page, position, total_results_for_keyword, scraped_at. Each run also writes one row with _type "summary"; rows with _type "info" or "error" explain a keyword that returned nothing; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~jd-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Many keywords in one run.** Up to 200 keywords, each with its own `maxItemsPerKeyword`; `maxItems` caps the whole run.
- **No double charge.** A product that two keywords both return is delivered once, and the next page is read to fill the keyword up.
- **Rank and size of the result.** `position` is the rank in the keyword's results and `total_results_for_keyword` is the count JD states.
- **Light.** About 245 KB per page of 48 products over the Apify datacenter proxy, no browser, 256 MB of memory.
- **Stops cleanly.** Three search pages in a row that fail end the run; it stops 10 seconds before its time limit and keeps every row.

### How to use it

#### Basic: products for a keyword

```json
{ "keywords": ["笔记本电脑"], "maxItemsPerKeyword": 48 }
```

#### Price benchmarking across keywords

```json
{
  "keywords": ["戴森吹风机", "dyson supersonic", "吹风机"],
  "maxItemsPerKeyword": 96
}
```

Compare `price` by `shop_name` or by `is_self_operated`.

#### A price band

```json
{ "keywords": ["羽绒服"], "minPrice": 300, "maxPrice": 1000, "maxItemsPerKeyword": 100 }
```

#### Track a category over time

Run the same keywords daily and compare runs on `sku_id`: new `sku_id` values are new listings, a changed `price` is a repricing.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `keywords` | array of strings | `["华为手机", "蓝牙耳机"]` (prefill) | Search words, Chinese or English, one per line. Up to 200. |
| `maxItemsPerKeyword` | integer | `48` | Most products per keyword, 1 to 2,000. 48 is one page. |
| `maxItems` | integer | `10000` | Most products in the whole run, 1 to 20,000. |
| `proxyConfiguration` | object | Apify proxy | Leave as is. |
| `minPrice` | integer (CNY) | none | Lowest price kept. |
| `maxPrice` | integer (CNY) | none | Highest price kept. |

### What data do you get?

One row per product, with no `_type` field. A field JD does not print for a product is left out of the row.

| Group | Fields |
|---|---|
| Identity | `sku_id`, `title`, `url`, `mobile_url`, `image_url` |
| Price | `price`, `price_currency` |
| Shop | `shop_id`, `shop_name`, `is_self_operated`, `is_cross_border` |
| Reviews | `review_count_label`, `good_rate_percent`, `review_tags` |
| Offer | `selling_point`, `installment_label`, `promo_tag`, `is_presale`, `is_flash_sale` |
| Category | `category_ids`, `category_id_path`, `listed_at` |
| Run context | `keyword`, `page`, `position`, `total_results_for_keyword`, `scraped_at` |

`price` is the price JD prints on the search result for a signed-out visitor in yuan. It can differ from what a signed-in shopper sees after coupons and subsidies.

#### Output example

```json
{
  "sku_id": "100320716471",
  "title": "HUAWEI Mate 90 Pro Max 【24期免息】 12GB+512GB 曜石黑麒麟9050 全昆仑玄武架构 全彩灵珑屏 华为手机",
  "price": 9498,
  "price_currency": "CNY",
  "shop_id": "1000004259",
  "shop_name": "华为京东自营旗舰店",
  "is_self_operated": true,
  "is_cross_border": false,
  "review_count_label": "1万+",
  "good_rate_percent": 99,
  "installment_label": "24期免息",
  "promo_tag": "赠品",
  "category_id_path": "9987,653,655",
  "listed_at": "2026-10-01T03:15:50.000Z",
  "image_url": "https://img14.360buyimg.com/n0/jfs/t1/562406/26/3282/99552/6ae5b5d5F2d706e6a/00835a05a0bcb386.jpg",
  "url": "https://item.jd.com/100320716471.html",
  "keyword": "华为手机",
  "page": 1,
  "position": 1,
  "total_results_for_keyword": 7685,
  "scraped_at": "2026-11-10T15:26:54.761Z"
}
```

### Pricing

Pay per event: you pay for the products you receive, plus a flat $0.003 per run, whatever memory you choose.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `product-scraped` | Once per product row stored in your dataset | $1.97 per 1,000 | $1.87 per 1,000 | $1.77 per 1,000 | $1.68 per 1,000 |
| `run-start` | Once per run, after the first results page returned products | $0.003 | $0.003 | $0.003 | $0.003 |

The price of one product is the price per 1,000 divided by 1,000.

Never charged:

- a keyword that returns nothing (it gets an info row);
- a product that a second keyword of the same run finds again;
- products past your `maxItemsPerKeyword` or `maxItems`;
- the summary, info and error rows;
- a run where no results page returned products: the start fee is charged only once a page has returned products;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Compare runs on `sku_id` and `price` to see new listings and repricing.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

JD.com's public hot-sale search page for each keyword and result page, as a signed-out visitor sees it. It does not log in, place orders or read anything behind a sign in.

#### Is the order the same as in the JD app?

No. It is the order of JD's hot-sale page for the keyword. Some products on it are promoted listings. Use `position` for the rank within this page's results.

#### How many products can I get per keyword?

JD states about 7,000 to 7,700 for a broad keyword. The actor reads up to 2,000 per keyword and 20,000 per run. A page of 48 takes a few seconds.

#### Why do some pages return fewer than 48 products?

JD fills some pages with fewer, and a product that appears twice on a page is delivered once. The actor reads the next page until your `maxItemsPerKeyword` is reached.

#### Are reviews, stock, delivery and barcodes included?

You get the review count and good rate when JD prints them on the result, which it did for about one product in three in our tests. Review texts, stock, delivery promise, barcode and variants are on the product page: use the JD.com Scraper with the `sku_id` values from this actor.

#### Do I need an account, cookies or a proxy?

No account and no cookies. The actor uses the Apify datacenter proxy. A page that fails twice there is tried once on a China residential IP, which costs you nothing extra.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS or HTML from the dataset tab or the API.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through the Apify MCP server: add `https://mcp.apify.com` to your client and ask for `themineworks/jd-scraper`.

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

The actor reads public pages a visitor can open without an account. You are responsible for how you use the data. Prices and listings can be protected by terms of use or local law; take advice for commercial redistribution.

### Integrations

- **Google Sheets**: send each run's products to a sheet with Apify's Google Sheets integration; one row per product fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "price changes for our keyword every Monday to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool.

### More from The Mine Works

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Carsales.com.au Scraper](https://apify.com/themineworks/carsales-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [eBay Product Listings Scraper](https://apify.com/themineworks/ebay-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Shopify Store Scraper](https://apify.com/themineworks/shopify-store-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [🛒 TikTok Shop Scraper](https://apify.com/themineworks/tiktok-shop-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Walmart Product & Price Scraper](https://apify.com/themineworks/walmart-product-price-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Vinted Scraper](https://apify.com/themineworks/vinted-listings-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a keyword that returns fewer products than JD shows, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search JD.com by keyword and get every product back as one row, with the real price in yuan, shop, self operated flag, review count and good rate, no login.*

# Actor input Schema

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

Product keywords, one per line, in Chinese (best results) or English. Example: 华为手机. Up to 200 per run.

## `maxItemsPerKeyword` (type: `integer`):

The most products to return for each keyword, 1 to 2,000. JD shows 48 per page, so 48 is one page. Example: 100.

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

The most products to return in the whole run, 1 to 20,000, whatever the number of keywords. Example: 500.

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

Keep only products priced at or above this, in yuan. Leave empty for no lower limit.

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

Keep only products priced at or below this, in yuan. Leave empty for no upper limit.

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

Optional. Leave as is: the Apify datacenter proxy is enough. A page that fails twice on it is tried once on a China residential IP, at most 40 pages per run.

## Actor input object example

```json
{
  "keywords": [
    "华为手机",
    "蓝牙耳机"
  ],
  "maxItemsPerKeyword": 25,
  "maxItems": 10000,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (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": [
        "华为手机",
        "蓝牙耳机"
    ],
    "maxItemsPerKeyword": 25,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/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": [
        "华为手机",
        "蓝牙耳机",
    ],
    "maxItemsPerKeyword": 25,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/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": [
    "华为手机",
    "蓝牙耳机"
  ],
  "maxItemsPerKeyword": 25,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call themineworks/jd-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/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/g0G3OVTUO0zcua9CW/builds/X5avqKTuS3HKXTGlB/openapi.json
