21-sun.com New Machinery Catalog Scraper

Extract the new construction-machinery catalog of 21-sun.com (铁臂商城 / Tiebi Shangcheng), China's reference portal for heavy equipment: ~31,000 current models of excavators, loaders, cranes, bulldozers, pumps, rollers, forklifts and more, with brand, category, images and full technical specifications.

Built by Rastriq. Pure HTTP (no browser): fast, cheap and light on the source site.

Important — what this actor does NOT return

• No prices. 21-sun.com is an inquiry-only catalog ("立即询价"); it publishes no list or reference prices. priceCny is always null and every item carries the price_on_request quality flag.
• No used-equipment listings. The used marketplace (used.21-sun.com) currently answers HTTP 404 on every path, so it is not offered.

🇨🇳 中文说明

铁臂商城（21-sun.com，中国工程机械商贸网）新机产品库数据采集工具：无需浏览器、无需登录，批量抓取挖掘机、装载机、起重机、推土机、泵车、压路机、叉车等约 3.1 万个机型。

• 可采集字段： 机型名称、品牌、型号、类别、产品图片、主要参数（如整机重量、发动机功率）；开启“详情”后另含完整技术参数（约 20–67 项）、更新时间，以及授权经销商（企业名称与地区）。
• 注意： 铁臂商城为询价制，不公布价格（priceCny 始终为空并标记 price_on_request）；原二手频道已下线，不在采集范围内。
• 使用方法： 选择设备类别（如 挖掘机、装载机、起重机）和品牌（如 三一、徐工、卡特彼勒），可选关键词，设置最大条数后点击 Start。
• 适用人群： 工程机械经销商、进出口贸易商、厂商竞品与产品规划团队、行业研究机构。
• 导出格式： JSON、CSV、Excel 或通过 API 获取，字段结构与 Rastriq 其他中国工业设备采集器统一。
• 合规说明： 遵守网站 robots.txt；仅采集公开的企业与设备信息，不采集联系人姓名、手机号码、微信/QQ 等个人信息。
• 计费： 按结果计费：列表数据每 1,000 条 $1.00，含详情每 1,000 条 $3.00（每条只计费一次），每次运行另收 $0.005；更高等级的 Apify 套餐自动享受折扣。平台算力已包含；如自备代理（例如住宅代理），代理流量费用由您的代理服务商收取，不含在本工具价格内。

What you get

• Complete model catalog by category, brand and sale status (on sale / discontinued)
• Normalized brand, model code, category path and main image
• Key specs straight from the listing (2 values per model), or the full spec sheet (20-60 lines: engine, weights, dimensions, hydraulics...) with includeDetails
• Parsed numeric helpers: ext_operatingWeightKg, ext_enginePowerKw
• Model update date, image gallery and authorized dealers (company name / region / address) as options

Who is it for

Market analysts, OEM and dealer competitive-intelligence teams, spec-comparison tools, leasing / valuation models that need a clean Chinese-market model & spec database, and data teams enriching their machinery taxonomy.

Input

Field	Description
section	new_catalog (the only live section)
categories	Dropdown with the site's full category tree (19 groups, 129 subcategories; codes such as 101001, 101002, 102). Picking a group (“Excavators (all)”) downloads all its subcategories, each crawled as its own listing. Empty = whole catalog
brands	Dropdown with the 513 brands of the site (“SANY · 三一”); you can also type Chinese names, aliases (sany, xcmg, komatsu, caterpillar...) or site brand ids
keyword	Case-insensitive filter on title/brand, applied while paging
saleStatus	on_sale (default), discontinued, all
maxItems	Default 100, 0 = unlimited
includeDetails	Fetch each model page (+1 request/model)
includeFullSpecs	With details: also fetch the parameter page (+1 request/model), default on
includeSellerContact	With details: add ext_dealers (company data only, no phones)
maxConcurrency / requestDelayMs	Default 3 / 500 ms (be polite)
proxyUrl	Optional, e.g. http://user:pass@gate.decodo.com:7000

Example:

{ "categories": ["101001"], "brands": ["sany", "xcmg"], "maxItems": 50, "includeDetails": true }

Output

