# JD Shop Products Scraper (`piotrv1001/jd-shop-products-scraper`) Actor The JD Shop Products Scraper lists every product of a JD.com (京东) shop with its live CNY price, review count, good rate, variant SKUs and optional brand, model, UPC barcode, stock and delivery. Ideal for monitoring a JD store's catalog and competitor prices. - **URL**: https://apify.com/piotrv1001/jd-shop-products-scraper.md - **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 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. 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 Shop Products Scraper: Every Product and Price of a JD.com Store List **every product of a JD.com (京东) shop** with its live price. Give the **JD Shop Products Scraper** a shop id or a shop address and it returns the shop's catalog as a table: price in Chinese yuan, title, photo, review count, good rate, review tags, category ids, listing date and promotion badges, with optional brand, model, UPC/EAN barcode, stock and delivery for each product. Use it to monitor a JD store, track a competitor's JD shop prices, or check which resellers carry your brand. ### 🎯 Use Cases - **JD shop price monitoring**: schedule a daily run on a competitor's JD store and see every price change. - **JD store catalog export**: put an official flagship store's (旗舰店) whole range into a spreadsheet, with photos and links. - **Brand protection on JD**: run the shops that sell your brand and check their prices, titles and barcodes. - **Assortment research**: compare what two JD shops carry, at which price, and which products have the most reviews. - **JD seller research**: size a shop by its number of products, price band and review counts before you approach it. ### ✨ Features - **The whole shop**: the run reads the shop's listing page by page until JD has no more of its products. On our test runs, 迪信通旗舰店 gave 446 products and 华为京东自营旗舰店 more than 1,000. - **Live prices as numbers**: `price` is the yuan price a shopper sees, not the masked `1??9` of a product page. - **Reviews**: review count as a number (`5万+` becomes 50000) and as JD shows it, the good rate in percent and the review tags. - **Badges and dates**: installment offer, promotion tag, self-operated (京东自营), lowest-price, presale, flash-sale and JD Supermarket flags, and the listing date. - **Any shop address**: shop ids, `mall.jd.com/index-…` addresses, mobile shop links, brand domains like `huawei.jd.com`, and the shop's product list with its price range. - **Price range**: keep only products between a min and a max price in yuan. - **No duplicates**: each product is saved once per run, even when two inputs point to the same shop. - **Optional product details**: brand, model, UPC/EAN barcode, color, size, all variant SKUs, stock, delivery promise, return policy, services, warranty, weight, dimensions and photos. ### 🛠️ How It Works 1. **Paste JD shop ids or shop addresses**, one per line. The id is the number in `mall.jd.com/index-1000004259.html`. 2. **Set Max products per shop** (default 50), an optional price range, and turn on **Add product details** if you need barcodes and stock. 3. **Run the scraper** and download the products as JSON, CSV or Excel, or read them through the API. ### ⚙️ Input | Field | What it does | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **JD shops** | Shop ids (`1000004259`) or addresses: `https://mall.jd.com/index-1000004259.html`, `https://shop.m.jd.com/shop/home?shopId=1000004259`, `https://huawei.jd.com/`, or the shop's product list (`https://mall.jd.com/view_search-…html`) with its price range. | | **Max products per shop** | How many products to save per shop. Default 50. | | **Min price / Max price (CNY)** | Only products in this price range, in Chinese yuan. | | **Add product details** | Opens each product page for brand, model, barcode, variants, stock, delivery and more. Off by default. | ```json { "shops": ["1000004259", "https://mall.jd.com/index-1000001521.html"], "maxItems": 500, "scrapeDetails": false } ``` ### 💰 Pricing Pay only for the products you get. | Event | Price | What you get | | ------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Product** | $0.002 per product ($2.00 per 1,000) | One product of the shop with price and review fields | | **Product details** | $0.0015 per product ($1.50 per 1,000) | Brand, model, barcode, variants, stock, delivery and more, added to the product. Only with **Add product details** on, only for products that got them. | | **Actor start** | $0.00005 per run | Charged once when the run starts. | Examples: 50 products = $0.10 · a 1,000-product shop = $2.00 · the same with details = $3.50. ### 📊 Sample Output Data A row from a run on 乐高京东自营旗舰店 (LEGO's self-operated store) with details on (arrays shortened): ```json { "id": "100193567697", "title": "乐高（LEGO）积木机械组42212 法拉利FXX K赛车男女孩儿童玩具生日礼物赠礼袋", "url": "https://item.jd.com/100193567697.html", "price": 449, "currency": "CNY", "imageUrl": "https://img14.360buyimg.com/n0/jfs/t1/320624/39/15428/130120/687226dcF7e2820dc/caf16a3c7efe5430.png", "shopId": "1000001521", "shopName": "乐高京东自营旗舰店", "shopUrl": "https://mall.jd.com/index-1000001521.html", "venderId": "1000001521", "isSelfOperated": true, "reviewCount": 100000, "reviewCountText": "10万+", "goodRate": 98, "categoryIds": ["6233", "6275", "6280"], "installmentOffer": "3期免息", "promoTag": "赠品", "reviewTags": ["做工一流", "精美绝伦", "清晰易懂"], "listedAt": "2025-07-14T09:47:53.000Z", "isLowestPrice": false, "isPresale": false, "isFlashSale": false, "isJdSupermarket": true, "isCrossBorder": false, "position": 1, "page": 1, "detailsScraped": true, "scrapedAt": "2026-10-29T12:47:54.007Z", "brand": "乐高（LEGO）", "brandId": "11116", "model": "42212", "upc": ["5702017816357"], "color": "法拉利FXX 赛车", "size": null, "variants": [ { "id": "100320739176", "color": "吉普牧马人 Rubicon SUV", "size": null }, { "id": "100348974266", "color": "绿色布加迪超跑", "size": null } ], "images": [ "https://img14.360buyimg.com/n0/jfs/t1/552002/23/8269/215774/6ae1aad0Fc43a003c/00833203208b910f.jpg", "https://img14.360buyimg.com/n0/jfs/t1/292841/34/20297/71187/688ae82bFd23adc59/0856eff12679bee9.jpg" ], "inStock": true, "stockQuantity": 753, "deliveryPromise": "23:10前付款，预计明天(10月30日)送达", "shippingNote": "所选地址自营订单满59元免基础运费(20kg内)，超出重量加收1元/kg续重运费。", "returnPolicy": "7天无理由退货（防伪签、密封条损毁不支持）", "services": ["品质保真", "破损包退换", "7天价保"], "warranty": "无质保", "weightKg": 1.14, "lengthMm": 378, "widthMm": 258, "heightMm": 68, "origin": "浙江嘉兴", "onSaleSince": "2025-07-14 17:47:53", "shopInput": "1000001521" } ``` `reviewCount` is the lower bound JD shows (`5万+` = at least 50,000). `isSelfOperated` marks products sold and shipped by JD itself (京东自营). `position` is the product's place in the run's reading order of the shop, and `shopInput` the shop as you typed it. The fields from `brand` on are there only when **Add product details** is on. ### 🔁 Schedule and Integrate For JD shop price monitoring, run the same shops **once a day**: each run is a dated snapshot of the shop's catalog and prices. Set it up in Apify **Schedules**, and send the rows to **Google Sheets**, **Zapier**, **Make**, **n8n** or a webhook with Apify **integrations**. ### 🤖 Use with AI Agents (MCP) This Actor works as a tool in Claude, ChatGPT, Cursor and other MCP clients through the Apify MCP server (`https://mcp.apify.com`). An agent can call it with: ```json { "shops": ["1000004259"], "maxItems": 20 } ``` ### ❓ FAQ **Does JD.com have an official API for shop products?** JD's open platform (京东开放平台) gives sellers access to their own shop and needs an approved app. This Actor needs no key, account or approval and lists the public catalog of any JD shop with the prices a shopper sees. **How do I find a JD shop id?** Open the shop on JD: the id is the number in its address, `mall.jd.com/index-1000004259.html`. The `shopId` column of the [JD Search Scraper](https://apify.com/piotrv1001/jd-search-scraper) gives it too. A shop's vendor id (`venderId`) is a different number. **Does it get every product of a big shop?** It reads the shop's listing until JD shows no more of its products and says so in the status message. Set **Max products per shop** high enough (a flagship store can list over 1,000 products). **Do I need a JD account or Chinese?** No. Titles, shop names and delivery texts stay in Chinese as JD shows them; field names, ids, prices and flags read the same in any language. **Why is a field empty?** New products have no reviews yet, so `reviewCount` and `goodRate` are `null`. Barcodes, model numbers, weights and stock quantities are filled only when the seller listed them on the product page. **Which prices does it show?** The price a signed-out shopper in mainland China sees on JD, in CNY, without checkout coupons or member prices. ### 🔗 Related Scrapers - [JD Search Scraper](https://apify.com/piotrv1001/jd-search-scraper): JD search results for any keyword, to find the shops worth monitoring. - [JD.com Product Scraper](https://apify.com/piotrv1001/jd-com-product-scraper): product pages by SKU id. - [Alibaba Listings Scraper](https://apify.com/piotrv1001/alibaba-listings-scraper): wholesale prices and suppliers for the products a JD shop sells. - [AliExpress Listings Scraper](https://apify.com/piotrv1001/aliexpress-listings-scraper): the same products on AliExpress, for cross-market price checks. # Actor input Schema ## `shops` (type: `array`): JD shop ids (`1000004259`) or shop addresses, one per line: `https://mall.jd.com/index-1000004259.html`, a mobile shop link (`https://shop.m.jd.com/shop/home?shopId=1000004259`), a brand domain (`https://huawei.jd.com/`) or the shop's product list (`https://mall.jd.com/view_search-…html`), whose price range is kept. ## `maxItems` (type: `integer`): Stop each shop after this many products. Your maximum charge per run also caps the run. ## `minPrice` (type: `integer`): Only products from this price in Chinese yuan. ## `maxPrice` (type: `integer`): Only products up to this price in Chinese yuan. ## `scrapeDetails` (type: `boolean`): Also open each product page for brand, model, UPC/EAN barcode, variants, stock, delivery promise, return policy, warranty, weight, size and photos. Billed as an extra event per product that has them; slower. ## Actor input object example ```json { "shops": [ "1000004259" ], "maxItems": 50, "scrapeDetails": false } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `details` (type: `string`): No description ## `results` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "shops": [ "1000004259" ] }; // Run the Actor and wait for it to finish const run = await client.actor("piotrv1001/jd-shop-products-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "shops": ["1000004259"] } # Run the Actor and wait for it to finish run = client.actor("piotrv1001/jd-shop-products-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 '{ "shops": [ "1000004259" ] }' | apify call piotrv1001/jd-shop-products-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,piotrv1001/jd-shop-products-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 ` 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/PN84k5MlDec1tDbFQ/builds/o8zUPFLK42OkT7i6W/openapi.json