# d1cm Used Excavator & Machinery Scraper 第一工程机械网 – China (`rastriq/d1cm-machinery-scraper`) Actor

Scrape d1cm.com (第一工程机械网): certified used Komatsu / Hitachi excavators (GCP) with price, year, hours and province, plus the new-machine catalogue with specs. HTTP only. 二手挖掘机数据采集。

- **URL**: https://apify.com/rastriq/d1cm-machinery-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 listing results

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

## d1cm.com Machinery Scraper — Used Excavators with Prices + New Machine Catalogue (China)

Extract **certified used excavators with price, year, hours and region** and the **new-machine catalogue** (models, key specs and full spec sheets) from **d1cm.com** (第一工程机械网, a leading Chinese construction-machinery portal). Structured output ready for JSON, CSV or Excel.

> 🚀 **Try it free** — click **Start** with the defaults to get 10 used excavators in seconds. No browser, no login, no API key.

### 🇨🇳 中文说明

**第一工程机械网（d1cm.com）数据采集工具**：无需浏览器、无需登录，抓取绿色循环计划（GCP，gcp.d1cm.com）频道的认证二手挖掘机（小松、日立“高端循环机”），以及新机产品库的机型与参数。

- **二手机字段：** 品牌、型号、年份、工作小时数、价格（万元换算为元，部分为“面议”）、所在省份、在售/已售状态、上架时间、图片；开启“详情”后另含城市、卖方与全部图片。
- **新机产品库：** 机型、品牌、主要参数；开启“详情”后另含完整参数表（新机不公布价格）。
- **使用方法：** 选择频道（二手 / 新机），可按省份、机龄、价格区间（万元）、工作小时数筛选，设置最大条数后点击 **Start**。
- **适用人群：** 二手工程机械贸易商、经销商、估值与金融租赁机构、行业研究团队。
- **导出格式：** JSON、CSV、Excel 或通过 API 获取，字段结构与 Rastriq 其他中国工业设备采集器统一。
- **合规说明：** 遵守网站 robots.txt；仅采集公开的企业与设备信息，不采集联系人姓名、手机号码、微信/QQ 等个人信息。
- **计费：** 按结果计费：列表数据每 1,000 条 $2.00，含详情每 1,000 条 $4.00（每条只计费一次），每次运行另收 $0.005；更高等级的 Apify 套餐自动享受折扣。平台算力已包含；如自备代理（例如住宅代理），代理流量费用由您的代理服务商收取，不含在本工具价格内。

### 📌 What is d1cm.com Machinery Scraper?

d1cm.com is one of China's best-known construction-machinery portals. It has two data sets this actor covers:

| Section | Source | What you get | Size |
|---|---|---|---|
| ♻️ `used` | gcp.d1cm.com (Green Cycle Plan · 绿色循环计划) | Certified used **Komatsu & Hitachi excavators**: price (≈50% publish one), year, hours, province, status, photos, seller entity | ~420 machines |
| 🆕 `new_catalog` | product.d1cm.com | New-machine models by category: brand, series, key spec, full spec sheet (details mode) | 130+ categories, e.g. 1,350 excavator models |

> ℹ️ **Prices:** d1cm publishes **no prices for new machines** (inquiry-only). Catalogue rows have `priceCny: null` and the flag `price_not_published`. Only the used section carries prices.

Use it to track Komatsu/Hitachi certified-used pricing and stock, or to build a structured spec database of the Chinese market (Sany, XCMG, Liugong, Zoomlion, Shantui…).

### 📋 Data fields

Normalised **Rastriq machinery schema** (same across our Chinese marketplace actors).

