API источника · Che168 · Китай

# API Che168 для авто из Китая — в JSON, без своего парсера

Che168 — площадка подержанных авто сервиса Autohome: машины выставляют дилеры по всему Китаю. apiauto.space отдаёт каждое объявление Che168 в той же записи, что у Encar, Copart и IAAI: цена в юанях и долларах, пробег, фото, город, коробка, объём и мощность двигателя и все поля источника. Марки и модели — официальными латинскими названиями, китайский прокси не нужен.

- **Источник**: che168.com · market=cn
- **Регион**: Китай
- **Данные**: Объявления дилеров, цены, фото, изменения
- **Статус**: Работает · обновление каждый час

## Что содержит запись Che168

Одни и те же ключи у всех рынков; справа — значения настоящей машины из каталога. Чего Che168 не даёт, приходит как null, а не догадка.

### Машина

- `title` Год, марка и модель одной строкой `"2024 Jaguar XEL"`
- `brand` Официальное латинское название `"Jaguar"`
- `model` Семейство модели, как на других рынках `"XEL"`
- `trim` Полное название версии у Che168 `"Jaguar Xel 2024 2.0t 250ps R-Dyn…`
- `year` Год выпуска `2024`
- `mileage_km` Пробег в километрах `10000`

### Характеристики

- `fuel` Топливо, каноническое значение `"gasoline"`
- `transmission` Коробка передач `"automatic"`
- `engine_cc` Объём двигателя, см³ `1997`
- `body_type` Кузов `"sedan"`
- `color` Цвет `"Green"`
- `raw.power_hp` Мощность, л. с. `250`
- `raw.drive` Привод: fwd, rwd, awd `"fwd"`

### Цена

- `price` Цена дилера в юанях `126800.00 CNY`
- `price_usd` Та же цена в долларах `"18925.15"`
- `raw.fx.usd_per_unit` Дневной курс ЕЦБ, по которому посчитано `"0.1492519823"`

### Место и фото

- `location.city` Город дилера `"Shenzhen"`
- `photo_count` Сколько фото выложил дилер `9`
- `photos.0` Подписанная ссылка, живёт около суток `"api.apiauto.space/img/che168:599…`
- `listing_url` Объявление на che168.com `"www.che168.com/dealer/534107/599…`

### Только у Che168 · raw

- `raw.first_registration` Дата первой регистрации `"2024-10-01"`
- `raw.imported` Импортная или собрана в Китае `false`
- `raw.power_kw` Мощность, кВт `184`
- `raw.che168_infoid` Номер объявления на Che168 `"59997083"`
- `raw.source_values.city` Исходное написание города `"深圳 (Shenzhen)"`

### Che168 не даёт

- `vin` VIN источник не передаёт `null`
- `location.region` Провинции нет — только город `null`
- `raw.seats` Число мест — только если дилер указал `null`

che168:59997083 2024 Jaguar XEL · 10 000 км

## Запрос и ответ

Четыре запроса, с которых обычно начинают. Ключ — в заголовке X-API-Key, ответ — JSON.

Страница машин по фильтрам и курсор следующей

GET

`https://api.apiauto.space/v1/cars?market=cn&limit=2`

cURL:

```bash
curl -s "https://api.apiauto.space/v1/cars?market=cn&limit=2" \
  -H "X-API-Key: $APIAUTO_KEY"
```

JavaScript:

```js
const response = await fetch(
  "https://api.apiauto.space/v1/cars?market=cn&limit=2",
  { headers: { "X-API-Key": process.env.APIAUTO_KEY } },
);
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const data = await response.json();
```

Python:

```python
import os
import httpx

data = httpx.get(
    "https://api.apiauto.space/v1/cars?market=cn&limit=2",
    headers={"X-API-Key": os.environ["APIAUTO_KEY"]},
    timeout=30,
).raise_for_status().json()
```

PHP:

```php
<?php
$ch = curl_init("https://api.apiauto.space/v1/cars?market=cn&limit=2");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
```

200 OK · пример ответа:

