# che168 Used Car Listings (`bovi/che168-scraper`) Actor

Collect che168 used-car listings. Get URLs, names, prices, timestamps; mileage, year, and cover images when shown; else omitted. Use a public search or dealer inventory URL; no login. Rates: $0.00635/dataset item + $0.00005/Actor Start (Free plan).

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

## Pricing

from $6.35 / 1,000 che168 used car listings

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

## che168 Used Car Listings Scraper

For used-car inventory and price-monitoring work, this Actor collects publicly visible listing cards from che168.com through a public search or dealer inventory URL. It returns card-level car names, asking prices, listing URLs, and available mileage, year, and cover-image URLs without signing in to che168; Free-plan pricing is detailed below.

- Extract structured used-car listings from public che168 search and dealer inventory pages.
- Monitor asking prices and listing details across selected dealer inventories.
- Create dealer-inventory snapshots for used-car research and price monitoring.
- Retain each card’s listing URL and UTC extraction timestamp for downstream processing.
- Run from an Apify account without a che168 login; optional proxy settings can be supplied.

### What you get

The Actor reads listing cards and follows available pagination links while collecting up to the requested result limit. It does not open individual car detail pages, add dealer contact details, or add vehicle specifications that are absent from a card.

The Actor pushes each saved record to the dataset as it processes listing cards.

| Field | Type | Availability | Description |
|---|---|---|---|
| `url` | string | Required for a saved record | Public URL linked from the car listing card. |
| `carname` | string | Required for a saved record | Car name and trim shown on the card. |
| `price` | number | Required for a saved record | Asking price in ten-thousand RMB units (`万元`). |
| `mileage` | number | When shown | Odometer reading in ten-thousand-kilometer units. |
| `firstregyear` | string | When shown | Year displayed in the listing card. |
| `imageurl` | string | When shown | Cover image URL from the card. |
| `scrapedAt` | ISO 8601 string | Saved with each record | UTC timestamp when the record was extracted. |

> **Note:** Prices are reported in `万元`: a value of `37.68` means RMB 376,800. Mileage is reported in units of 10,000 kilometers when it appears on the source card.

### Sample output

One real record from the dataset sample:

```json
{
  "url": "https://www.che168.com/dealer/507024/59899787.html?offertype=110",
  "imageurl": "https://2sc2.autoimg.cn/escimg/g33/M03/80/55/f_m_autohomecar__Chto52quU9WAGboXAAGovxR06g0509.jpg",
  "carname": "普拉多 2019款 3.5L 自动TX-L尊享版",
  "price": 37.68,
  "mileage": 3.4,
  "firstregyear": "2020",
  "scrapedAt": "2026-10-27T08:51:37.788535+00:00"
}
```

### Pricing

This Actor uses pay-per-event billing.

- On the Free plan, `apify-default-dataset-item` costs **$0.00635 per event**. One event represents one scraped result with all fields.
- On the Free plan, `apify-actor-start` costs **$0.00005 per event** when the Actor starts. The number of start events depends on Actor memory, with one event per GB and a minimum of one event.
- Dataset-item charges for **1,000 results total $6.35 on Free**.
- Dataset-item charges for **10,000 results total $63.50 on Free**.
- The Apify Free plan includes **$5 of monthly platform usage credit**, and the $5 credit covers **1 full run (787 results = $4.99750 on Free)** when one Actor Start event is charged.
- You pay only for the events listed above. This Actor does not use the Pay per event + usage option, so the platform usage of your runs (compute, proxy traffic and storage) is not billed to you separately.

### How to use

1. **Open** the Actor in Apify and use your Apify account to start a run.
2. **Enter** a public HTTP or HTTPS che168.com search or dealer inventory URL.
3. **Set** `maxResults` to control the maximum number of records saved.
4. **Configure** the optional `proxyConfiguration` object if you want to provide proxy settings.
5. **Run** the Actor. It reads listing cards, follows available pagination links, skips duplicate listing URLs, and stops when it reaches the result limit.
6. **Repeat** the run through Apify Schedules, using daily as a starting point for listing or asking-price collection.

