Республика КореяПлощадка

Charancha API

Объявления Charancha из Южной Кореи в JSON: цена продавца, пробег, фото и характеристики авто.

На charancha.com

charancha.com

В вашем коде

{"vin": string"brand": { name }"model": { name }"year": number"listings": [{"external": {…}"price": {…}"odometer": {…}"is_auction": boolean"images": […]}]"inspections": […]"vehicle_history_reports": […]}

Названия полей взяты из реальной записи; значения – это типы, а не данные.

Что такое Charancha?

01/ 06О сайте

О Charancha

Charancha – корейская площадка подержанных авто, где дилеры размещают свой сток. Она добавляет широкий срез рынка помимо Encar и KB ChaChaCha, и одно и то же авто часто встречается на нескольких из этих сайтов. MotorAPIs объединяет такие объявления под одним авто, поэтому вы видите все места, где оно предлагается.

Страна
Республика Корея
Тип
Площадка
API
api.motorapis.com
Сайт
charancha.com

Какие данные я получу?

02/ 06Поля

Что вы получаете от Charancha

Каждое объявление в общей записи авто. Поля заполняются, если Charancha их показывает.

Автомобиль

  • VIN, если сайт его показывает
  • Марка, модель и поколение из единого каталога
  • Год, топливо, коробка передач, двигатель, мощность
  • Пробег в км

Объявление

  • Сайт и ID объявления, ссылка на объявление
  • Цена и валюта
  • Тип продавца и местоположение
  • Фотогалерея
  • Комплектация

Отчёты

  • Осмотры, если опубликованы
  • Отчёты об истории, если опубликованы

Одно авто, много сайтов

  • Одно авто на нескольких сайтах – это одно авто
  • Проданные авто остаются доступными примерно месяц

Как их запросить?

03/ 06Запросы

Три запроса для старта

ID сайтов зависят от ключа: один раз получите их из /domains, затем фильтруйте по ним.

  1. 01Найдите ID сайта Charancha

    GET https://api.motorapis.com/domains
      x-api-key: YOUR_API_KEY
  2. 02Ищите его автомобили

    GET https://api.motorapis.com/search?domains[]={domain_id}&perPage=20
      x-api-key: YOUR_API_KEY
  3. 03Выгрузите всё и поддерживайте в актуальном состоянии

    GET https://api.motorapis.com/cars?domains[]={domain_id}&limit=500
      x-api-key: YOUR_API_KEY

Что ещё стоит знать?

04/ 06Вопросы

Вопросы о Charancha API

Какие данные Charancha возвращает API?
Каждое объявление в виде стандартной записи авто: марка, модель и поколение из единого каталога, год, пробег, цена и валюта, местоположение, фото и комплектация, а также осмотры и отчёты об истории, если Charancha их публикует.
Как выбрать Charancha в API?
Один раз вызовите /domains, чтобы узнать ID сайта Charancha для вашего ключа, затем передавайте его как domains[] в /search или /cars.
Что, если одно авто есть на нескольких сайтах?
Это одно авто с несколькими объявлениями. У каждого объявления свой сайт, ID, цена и ссылка, поэтому вы видите все места, где авто предлагается.
Как поддерживать копию в актуальном состоянии?
Используйте выгрузку /cars: начните без курсора и переходите по next_url до конца. Запустите её снова, чтобы обновить копию.
Как попробовать?
Запросите бесплатный демо-ключ и сообщите, какие сайты вам нужны. Он возвращает реальные данные в том же JSON, что и платные тарифы.

Что ещё подключено?

Готовы попробовать?

06/ 06Старт

Данные Charancha в вашем продукте

Сообщите, какие источники вам нужны. Мы ответим письменно и пришлём бесплатный демо-ключ.

Получить демо-ключ

MotorAPIs – независимый поставщик данных и не связан с Charancha. Названия и товарные знаки принадлежат их владельцам.