CHE168 API

CHE168 API: объявления и каталог автомобилей из Китая

Тот же контракт, что и у Encar API: меняется только providerId. MotorFeed забирает данные CHE168, приводит их к общей схеме, пересчитывает цену из юаня и отдаёт готовый JSON для сайта, CRM или внутренней панели.

Попробовать API Написать в Telegram

уровня каталога: марка, серия, модификация

контракт API на оба источника — providerId=2 для CHE168

страны расчёта: MD, RU, UA и AE

списаний пакета за справочники каталога

карточка автомобиля

JSON

GET /vehicles/che168_58234901
  ?country=UA&currency=USD

{
  "title": "Li Auto L7 Pro, 2023",
  "vehicleIdentity": {
    "brand": "Li Auto",
    "model": "L7",
    "generation": "2023",
    "modification": "Pro"
  },
  "vehicleId": 58234901,
  "vin": "LRW1234567890****",
  "spec": {
    "firstRegistrationDate": "2023-04",
    "mileageKm": 24000,
    "displacementLiters": 1.5,
    "fuelType": "增程式",
    "transmission": "电动车单速变速箱",
    "driveType": "四驱",
    "color": "白色"
  },
  "advertisement": {
    "sourceCurrency": "CNY",
    "sourcePriceWan": 25.8,
    "sourcePrice": 258000,
    "region": "上海"
  },
  "condition": {
    "transferCount": 1,
    "inspectionExpiresAt": "2026-04",
    "certification": 1
  },
  "pricing": {
    "country": "UA",
    "currency": "USD",
    "sourcePrice": 35600,
    "fees": [
      { "code": "logistics", "amount": 3800 },
      { "code": "customs_duty", "amount": 3560 },
      { "code": "excise_tax", "amount": 1250 },
      { "code": "vat", "amount": 8842 }
    ],
    "total": 53052,
    "ratesUsed": { "CNY": 7.24, "UAH": 41.8 },
    "estimated": false
  }
}

Что даёт API

Что вы получаете из CHE168

Китайский рынок отдаётся теми же методами, что и корейский: одни и те же поля, одни и те же ключи сортировки, один и тот же формат ошибок.

Каталог

Марки, серии и модификации

Каскад справочников для фильтров: марка, серия и модификации, сгруппированные по годам выпуска. Ответы кэшируются и не расходуют пакет запросов.

Поиск

Выдача по объявлениям Китая

POST /search с providerId=2 принимает марку, серию, модификацию, цену, год и пробег. Ключи сортировки — те же, что и для Encar: newest, priceAsc, mileageAsc и остальные.

Карточка

Полные данные по автомобилю

По идентификатору вида che168_58234901 приходят характеристики, VIN при наличии, фотографии, метки объявления, дилер, регион и описание продавца.

Единая модель

Общий каталог с Encar

Марка, модель, поколение и модификация резолвятся в единый каталог MotorFeed, поэтому корейские и китайские автомобили ложатся в одни и те же фильтры витрины.

Цена

Пересчёт из юаня

Цена объявления приходит и в исходном формате 万, и в юанях, и пересчитанной в валюту клиента по вашим или серверным курсам.

Состояние

История эксплуатации

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

Каталог

Марки, серии, поколения и автомобили

Каскад устроен так же, как у Encar, но соответствует структуре китайского источника: марка, серия, затем модификации внутри года выпуска.

Марки

Полный список марок китайского рынка — местных и локализованных мировых.

GET /catalog/manufacturers?providerId=2

Серии

Серии внутри марки — то, что пользователь воспринимает как модель.

GET /catalog/model-groups?providerId=2

Модификации по годам

Модификации, сгруппированные по годам выпуска: год группы становится поколением, а сама модификация — самым глубоким уровнем фильтра.

GET /catalog/models?providerId=2

Автомобили

Выдача объявлений по собранным идентификаторам: список, общее количество и фасеты фильтров.

POST /search

Отдельного уровня комплектаций у CHE168 нет: источник не публикует его как самостоятельный справочник, поэтому /catalog/badges вернёт пустой список. Глубину фильтра закрывает модификация, а год выпуска из группы становится поколением в единой модели данных.