| Field | Type | Description |
|---|---|---|
| `source`, `sourceSection` | string | `d1cm.com`, `used` / `new_catalog` |
| `listingId`, `url` | string | Machine / model ID and URL |
| `title`, `category`, `categoryPath` | string, string, array | Original title (Chinese) and categories |
| `brand`, `model` | string | Brand (Chinese), model |
| `year`, `hours` | integer | Year of manufacture, operating hours (used) |
| `condition` | string | `used` or `new` |
| `priceCny`, `priceText`, `priceType` | number, string, string | CNY price (万元 converted), original text, `fixed` / `on_request` |
| `location` | object | `{province, city, raw}` (city: details mode) |
| `seller` | object | `{name, type, shopUrl}` (details mode, used) |
| `images` | array | Absolute https URLs (all photos in details mode) |
| `specs` | object | Spec key/value pairs in Chinese (catalogue: key spec in list mode, full sheet in details mode) |
| `postedAt`, `updatedAt` | string | ISO 8601 |
| `qualityFlags` | array | `price_on_request`, `sold`, `in_rental_fleet`, `year_missing`, `hours_missing`, `province_missing`, `price_not_published`, `discontinued`, `brand_missing`, `detail_fetch_failed`… |
| `ext_*` | mixed | `ext_status`, `ext_certification`, `ext_categoryEn` (English category name, both sections), `ext_series`, `ext_attentionPct`, `ext_followers`… |
| `scrapedAt` | string | ISO 8601 UTC |

Rows are **flagged, never dropped**: sold machines and 面议 (price-on-request) listings are returned with flags so you decide what to keep.

### 📂 Category tree / 类目

The **📂 Categories** dropdown mirrors the site's own category tree, with **English and Chinese names** for every entry (type either language to filter; picking a top-level group downloads all its subcategories). Top-level groups (16): (new-machine catalogue; the used section — Green Cycle Plan · 绿色循环计划 — is excavators only)

| English | 中文 |
|---|---|
| Aerial work machinery | 高空作业机械 |
| Attachments and tooling | 附属工装 |
| Bridge machinery | 桥梁机械 |
| Compaction machinery | 压实机械 |
| Concrete machinery | 混凝土机械 |
| Cranes | 起重机械 |
| Earthmoving and hauling machinery | 铲土运输机械 |
| Excavating machinery | 挖掘机械 |
| Industrial vehicles | 工业车辆 |
| Mining machinery | 矿山机械 |
| Piling machinery | 桩工机械 |
| Port machinery | 港口机械 |
| Power systems | 动力系统 |
| Road construction and maintenance machinery | 筑养路机械 |
| Sanitation machinery | 环卫机械 |
| Tunneling machinery | 隧道机械 |

In the output, `category` / `categoryPath` keep the site's Chinese names and `ext_categoryEn` gives the English name of the category.

下拉菜单与网站类目树一致，每个类目均提供中英文名称，可用中文或英文搜索；选择一级类目即下载其全部子类目。输出中 `category` / `categoryPath` 为网站中文类目，`ext_categoryEn` 为英文类目名称。

### 🚀 How to use

1. Keep the defaults (section *used*, 10 listings) and click **Start**.
2. Use the used-machine filters (province, brand, age, price range in 万元, hours) or switch on `new_catalog` and pick catalogue categories from the dropdown (144 entries: 16 groups and 128 subcategories; a group such as *Excavating machinery (all)* downloads all its subcategories).
3. Enable **Fetch detail pages** for city, seller and all photos (used) or full spec sheets (catalogue).

#### Input

| Parameter | Default | Description |
|---|---|---|
| `sections` | `["used"]` | `used`, `new_catalog` or both (in that order) |
| `maxItems` | `100` | Hard cap across sections (`0` = unlimited) |
| `includeDetails` | `false` | +1 request per item |
| `province`, `usedBrand`, `yearLimit`, `minPriceWan`, `maxPriceWan`, `minHours`, `maxHours` | – | Used-machine filters (`province`: dropdown of the 31 provinces the site filter accepts; `usedBrand`: Komatsu / Hitachi) |
| `catalogCategories` | `["wajuejixie"]` | Catalogue categories from the dropdown (site slugs such as `tuituji` bulldozers, `qichediao` truck cranes, `bengche` pump trucks; a group selects all its subcategories) |
| `expandSeries` | `true` | Complete series that the category page truncates at 10 models |
| `maxConcurrency` / `requestDelayMs` | `3` / `500` | Politeness controls |
| `proxyUrl` | – | Optional, e.g. `http://user:pass@gate.decodo.com:7000` |

