# PCauto.com.cn Car Catalog & Price Scraper (`bovi/pcauto-scraper`) Actor

Scrape the pcauto.com.cn (太平洋汽车) new-car catalog: car series with brand, manufacturer, vehicle class, powertrain, official price range in CNY, sale status, monthly sales, tags and every trim with its price. Filter by brand and price. No login.

- **URL**: https://apify.com/bovi/pcauto-scraper.md
- **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community)
- **Categories:** E-commerce, Automation
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.60 / 1,000 pcauto.com.cn car catalog & price scrapers

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

## PCauto.com.cn Car Catalog & Price Scraper

Scrape the new-car catalog of **pcauto.com.cn** (太平洋汽车, PCauto), one of China's largest automotive portals.
The Actor reads the site's public car-selection catalog (选车) and returns one record per **car series**
(e.g. a model line like 速腾 or 秦PLUS) with the official price range, brand, manufacturer, vehicle class,
powertrain, sale status, latest monthly sales and the full list of trims with their official prices.
No login and no browser are needed — the data comes from the same public JSON endpoint the site uses.

### What it collects

- Series ID, name and page URL on price.pcauto.com.cn
- Brand and manufacturer (with pcauto IDs)
- Vehicle class (紧凑型SUV, 中型车, MPV ...) and powertrain types (燃油, 纯电, 插混, 增程)
- Official price range as shown (`12.99-16.69万`) plus numeric `minPriceCny` / `maxPriceCny` in CNY
- Sale status (`on_sale` / `upcoming`), new-car flag, number of trims
- Latest monthly sales figure and label
- Usage tags and selling-point highlights
- Series image, brand logo, links to the price, specification and photo pages
- Optional `trims`: every trim (model version) with name, model year, official price and URL

### Input

| Field | Description |
|---|---|
| `brands` | Optional list of brand names as written on the site (大众, 比亚迪, 丰田 ...) or numeric pcauto brand IDs. Empty = whole catalog (~1,500 series). |
| `minPrice` / `maxPrice` | Optional price bounds in 万 (10,000 CNY), e.g. 10 and 20 = 100k–200k CNY. |
| `sort` | `popularity` (default), `price_asc`, `price_desc`, `newest`, `oldest`. |
| `includeTrims` | Add the trim list to every record (default `true`). |
| `maxResults` | Maximum number of car series to save (default 50). |
| `proxyConfiguration` | Optional. Works with Apify datacenter proxy or without a proxy. |

Example input:

```json
{
  "brands": ["大众", "比亚迪"],
  "minPrice": 10,
  "maxPrice": 30,
  "sort": "popularity",
  "includeTrims": true,
  "maxResults": 100
}
```

### Example output

```json
{
  "seriesId": 31271,
  "title": "ID.AURA T6",
  "url": "https://price.pcauto.com.cn/sg31271/",
  "brandId": 2,
  "brand": "大众",
  "manufacturerId": 2,
  "manufacturer": "一汽-大众",
  "vehicleClass": "中型SUV",
  "energyTypes": ["纯电"],
  "priceText": "12.99-16.69万",
  "minPriceCny": 129900,
  "maxPriceCny": 166900,
  "currency": "CNY",
  "saleStatus": "on_sale",
  "isNewCar": false,
  "trimCount": 4,
  "monthlySales": 111,
  "monthlySalesText": "2026年9月销量：111",
  "tags": ["智驾先锋", "经济代步"],
  "highlights": ["纯电长续航", "充电快"],
  "imageUrl": "https://img.pcauto.com.cn/images/upload/upc/tx/auto5/2609/21/c8/765589525_1789964747932_400x300.jpg",
  "priceUrl": "https://www.pcauto.com.cn/sg31271/price/",
  "configUrl": "https://price.pcauto.com.cn/sg31271/config.html",
  "photosUrl": "https://price.pcauto.com.cn/cars/sg31271/",
  "trims": [
    {"trimId": 142221, "name": "ID.AURA T6 2026款 540 Pro", "modelYear": 2026, "yearLabel": "2026款",
     "priceText": "12.99万", "priceCny": 129900, "url": "https://price.pcauto.com.cn/m142221/"}
  ],
  "scrapedAt": "2026-10-31T06:30:00+00:00"
}
```

### Price per result

This Actor uses **pay per result** pricing: you pay only for the car-series records saved to the dataset, at the
per-result price shown on the Actor's Pricing tab. There is no start fee. Use `maxResults` to cap the cost of a run
exactly.

### Use cases

China car-market research, MSRP monitoring by brand or price band, EV/PHEV line-up tracking, competitor
benchmarking and building automotive datasets.

# Actor input Schema

## `brands` (type: `array`):

Optional. Brand names as shown on pcauto.com.cn (Chinese, e.g. 大众, 比亚迪, 丰田) or numeric pcauto brand IDs (e.g. 2). Leave empty to scrape the whole catalog.

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

Optional. Lower bound of the series price range in 万 (10,000 CNY), e.g. 10 = 100,000 CNY.

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

Optional. Upper bound of the series price range in 万 (10,000 CNY), e.g. 30 = 300,000 CNY.

## `sort` (type: `string`):

Order in which pcauto.com.cn returns car series.

## `includeTrims` (type: `boolean`):

Add the list of trims (model versions) with their official prices to each car series.

## `maxResults` (type: `integer`):

Maximum number of car series to save.

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

Optional proxy settings. pcauto.com.cn works with Apify datacenter proxy or without a proxy.

## Actor input object example

```json
{
  "brands": [
    "大众",
    "比亚迪"
  ],
  "sort": "popularity",
  "includeTrims": true,
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

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

Dataset with the scraped car series.

# 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 = {
    "brands": [
        "大众",
        "比亚迪"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("bovi/pcauto-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 = {
    "brands": [
        "大众",
        "比亚迪",
    ],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("bovi/pcauto-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 '{
  "brands": [
    "大众",
    "比亚迪"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call bovi/pcauto-scraper --silent --output-dataset

```

## MCP server setup

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