API — Руководство пользователя

Схема работы

Шаг 1 — Поиск автомобилей

POST /che168/search_car

Запрос: фильтры (бренд, цена, год, пробег, пагинация, сортировка).

Ответ: список автомобилей. Каждый объект содержит infoid, specid и основные поля.

{
  "cars": [
    {
      "infoid": 58425637,
      "carname": "Audi A3 2022 A3l Limousine 35 Tfsi ...",
      "price_cny": 153800,
      "total_price_rub": 3854420,
      "specid": 62663,
      "mileage": 9,
      ...
    }
  ]
}

Поле specid — идентификатор спецификации/комплектации. Через него запрашиваются технические характеристики.

Требуемый тариф: search

---

Шаг 2 — Детальная информация (до 100 за запрос)

POST /che168/batch_car_info

{
  "infoids": [58425637, 58516696],
  "include_spec_params": false
}

Ответ: для каждого infoid — 5 категорий данных с переводом на английский:

Дополнительно в каждый ответ автоматически включается pricing_finance — расчёт

таможенных платежей и итоговой цены (доступен на всех тарифах, без подключения опций).

Требуемый тариф: car_info

---

Шаг 2b — Детальная информация + технические характеристики

POST /che168/batch_car_info

{
  "infoids": [58425637, 58516696],
  "include_spec_params": true
}

Добавляет к ответу поле spec_params — технические характеристики по specid автомобиля (автоматически извлекается из данных). Набор секций зависит от наличия данных в БД (см. раздел Типы specid).

Требуемый тариф: car_info + car_param

---

Шаг 3 — Получение specid для старых выгрузок

POST /che168/get_specid

Если у вас есть CSV-выгрузка, сделанная до 21.05.2026 — в ней нет колонки specid. Этот эндпоинт позволяет дозаполнить:

{
  "infoids": [58425637, 58516696]
}

Ответ:

{
  "58425637": 62663,
  "58516696": 32017,
  "99999999": null
}

Требуемый тариф: search

---

Шаг 4 — Технические характеристики по отобранным specid

POST /che168/get_spec_params

Если вы уже получили batch_car_info без include_spec_params и хотите дозапросить тех. характеристики для части автомобилей:

{
  "specids": [62663, 32017]
}

Требуемый тариф: car_param

---

Типы specid

Новые specid (94% записей, ~29500 шт.)

Содержат полный набор секций — от 23 до 33, в зависимости от комплектации автомобиля. Каждая секция содержит массив data с полями name и content (переведены на английский).

Полный список секций

> Не все секции заполнены у каждой машины. Среднее количество — 23-24 секции на автомобиль. Чем богаче комплектация, тем больше секций.

---

Старые specid (6% записей, ~1800 шт.)

Содержат базовый набор из 7 секций с основными данными об автомобиле. Формат данных — тот же (структура sections с title и data), но количество полей ограничено.

> Старые specid не могут быть дополнены до полного набора — исходные данные (che168.com) не содержат детальной спецификации для этих автомобилей.

---

Как отличить новый specid от старого

Через get_spec_params — по количеству секций:

• 23-33 секции — новый specid, полные данные
• 7 секций — старый specid, базовые данные
• null — данные отсутствуют

Либо через search_car — если specid найден, количество секций можно проверить через get_spec_params.

---

Сводная таблица эндпоинтов

---

Описание тарифов

Dev (0 ₽)

Ознакомительный. Поиск с фильтрами, расчёт таможенных платежей, но только каждый 50-й автомобиль в выдаче. Подходит для интеграции, тестирования, оценки формата данных. Для реального использования не предназначен.

Базовый (3 000 ₽/мес)

Витрина. Поиск по всем автомобилям без семплирования + расчёт таможенных платежей. Базовая информация из поиска: марка, модель, год, пробег, цена, комплектация. Хватает для сбора статистики и поверхностного анализа рынка, но без погружения в детали.

Базовый + Расширенная информация (5 000 ₽/мес)

Детальная карточка. Добавляет 5 категорий данных по каждому автомобилю: характеристики двигателя и КПП, историю и состояние, фотографии. Позволяет оценить автомобиль без перехода на che168.

Базовый + Расширенная информация + Технические характеристики (7 000 ₽/мес)

Полный справочник. Добавляет 23–33 секции технических параметров с переводом на английский: от подушек безопасности и мультимедиа до электродвигателя и систем помощи водителю. Весь набор данных, который существует по автомобилю на китайском рынке.

---

Формат авторизации

Все запросы требуют заголовок:

Authorization: Bearer 

Пример:

Authorization: Bearer che168-uwSaKqi7M9BHqwlmV

Получение токена: [https://t.me/api_centr_regbot](https://t.me/api_centr_regbot)