```json
{ "sections": ["used"], "minPriceWan": 50, "maxPriceWan": 80, "maxItems": 50 }
```

#### Output example (used)

```json
{
  "source": "d1cm.com",
  "sourceSection": "used",
  "listingId": "2183",
  "url": "https://gcp.d1cm.com/komatsu/project_2183",
  "title": "小松挖掘机PC200-11M0",
  "category": "挖掘机",
  "categoryPath": [
    "二手机",
    "绿色循环计划",
    "挖掘机"
  ],
  "ext_categoryEn": "Excavators",
  "brand": "小松",
  "model": "PC200-11M0",
  "year": 2023,
  "hours": 3217,
  "condition": "used",
  "priceCny": null,
  "priceText": "面议",
  "priceType": "on_request",
  "location": {
    "province": "贵州",
    "city": "黔南布依族苗族自治州",
    "raw": "贵州黔南布依族苗族自治州"
  },
  "seller": {
    "name": "小松（中国）租赁循环事业部",
    "type": "company",
    "shopUrl": "https://gcp.d1cm.com/shop_1006947"
  },
  "images": [
    "https://gcp.d1cm.com/upfiles/gcpFile/kuems/zulin/1984_b85e46c2-9965-442f-978b-bc50a6794e08.jpg",
    "https://gcp.d1cm.com/upfiles/gcpFile/kuems/zulin/1984_bc22b86c-4a99-4e6a-af9d-8d2aab5de28f.jpg"
  ],
  "specs": {},
  "postedAt": "2026-10-21T00:00:00Z",
  "updatedAt": null,
  "qualityFlags": [
    "price_on_request"
  ],
  "scrapedAt": "2026-10-20T22:56:17Z",
  "ext_status": "在库可售",
  "ext_certification": "高端循环机",
  "ext_brandSlug": "komatsu"
}
```

### 💰 Cost

Pay-per-event pricing — you pay only for items that land in your dataset, never for retries or failed pages. Higher Apify plans get automatic volume discounts:

| Event (per 1,000 results) | Free | Bronze | Silver | Gold | Platinum | Diamond |
|---|---|---|---|---|---|---|
| **Listing result** (Fetch detail pages off) | $2.00 | $1.80 | $1.70 | $1.50 | $1.30 | $1.20 |
| **Detailed result** (Fetch detail pages on) | $4.00 | $3.60 | $3.40 | $3.00 | $2.60 | $2.40 |

Plus **$0.005 per run** (Actor start). Each item is charged **either** as a listing result **or** as a detailed result — never both; if a detail page cannot be fetched, that item is charged at the listing price.

*Example:* 1,000 items with details on the Free plan ≈ **$4.00**; 10,000 listing-only items ≈ **$20.00**.

Platform compute is included in the price. **Proxy:** not needed by default. If you add your own proxy (for example a residential proxy) in *Proxy URL*, that traffic is billed by your proxy provider and is **not** included in the Actor price. Use *Max items* or the run's *Maximum cost per run* to cap your spend.

Speed: The whole used inventory (~420 machines) is fetched in about 27 HTTP requests (~15 s); details mode needs ~1.1 requests per machine. The catalogue needs ~0.04–0.06 requests per model in list mode.

### ⚠️ Known limits