Field	Type	Notes
source, sourceSection	string	21-sun.com, new_catalog
listingId, url	string	Site model id and page
title, brand, model	string	Chinese title; brand; model code parsed from the title
category, categoryPath	string / list	Category (and sub-category with details)
condition	string	always new
priceCny, priceText, priceType	null / null / on_request	Site publishes no prices
year, hours, location, seller	empty	Not applicable to a new-model catalog
images	list	Absolute https URLs
specs	object	Spec name -> value, Chinese keys as published
updatedAt	string	Model page update date (with details)
qualityFlags	list	price_on_request, category_missing, model_unparsed, specs_missing, no_image, detail_fetch_failed
ext_categoryCode, ext_categoryEn, ext_saleStatus, ext_operatingWeightKg, ext_enginePowerKw, ext_onPromotion, ext_dealers	various	Site-specific extras
scrapedAt	string	UTC ISO 8601

Sample item (includeDetails=true):

{
  "source": "21-sun.com",
  "sourceSection": "new_catalog",
  "listingId": "20379",
  "url": "https://product.21-sun.com/proDetail/20379.shtm",
  "title": "厦工XG955K轮式装载机",
  "category": "轮式装载机",
  "categoryPath": [
    "装载机",
    "轮式装载机"
  ],
  "brand": "厦工",
  "model": "XG955K",
  "year": null,
  "hours": null,
  "condition": "new",
  "priceCny": null,
  "priceText": null,
  "priceType": "on_request",
  "location": {
    "province": null,
    "city": null,
    "raw": null
  },
  "seller": {
    "name": null,
    "type": null,
    "shopUrl": null
  },
  "images": [
    "https://product.21-sun.com/uploadfiles/image/2025/06/20250624144127_366.jpg"
  ],
  "specs": {
    "斗容": "2.2-4.5m3",
    "额定载重量": "5000kg",
    "工作重量": "17200kg",
    "额定功率": "162kw",
    "挖掘力": "180kN",
    "最大牵引力": "165kN"
  },
  "postedAt": null,
  "updatedAt": "2025-12-29",
  "qualityFlags": [
    "price_on_request"
  ],
  "scrapedAt": "2026-10-20T22:55:51+00:00",
  "ext_categoryCode": "101002007",
  "ext_categoryEn": "Wheel loaders",
  "ext_saleStatus": "on_sale",
  "ext_operatingWeightKg": 17200,
  "ext_enginePowerKw": 162.0,
  "ext_onPromotion": false,
  "ext_detailFetched": true
}

Cost and speed

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 (Include model details off)	$1.00	$0.90	$0.85	$0.75	$0.65	$0.60
Detailed result (Include model details on)	$3.00	$2.70	$2.55	$2.25	$1.95	$1.80

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 ≈ $3.00; 10,000 listing-only items ≈ $10.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.

Mode	Requests / item	Speed (3 concurrent, 500 ms delay)
Listing only	~0.03	~2-13 s per 100 models
includeDetails (no full specs)	~1.03	~2-3 min per 100 models
includeDetails + full specs	~2.03	~3-4 min per 100 models

The whole catalog (~31,000 models) is ~970 listing pages. Raise maxConcurrency (max 10) for details runs.

Limits

• No prices and no used listings (see above).
• Picking a group crawls its subcategories, not the group page. A few models are classified only at group level on the site and are then not returned (aerial work equipment ~7 %, piling machinery ~6 %, graders/scrapers, port machinery); leave categories empty to get the whole catalog. Subcategories can overlap (commercial vehicles); models are deduplicated.
• category is empty for whole-catalog runs unless includeDetails is on; select categories to fill it.
• keyword is a client-side filter (the site has no usable search endpoint), so combine it with a category/brand.
• Specs are in Chinese as published; spec keys vary by model.
• The site may throttle or block heavy parallel scraping from some regions; the actor retries with backoff and logs blocks.

FAQ

Can I get prices? Not from this site: it only offers dealer quotes after an inquiry. Why only 2 specs per model without details? That's all the listing shows; enable includeDetails for the full sheet. Is personal data collected? No. Only product data and, optionally, authorized-dealer company name, region and address. Is scraping allowed? The actor only requests public catalog pages that are not disallowed by the site's robots.txt, at a low request rate. You are responsible for complying with applicable laws and the site's terms.