каскад каталога и поиск

HTTP

GET /catalog/manufacturers?providerId=2
GET /catalog/model-groups
  ?providerId=2&manufacturerCd=33
GET /catalog/models
  ?providerId=2&manufacturerCd=33&modelGroupCd=3170

POST /search
{
  "providerId": 2,
  "country": "UA",
  "currency": "USD",
  "filters": {
    "brandId": "33",
    "modelId": "3170",
    "year": { "min": 2022 },
    "mileage": { "max": 60000 }
  },
  "sort": "priceAsc",
  "limit": 20
}

Изображения

Фотографии с готовыми ссылками

Формат блока фотографий общий с Encar, поэтому код галереи на вашей стороне один на оба источника.

thumbnailUrl

Миниатюра для списка и выдачи поиска.

heroUrl

Кадр для обложки карточки автомобиля.

url

Ссылка для галереи.

Главное фото

Первый кадр помечен типом main, остальные приходят как галерея в порядке источника.

Только https

Ссылки источника приводятся к https, поэтому изображения не ломают страницу смешанным содержимым.

Без хранения у себя

Файлы не нужно скачивать и хранить: в ответе уже готовые адреса изображений.

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

Какие поля приходят по автомобилю

Состав ответа карточки для китайского источника. Структура секций совпадает с Encar, различается только наполнение, которое публикует сам источник.

Идентификация

Сквозной идентификатор вида che168_58234901
VIN при наличии
Марка, серия, поколение и модификация одной структурой
Идентификаторы источника: brandId, seriesId, specId, dealerId

Технические данные

Дата и год первой регистрации
Пробег в километрах
Объём двигателя в литрах и обозначение мотора
Коробка передач, привод и тип наддува
Тип топлива, цвет и экологический класс

Объявление

Цена в юанях и в исходном формате 万
Пересчёт в валюту клиента по вашим курсам
Регион, город и провинция
Дата публикации и число просмотров
Описание продавца и метки объявления

Состояние и расчёт

Число смен владельцев
Сроки действия техосмотра и страховки
Отметка сертификации и ссылка на отчёт продавца
Логистика, пошлина, акциз, НДС и сборы построчно, с итоговой суммой

Актуальность

Как обновляются данные

Запросы идут к источнику в момент вызова, а тяжёлые справочники держатся в кэше — так выдача остаётся свежей без лишней нагрузки.

Чтение в момент запроса

Поиск и карточка обращаются к CHE168 при вызове: цена и доступность объявления верны на момент ответа.

Индекс каталога

Справочник марок, серий и модификаций держится в индексе и обновляется фоном, поэтому фильтры отвечают быстро.

Подписанные запросы

Источник требует подписи запросов — сервис формирует их сам, и при смене правил вы ничего не меняете у себя.

Дозагрузка деталей

Если в выдаче не хватает полей, сервис дотягивает карточку по объявлению, чтобы список и карточка не расходились.

Документация

Swagger UI и OpenAPI

CHE168 описан в той же схеме, что и Encar: отдельной документации учить не нужно, достаточно передать providerId=2.

Swagger UI по адресу /docs: методы вызываются прямо из браузера вашим ключом.
Машинная схема /docs-json — можно сгенерировать клиент на своём языке.
Ошибки описаны явно: 401 без ключа, 402 без активной подписки, 403 при запросе с чужого IP, 429 при превышении лимита.
Ключи, доверенные IP и расход запросов видны в личном кабинете.

Стоимость

Доступ к CHE168 API

€149

в месяц, тариф Start

Тарифы общие для всех источников: один ключ открывает и корейские, и китайские данные. Оплата за год — со скидкой 15%.

Start — до 10 000 запросов в месяц

Grow — до 30 000 запросов и приоритетная поддержка

Scale — до 100 000 запросов и до 3 доменов или IP

Оба источника доступны по одному ключу без доплаты за второй

Все тарифы

Нужны автомобили из Китая в вашем каталоге?

Создайте аккаунт и получите ключ, или напишите в Telegram — расскажем, как объединить корейские и китайские объявления в одной витрине.

Попробовать API Написать в Telegram