- The **used** inventory is small (~420 machines, only Komatsu and Hitachi) and about half of the machines show 面议 instead of a price; about 3% are already sold (flag `sold`).
- **No new-machine prices** exist on the site; catalogue rows carry specs only.
- The old marketplace host `ershou.d1cm.com` is unreachable and is not covered.
- In list mode, `location.city`, seller and extra photos are empty; use `includeDetails`.
- The origin is in China; expect occasional slow responses from abroad (the actor retries with backoff).

### ❓ FAQ

**Does it collect dealer phone numbers?** No. Dealer and seller phone numbers shown on the site are never extracted.

**Can I get new-machine prices?** Not from this source: d1cm routes price requests to dealers.

**How fresh is the data?** Live at run time; the site updates daily. Schedule the actor to track stock and price changes.

**Is scraping legal?** The actor reads public pages at a polite pace. Use the data in line with applicable law and the site's terms.

# Actor input Schema

## `sections` (type: `array`):

<b>used</b> — ~420 certified used machines with year, hours, province and price (about half show a price, the rest are 面议 / on request).<br><b>new_catalog</b> — new-machine models by category (no prices).

## `catalogCategories` (type: `array`):

New-machine catalogue categories of product.d1cm.com (used when the <b>new_catalog</b> section is selected). Type to filter (English or Chinese). <b>Choosing a parent such as “Excavating machinery (all)” downloads all its subcategories</b>; each one is crawled separately. Categories without models on the site are not listed.

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

Maximum number of results. Use a small value (5-20) for a first test. Set to <code>0</code> for no limit.

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

<b>used:</b> adds city, seller entity, shop URL and all photos. <b>new_catalog:</b> adds the full spec sheet (dozens of fields), brand and followers. +1 request per item.

## `province` (type: `string`):

Province of the machine. Applied to the <b>used</b> section only. Type to filter (English or Chinese).

## `usedBrand` (type: `string`):

Used-machine brand (gcp.d1cm.com certified machines are Komatsu and Hitachi). Leave empty for both.

## `yearLimit` (type: `string`):

Age bracket.

## `minPriceWan` (type: `integer`):

Minimum price in units of 10,000 CNY. Also excludes machines without a published price.

## `maxPriceWan` (type: `integer`):

Maximum price in units of 10,000 CNY.

## `minHours` (type: `integer`):

Minimum working hours.

## `maxHours` (type: `integer`):

Maximum working hours.

## `expandSeries` (type: `boolean`):

The category pages show at most 10 models per series. When enabled, series with more models are expanded (+1 request per series) so the catalogue is complete.

## `maxConcurrency` (type: `integer`):

Parallel requests (1-10). Default 3.

## `requestDelayMs` (type: `integer`):

Base delay before each request, with ±50% random jitter.

## `proxyUrl` (type: `string`):

Optional proxy, e.g. <code>http://user:pass@gate.decodo.com:7000</code>. Leave empty to connect directly (works for both sites). <b>Proxy traffic is billed by your own proxy provider</b> and is not included in this Actor's price.

## `debugMode` (type: `boolean`):

Log every request URL.

## Actor input object example

```json
{
  "sections": [
    "used"
  ],
  "catalogCategories": [
    "wajuejixie"
  ],
  "maxItems": 10,
  "includeDetails": false,
  "expandSeries": true,
  "maxConcurrency": 3,
  "requestDelayMs": 500,
  "debugMode": false
}
```

# Actor output Schema

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

Dataset with all scraped listings in the normalised Rastriq machinery schema.

# 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 = {
    "sections": [
        "used"
    ],
    "catalogCategories": [
        "wajuejixie"
    ],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/d1cm-machinery-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 = {
    "sections": ["used"],
    "catalogCategories": ["wajuejixie"],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/d1cm-machinery-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 '{
  "sections": [
    "used"
  ],
  "catalogCategories": [
    "wajuejixie"
  ],
  "maxItems": 10
}' |
apify call rastriq/d1cm-machinery-scraper --silent --output-dataset

```

## MCP server setup

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