# Autohome China Car Series & Trim Price Finder (`crawlyth-forge/autohome-china-car-series-and-trim-price-finder`) Actor

Browse Autohome.com.cn car series by brand letter or look up specific series by ID, with manufacturer guidance price range, vehicle class, per-trim models and rating.

- **URL**: https://apify.com/crawlyth-forge/autohome-china-car-series-and-trim-price-finder.md
- **Developed by:** [crawlyth forge](https://apify.com/crawlyth-forge) (community)
- **Categories:** Automation, Developer tools, Other
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

## Autohome China Car Series & Trim Price Finder

[Autohome](https://www.autohome.com.cn/) (汽车之家) is one of China's largest car information portals, listing every brand sold in the country with manufacturer guidance prices and per-trim specs. This actor reads Autohome's public brand index and series pages directly, so you can pull a brand's full series catalogue or the detail of specific series without logging in.

### What this actor does

- Walks the Autohome brand index one Pinyin letter at a time and lists every car series under every brand starting with that letter
- Fetches full detail for one or more specific series IDs or series URLs, including per-trim models and photos
- Filters results by starting price band (in 万 / 10k CNY) or by a keyword in the series name
- Emits a typed error record (instead of silently skipping) when a series ID is invalid or its page can't be fetched or parsed
- Omits any field it could not find on the page — no blank or placeholder values

### Output per record

#### Mode: Browse series by brand letter (`byBrand`)

- `seriesId` — Autohome's internal series ID
- `name` — series name, e.g. 奥迪A3
- `brandId`, `brandName` — the brand this series belongs to
- `carClass` — vehicle class from the brand page (轿车/SUV/MPV etc.), when shown
- `subBrand` — sub-brand label from the brand page (e.g. 一汽奥迪), when shown
- `priceMinWan`, `priceMaxWan` — manufacturer guidance price range in 万 (10k CNY), only present for series that appear in the brand page's priced hot-list
- `url` — series detail page link
- `recordType` — `"car"`
- `sourceUrl`, `scrapedAt`

#### Mode: Fetch series details by ID (`bySeriesId`)

- `seriesId`, `name`
- `priceMinWan`, `priceMaxWan` — full guidance price range parsed from the series page
- `rating` — Autohome user rating (用户评分), when published
- `models[]` — one entry per trim: `name`, `status`, `drivetrain`, `gearbox`, `priceWan`
- `keywords`, `description` — the page's own meta keywords/description
- `images[]` — series photo thumbnails visible on the page
- `url`, `recordType` (`"car"`), `sourceUrl`, `scrapedAt`

#### Error records

When a series ID can't be resolved, fetched or parsed, the actor emits `recordType: "error"` with `errorCode`, `errorMessage`, `sourceUrl`, `scrapedAt` instead of dropping the input silently.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | select | `byBrand` | `byBrand` (series list for a brand letter) or `bySeriesId` (single series detail) |
| `brand` | select | `A` | First letter of the brand (A-Z), used with `mode=byBrand` |
| `seriesIds` | array | `[]` | Autohome series IDs or series page URLs, used with `mode=bySeriesId` |
| `minPrice` | number | – | Drop series whose starting price (万) is below this |
| `maxPrice` | number | – | Drop series whose starting price (万) is above this |
| `containsKeyword` | string | – | Only emit series whose name contains this text |
| `maxItems` | integer | `10` | Hard cap on emitted records |

#### Example: browse all BMW-letter series under 50万

```json
{
  "mode": "byBrand",
  "brand": "B",
  "maxPrice": 50,
  "maxItems": 100
}
```

#### Example: fetch detail for two specific series

```json
{
  "mode": "bySeriesId",
  "seriesIds": ["18", "https://car.autohome.com.cn/price/series-3170.html"]
}
```

#### Example: keyword filter on an Audi-letter browse

```json
{
  "mode": "byBrand",
  "brand": "A",
  "containsKeyword": "A3",
  "maxItems": 50
}
```

### Use cases

- **Market mapping** — build a catalogue of every series a brand sells in China, with guidance price bands
- **Pricing research** — compare 指导价 ranges across series or brands at a given letter
- **Trim-level comparisons** — pull `models[]` for a series to see every trim's drivetrain, gearbox and price
- **Catalogue monitoring** — re-run `bySeriesId` on a fixed list of series to track rating or price changes over time

### FAQ

**Is this affiliated with Autohome?** No. This is an independent tool that reads Autohome's public brand and series pages; it is not operated by or affiliated with Autohome (汽车之家).

**Why do some series have no `priceMinWan`/`priceMaxWan` in `byBrand` mode?** The brand page only publishes a guidance price next to series in its own priced "hot list" block, which is a subset of the full series list. Series outside that block still appear in the output, just without a price. Use `bySeriesId` on that series for its full price range.

**Why is `minPrice`/`maxPrice` filtering out series I expected to see?** Both filters compare against `priceMinWan`. When either bound is set, series without a parsed guidance price are excluded rather than passed through, so an impossible range (`minPrice` above `maxPrice`) cleanly returns zero records instead of silently ignoring the filter.

**Do I need a login or API key?** No. Brand and series pages are public.

**What's the difference between the two modes?** `byBrand` is a discovery mode: it lists every series under one brand letter with light detail. `bySeriesId` is a lookup mode: it fetches the full series page for specific series, including per-trim models, rating and photos.

**Why is `images[]` sometimes short or missing?** Only thumbnails visible directly on the series page are included; full photo galleries that load via additional scripts are not fetched. Generic loading/placeholder graphics are filtered out.

**Can I pass a series URL instead of an ID in `seriesIds`?** Yes — both plain numeric IDs (`18`) and full series page URLs are accepted.

**Why are brand letters limited to A-Z?** Autohome's current brand index only publishes a Pinyin A-Z letter index; there is no separate digit index to browse.

# Actor input Schema

## `mode` (type: `string`):

What to fetch: byBrand (series list for a brand letter) or bySeriesId (single series detail).

## `brand` (type: `string`):

First letter of the brand (A-Z), e.g. `A` for Audi, `B` for BMW.

## `seriesIds` (type: `array`):

Autohome series IDs or series page URLs, e.g. `18` or `https://car.autohome.com.cn/price/series-18.html`.

## `minPrice` (type: `number`):

Drop series whose starting price (万) is below this.

## `maxPrice` (type: `number`):

Drop series whose starting price (万) is above this.

## `containsKeyword` (type: `string`):

Only emit series whose name contains this text.

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

Hard cap on emitted records.

## Actor input object example

```json
{
  "mode": "byBrand",
  "brand": "A",
  "seriesIds": [],
  "maxItems": 10
}
```

# Actor output Schema

## `series` (type: `string`):

Dataset containing all scraped Autohome car series records.

# 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 = {
    "mode": "byBrand",
    "brand": "A",
    "seriesIds": [],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlyth-forge/autohome-china-car-series-and-trim-price-finder").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 = {
    "mode": "byBrand",
    "brand": "A",
    "seriesIds": [],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlyth-forge/autohome-china-car-series-and-trim-price-finder").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 '{
  "mode": "byBrand",
  "brand": "A",
  "seriesIds": [],
  "maxItems": 10
}' |
apify call crawlyth-forge/autohome-china-car-series-and-trim-price-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawlyth-forge/autohome-china-car-series-and-trim-price-finder"
        }
    }
}
```

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/zJz4QZXleoKm9CRTq/builds/3oefIggUUgnyn0JTP/openapi.json
