# XCMG Equipment Specs API (`rastriq/xcmg-global-scraper`) Actor
Get the complete XCMG construction equipment catalog — 1,100+ models with full technical specifications, descriptions and images. Instant delivery from cached database.
- **URL**: https://apify.com/rastriq/xcmg-global-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** E-commerce, Business
- **Stats:** 2 total users, 1 monthly users, 85.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## XCMG Equipment Specs API
Get the **complete XCMG construction equipment catalog** — 1,100+ models with full technical specifications, descriptions, and product images. Delivered instantly from a pre-built database updated monthly.
### What data do you get?
For every XCMG model across all categories:
- **Model identification** — name, series, category, product ID, source URL
- **Full spec table** — operating weight, engine power, bucket capacity, boom length, lifting capacity, and all OEM specifications (available for ~50% of models)
- **Key specs** — 3 headline specifications always available for every model (even without full spec table)
- **Marketing content** — description and multiple product images
- **Flat spec format** — specs as key-value pairs for easy filtering and analysis
Data extracted from official [xcmgglobal.com](https://www.xcmgglobal.com).
### Who is this for?
- **Equipment dealers & rental companies** — Chinese equipment is growing fast; know what's available
- **Market intelligence platforms** — track XCMG's expanding global product portfolio
- **Construction tech companies** — include Chinese OEMs in comparison and matching tools
- **Procurement teams** — evaluate XCMG equipment specs for tender requirements
- **Competitive intelligence** — benchmark XCMG against CAT, Komatsu, Volvo
### Equipment categories
| Category | Examples |
|----------|----------|
| Crawler Excavators | XE60U through XE7000 (mini to mining) |
| Wheel Loaders | LW300, LW500, LW800, LW1200 |
| Truck Cranes | XCT25, XCT55, XCT100, XCT220 |
| Rotary Drilling Rigs | XR150, XR280, XR460, XR800 |
| Road Rollers | XS120, XS203, XS263, XS333 |
| Concrete Pumps | HB37V, HB52V, HB62V |
| Motor Graders | GR135, GR180, GR215, GR300 |
| Dozers | DL350, DL560 |
| + many more | Pavers, cold planers, mining trucks, forklifts... |
### Sample output
```json
{
"model": "XE490U",
"cat_slug": "crawler-excavator",
"cat_label": "Crawler Excavator",
"series": "U Series",
"description": "The XE490U large crawler excavator features...",
"specs": [
{"name": "Operating Weight", "unit": "kg", "value": "49800"},
{"name": "Engine Power", "unit": "kW/rpm", "value": "260/1800"},
{"name": "Bucket Capacity", "unit": "m³", "value": "1.2-2.5"}
],
"specs_flat": {
"operating_weight_kg": "49800",
"engine_power_kw_rpm": "260/1800",
"bucket_capacity_m3": "1.2-2.5"
},
"key_specs": [
{"name": "Operating Weight", "unit": "kg", "value": "49800"},
{"name": "Engine Power", "unit": "kW/rpm", "value": "260/1800"},
{"name": "Bucket Capacity", "unit": "m³", "value": "1.2-2.5"}
],
"images": ["https://www.xcmgglobal.com/upload/images/..."],
"url": "https://www.xcmgglobal.com/product/crawler-excavator/XE490U/",
"product_id": "1234",
"has_full_specs": true
}
````
### Pricing
**$2.50 per 1,000 results** (models). Full catalog (~1,100 models) costs approximately $2.75.
Most runs deliver instantly from cache. Fresh scrapes take 20–30 minutes.
### Tips
- **First run**: Leave defaults and click Start for 10 sample models.
- **Fast mode**: Enable "Fast mode (index only)" for a quick inventory with key specs but no full spec table.
- **Full catalog**: Set "Max models" to 0.
- **Category filter**: Add category slugs to get only crawler-excavators, only cranes, etc.
### FAQ
**Why do some models not have full specs?**
About 50% of XCMG product pages render specs via JavaScript only (not server-side). These models still get 3 key specs from the catalog index, but not the complete spec table.
**How fresh is the data?**
Monthly updates. XCMG adds new models periodically.
**Is this official XCMG data?**
Yes — extracted directly from xcmgglobal.com (XCMG's official international site).
# Actor input Schema
## `categories` (type: `array`):
Select one or more equipment categories, or leave empty for all categories.
## `maxItems` (type: `integer`):
Limit the number of equipment models returned. Set to 0 for all available (~1,100).
💡 Use 5–10 for your first test run.
## `skipDetailPages` (type: `boolean`):
When enabled, returns basic info (model, category, image, 3 key specs) without fetching full spec tables. 10x faster — useful for catalog inventory.
## `forceRefresh` (type: `boolean`):
By default, results come from a pre-built database (updated monthly). Enable this only if you need the absolute latest data.
## `delayMin` (type: `number`):
Minimum delay between requests.
## `delayMax` (type: `number`):
Maximum delay between requests.
## `proxyConfiguration` (type: `object`):
Optional proxy. Not typically needed — XCMG's WAF is lightweight.
## Actor input object example
```json
{
"categories": [],
"maxItems": 10,
"skipDetailPages": false,
"forceRefresh": false,
"delayMin": 1,
"delayMax": 1.8,
"proxyConfiguration": {}
}
```
# Actor output Schema
## `dataset` (type: `string`):
All XCMG models with specifications and product details
# 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 = {
"categories": [],
"maxItems": 10
};
// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/xcmg-global-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 = {
"categories": [],
"maxItems": 10,
}
# Run the Actor and wait for it to finish
run = client.actor("rastriq/xcmg-global-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"categories": [],
"maxItems": 10
}' |
apify call rastriq/xcmg-global-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=rastriq/xcmg-global-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "XCMG Equipment Specs API",
"description": "Get the complete XCMG construction equipment catalog — 1,100+ models with full technical specifications, descriptions and images. Instant delivery from cached database.",
"version": "0.2",
"x-build-id": "GEmPMa3Qe7kacJt3N"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/rastriq~xcmg-global-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-rastriq-xcmg-global-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/rastriq~xcmg-global-scraper/runs": {
"post": {
"operationId": "runs-sync-rastriq-xcmg-global-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/rastriq~xcmg-global-scraper/run-sync": {
"post": {
"operationId": "run-sync-rastriq-xcmg-global-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"categories": {
"title": "Equipment categories",
"type": "array",
"description": "Select one or more equipment categories, or leave empty for all categories.",
"items": {
"type": "string",
"enum": [
"crawler-excavator",
"wheel-loader",
"truck-crane",
"rotary-drilling-rig",
"road-roller",
"concrete-pump",
"motor-grader",
"dozer",
"paver",
"cold-planer",
"mining-truck",
"mining-excavator",
"forklift",
"telehandler",
"aerial-work-platform",
"skid-steer-loader",
"backhoe-loader",
"compact-excavator"
],
"enumTitles": [
"Crawler Excavators",
"Wheel Loaders",
"Truck Cranes",
"Rotary Drilling Rigs",
"Road Rollers",
"Concrete Pumps",
"Motor Graders",
"Dozers",
"Pavers",
"Cold Planers",
"Mining Trucks",
"Mining Excavators",
"Forklifts",
"Telehandlers",
"Aerial Work Platforms",
"Skid Steer Loaders",
"Backhoe Loaders",
"Compact Excavators"
]
},
"default": []
},
"maxItems": {
"title": "Max models",
"minimum": 0,
"type": "integer",
"description": "Limit the number of equipment models returned. Set to 0 for all available (~1,100).
💡 Use 5–10 for your first test run.",
"default": 0
},
"skipDetailPages": {
"title": "Fast mode (index only)",
"type": "boolean",
"description": "When enabled, returns basic info (model, category, image, 3 key specs) without fetching full spec tables. 10x faster — useful for catalog inventory.",
"default": false
},
"forceRefresh": {
"title": "Force fresh scrape",
"type": "boolean",
"description": "By default, results come from a pre-built database (updated monthly). Enable this only if you need the absolute latest data.",
"default": false
},
"delayMin": {
"title": "Min delay (seconds)",
"minimum": 0.5,
"type": "number",
"description": "Minimum delay between requests.",
"default": 1
},
"delayMax": {
"title": "Max delay (seconds)",
"minimum": 0.5,
"type": "number",
"description": "Maximum delay between requests.",
"default": 1.8
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional proxy. Not typically needed — XCMG's WAF is lightweight.",
"default": {}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```