Example input:

```json
{
  "searchUrl": "https://dealers.che168.com/shop/507024/list/30_50/a0_0m10sdgscncgpi1ltocf0spex/",
  "maxResults": 50
}
```

Export the dataset as JSON or CSV, or read it through the Apify dataset API.

### Input parameters

| Parameter | What it does | Default |
|---|---|---|
| `searchUrl` | Public che168.com search or dealer inventory page to collect. The target must use HTTP or HTTPS and a `che168.com` host or subdomain. | `https://dealers.che168.com/shop/507024/list/30_50/a0_0m10sdgscncgpi1ltocf0spex/` |
| `maxResults` | Maximum number of car listing records to save; the maximum is `10000`. | `50` |
| `proxyConfiguration` | Optional proxy settings passed to the Actor’s proxy configuration. | — |

### Limits and edge cases

| Condition | What the buyer sees | What to do |
|---|---|---|
| The target is not an HTTP(S) URL on `che168.com` or one of its subdomains | URL validation fails before collection. | Provide a public che168 search or dealer inventory URL. |
| The page contains no recognized listing cards | The Actor logs a warning and stops. A challenge page or unsupported URL will not produce records. | Check that the URL displays public listing cards and try a suitable public listing page. |
| A listing card does not provide a URL, car name, or price that the parser can read | That card is not saved as a record. | Use a page with standard listing cards; optional fields can still be absent from individual records. |
| A page fetch raises an error | The error is logged and collection stops at that point. Records already pushed to the dataset remain available. | Review the run log, check the URL and access conditions, then run again if needed. |

### FAQ

#### How much does it cost to scrape che168 used-car listings?

On the Free plan, each scraped dataset item costs **$0.00635 per event**, and each Actor Start event costs **$0.00005 per event**. See Pricing for the worked example.

#### Why is my dataset empty?

The source page may have returned an anti-bot challenge, may not be a supported search or dealer inventory page, or may contain no listing cards that the Actor can recognize. Check that the URL is a public che168.com page displaying listing cards. A card also needs a readable listing URL, car name, and price to be saved.

#### Why did the Actor stop before reaching `maxResults`?

The Actor stops when it reaches `maxResults`, when a page contains no listing cards, or when a page fetch raises an error. In the fetch-error path, the Actor logs the error and stops; records pushed before that error remain in the dataset. Review the run log and verify the input URL.

#### Is it legal or allowed to collect public che168 data?

The Actor collects publicly visible listing cards from che168.com. Whether a particular collection or downstream use is legal or allowed depends on the source’s terms, applicable law, and your use case; review those requirements before running it. This Actor does not provide a legal guarantee.

### Related actors

- [Competitor Price Monitor](https://apify.com/bovi/competitor-price-monitor) — related for price-drop monitoring across store URLs.
- [Copart Lot Scraper](https://apify.com/bovi/copart-lot-scraper) — related for vehicle-auction data including lots, bids, and VINs.

# Actor input Schema

## `searchUrl` (type: `string`):

Paste a public che168 search or dealer inventory page URL. The prefilled dealer inventory URL is a working example.

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

Maximum number of car listings to save.

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

Optional proxy settings. The actor uses no proxy unless one is configured here.

## Actor input object example

```json
{
  "searchUrl": "https://dealers.che168.com/shop/507024/list/30_50/a0_0m10sdgscncgpi1ltocf0spex/",
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

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

Dataset with the scraped car listings.

# 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 = {
    "searchUrl": "https://dealers.che168.com/shop/507024/list/30_50/a0_0m10sdgscncgpi1ltocf0spex/",
    "maxResults": 50,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("bovi/che168-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 = {
    "searchUrl": "https://dealers.che168.com/shop/507024/list/30_50/a0_0m10sdgscncgpi1ltocf0spex/",
    "maxResults": 50,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("bovi/che168-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 '{
  "searchUrl": "https://dealers.che168.com/shop/507024/list/30_50/a0_0m10sdgscncgpi1ltocf0spex/",
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call bovi/che168-scraper --silent --output-dataset

```

## MCP server setup

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