```json
{
  "items": [
    {
      "id": "che168:59997083",
      "market": "cn",
      "source": "che168",
      "source_id": "59997083",
      "title": "2024 Jaguar XEL",
      "brand": "Jaguar",
      "model": "XEL",
      "trim": "Jaguar Xel 2024 2.0t 250ps R-Dynamic S Aggressive Sports Version",
      "year": 2024,
      "mileage_km": 10000,
      "fuel": "gasoline",
      "transmission": "automatic",
      "engine_cc": 1997,
      "body_type": "sedan",
      "color": "Green",
      "vin": null,
      "price": {
        "amount": "126800.00",
        "currency": "CNY"
      },
      "price_usd": "18925.15",
      "location": {
        "country": "CN",
        "region": null,
        "city": "Shenzhen"
      },
      "photos": [
        "https://api.apiauto.space/img/che168:59997083/1.jpg?exp=…&sig=…",
        "https://api.apiauto.space/img/che168:59997083/2.jpg?exp=…&sig=…"
      ],
      "photo_count": 9,
      "listing_url": "https://www.che168.com/dealer/534107/59997083.html",
      "is_active": true,
      "first_seen_at": "2026-09-22T16:29:11.202005Z",
      "last_seen_at": "2026-09-22T16:29:11.202005Z",
      "disappeared_at": null,
      "updated_at": "2026-09-22T16:29:11.202005Z",
      "raw": {
        "fx": {
          "date": "2026-09-22",
          "source": "ECB",
          "currency": "CNY",
          "usd_per_unit": "0.1492519823"
        },
        "drive": "fwd",
        "seats": null,
        "imported": false,
        "power_hp": 250,
        "power_kw": 184,
        "image_count": 9,
        "che168_infoid": "59997083",
        "source_values": {
          "city": "深圳 (Shenzhen)",
          "fuel": "Gasoline",
          "brand": "Jaguar",
          "drive": "Front Wheel Drive",
          "model": "Jaguar Xel",
          "body_type": "Sedan",
          "transmission": "Automatic"
        },
        "first_registration": "2024-10-01"
      },
      "source_mode": "replica"
    },
    {
      "id": "che168:59997082",
      "market": "cn",
      "source": "che168",
      "source_id": "59997082",
      "title": "2024 Audi Q5L",
      "brand": "Audi",
      "model": "Q5L",
      "trim": "Audi Q5l 2024 40 Tfsi Fashionable And Dynamic",
      "year": 2024,
      "mileage_km": 23900,
      "fuel": "gasoline",
      "transmission": "automatic",
      "engine_cc": 1984,
      "body_type": "suv",
      "color": "White",
      "vin": null,
      "price": {
        "amount": "189800.00",
        "currency": "CNY"
      },
      "price_usd": "28328.03",
      "location": {
        "country": "CN",
        "region": null,
        "city": "Xi'an"
      },
      "photos": [
        "https://api.apiauto.space/img/che168:59997082/1.jpg?exp=…&sig=…",
        "https://api.apiauto.space/img/che168:59997082/2.jpg?exp=…&sig=…"
      ],
      "photo_count": 9,
      "listing_url": "https://www.che168.com/dealer/662578/59997082.html",
      "is_active": true,
      "first_seen_at": "2026-09-22T16:29:11.202005Z",
      "last_seen_at": "2026-09-22T16:29:11.202005Z",
      "disappeared_at": null,
      "updated_at": "2026-09-22T16:29:11.202005Z",
      "raw": {
        "fx": {
          "date": "2026-09-22",
          "source": "ECB",
          "currency": "CNY",
          "usd_per_unit": "0.1492519823"
        },
        "drive": "awd",
        "seats": null,
        "imported": false,
        "power_hp": 190,
        "power_kw": 140,
        "image_count": 9,
        "che168_infoid": "59997082",
        "source_values": {
          "city": "西安 (Xi'an)",
          "fuel": "Gasoline",
          "brand": "Audi",
          "drive": "All Wheel Drive",
          "model": "Audi Q5l",
          "body_type": "SUV",
          "transmission": "Automatic"
        },
        "first_registration": "2024-01-01"
      },
      "source_mode": "replica"
    }
  ],
  "next_cursor": "…",
  "count": null
}
```

Машины в ответах настоящие, из каталога на момент сборки сайта; фото сокращены до двух, id событий условные.

## Соберите запрос

Выберите фильтры — адрес и код соберутся сами. Рынок закреплён: market=cn отдаёт только машины Che168.

GET

`https://api.apiauto.space/v1/cars?market=cn&brand=Mercedes-Benz&limit=20`

cURL:

```bash
curl -s "https://api.apiauto.space/v1/cars?market=cn&brand=Mercedes-Benz&limit=20" \
  -H "X-API-Key: $APIAUTO_KEY"
```

JavaScript:

```js
const response = await fetch(
  "https://api.apiauto.space/v1/cars?market=cn&brand=Mercedes-Benz&limit=20",
  { headers: { "X-API-Key": process.env.APIAUTO_KEY } },
);
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const data = await response.json();
```

Python:

```python
import os
import httpx

data = httpx.get(
    "https://api.apiauto.space/v1/cars?market=cn&brand=Mercedes-Benz&limit=20",
    headers={"X-API-Key": os.environ["APIAUTO_KEY"]},
    timeout=30,
).raise_for_status().json()
```

PHP:

```php
<?php
$ch = curl_init("https://api.apiauto.space/v1/cars?market=cn&brand=Mercedes-Benz&limit=20");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
```

## Сценарии

1. **Каталог на сайте импортёра** — 01 Каталог на сайте импортёраМашины Che168 с фото, характеристиками и ценой в долларах на вашем сайте; раз в час подтягиваете новые и снятые по ленте изменений. Метод`GET /v1/cars · /v1/changes`
2. **Подбор под клиента** — 02 Подбор под клиентаМенеджер ищет по марке, году, пробегу и бюджету и отправляет клиенту фото, мощность и ссылку на объявление. Метод`GET /v1/cars?brand=…&year_min=…`
3. **Слежение за ценами дилеров** — 03 Слежение за ценами дилеровЛента price_drop показывает, какие машины подешевели с прошлого опроса, с порогом в процентах. Метод`GET /v1/changes?type=price_drop`
4. **Telegram-бот подбора** — 04 Telegram-бот подбораБот сам присылает клиенту свежие машины из Китая по его фильтру: новые поступления приходят событием added. Метод`GET /v1/changes?type=added`

## Об источнике

Что есть только у Che168, какие марки в каталоге и где проходят границы данных.

### Поля Che168 в raw

| Поле | Что значит |
| --- | --- |
| `drive` | Привод: fwd, rwd, awd. |
| `power_hp`, `power_kw` | Мощность в л. с. и кВт. |
| `first_registration` | Дата первой регистрации. |
| `imported` | Импортная машина или собранная в Китае. |
| `seats` | Число мест, если дилер его указал. |
| `image_count`, `che168_infoid` | Число фото и номер объявления на Che168. |
| `source_values` | Исходные написания марки, модели, города, топлива, привода, кузова и коробки. |
| `fx` | Курс, по которому посчитан `price_usd`. |

### Марки Che168 в каталоге

Самые частые марки каталога; параметр `brand` находит их в таком написании, регистр, пробелы и дефисы не важны.

| Марка | Машин в каталоге |
| --- | --- |
| Mercedes-Benz | 20 036 |
| Volkswagen | 19 090 |
| BMW | 17 702 |
| Audi | 13 239 |
| Toyota | 11 710 |
| Honda | 7 849 |
| BYD | 7 826 |
| Buick | 6 998 |
| Porsche | 5 862 |
| Tesla | 5 840 |
| Land Rover | 5 164 |
| Geely | 5 019 |

Полный список с числом машин — `GET /v1/references/brands?market=cn`. Справочники бесплатны и квоту не тратят.

### Новые машины и изменения цен

Лента `GET /v1/changes?market=cn&since=…` отдаёт новые машины, снятые с продажи и изменения цены дилера с порогом в процентах — на тарифах Pro и Max и в демо. Каждое событие — одна запись квоты.

### Границы данных Che168

- VIN нет ни у одной машины: источник его не передаёт.
- Цена — цена дилера в объявлении, в юанях; доставку и растаможку считаете вы.
- Только Che168: Dongchedi, Guazi и других площадок Китая в API нет.
- Снятые с продажи машины остаются в API ещё 14 дней с `is_active=false` .
- Возраст копии приходит в заголовке `X-Data-Age-Seconds` каждого ответа.

### Свой парсер Che168 или API

Свой парсер Che168 — это ещё и перевод китайских названий марок и моделей, хранение десятков фото на машину и ремонт после изменений сайта. [Парсер или готовый API — сравнение по пунктам](https://apiauto.space/parser-vs-api/).

## Частые вопросы

### 01Это официальный API Che168?

Нет. apiauto.space не связан с Che168 и Autohome. Мы держим копию каталога и отдаём её в своём едином формате через свой API.

### 02Почему у машин из Китая нет VIN?

Che168 его не передаёт. В поле vin — null: мы не угадываем значения. Всё, что источник дал, остаётся в raw.

### 03Как переводятся китайские названия?

Марки и модели приводим к официальным латинским названиям (например, AION Y, Volkswagen Lavida) вместо дословного перевода; исходные написания остаются в raw.source_values.

### 04Нужен ли китайский прокси?

Нет. Запросы идут к нашему API, а не к Che168; фото тоже отдаёт наш сервер.

### 05Есть ли Dongchedi, Guazi и другие площадки Китая?

Нет, из Китая в API только Che168.

### 06Сколько стоит API Che168?

Тариф Start — $59 в месяц за один рынок, например только Китай: 100 000 машин в месяц. Квота считает возвращённые машины, а не запросы. Демо — сутки и 100 запросов без оплаты.

## Другие API и руководства

- [API источника **API Encar**](https://apiauto.space/encar-api/)
- [API источника **API Copart**](https://apiauto.space/copart-api/)
- [API источника **API IAAI**](https://apiauto.space/iaai-api/)
- [Руководство **Каталог авто на сайт импортёра**](https://apiauto.space/importers/)
- [Разработчикам **Документация**](https://apiauto.space/docs/)

## Получите тестовый ключ Che168

- Сутки и 100 запросов бесплатно, без карты
- Все три рынка и лента изменений: Китай можно сравнить с Кореей и США
- Ключ приходит в Telegram за минуту — без формы и звонков

---

Страница: https://apiauto.space/che168-api/
