ДокументацияСправочник API

Документация API Автоскрапера. Узнайте, как получить доступ к данным через прямые эндпоинты. Руководства по интеграции и примеры кода.

Чистые, структурированные данные об авто через API. Без сложной настройки, управления инфраструктурой или технического обслуживания.

Почему выбирают нас

Опыт в индустрии

Провайдер API автоданных с опытом работы с 2017 года (более 8 лет).

Поддержка без выходных

Команда поддержки доступна 7 дней в неделю для помощи с интеграцией API.

Сервис 24/7

Круглосуточный мониторинг для надежной доставки данных.

Ключевые Возможности API | Скраперы и Парсеры

Оповещения в Реальном Времени

Мгновенный доступ через API к новым объявлениям сразу после их публикации.

Ежедневные Экспорты Данных

Получайте ежедневные выгрузки активных и удаленных объявлений для анализа рынка и отслеживания продаж.

Гибкие Форматы Экспорта

Данные в CSV, JSON, Excel и кастомных форматах для легкой интеграции.

Частые Вопросы | API vs Скрапер и Краулер

Как работает автомобильный API?

Автомобильный API предоставляет доступ в реальном времени к данным с крупных автоплощадок. Отдает отформатированные данные через REST API.

Какие данные предоставляет API?

Полные данные авто: характеристики, цены, инфо о продавце, локация и пробег. Доступ к миллионам объявлений с крупных платформ через API.

Есть ли лимиты использования?

Лимитов нет. Получайте все активные объявления по регионам через Real-Time API или ежедневные экспорты. Никаких ограничений для бизнес-партнеров.

Как отслеживать новые объявления через API?

Мониторьте объявления используя параметр 'change_id'. Начните с change_id=0, затем используйте ID последнего изменения + 1. Захватывайте новые авто, изменения цен и удаления.

Какие форматы данных вы поддерживаете?

Данные в CSV, JSON, Excel и форматах баз данных. Каждый формат предоставляет исчерпывающие данные со всех платформ.

Можете ли вы создать доступ к конкретному маркетплейсу?

Да, мы создаем кастомные API решения для любых автомобильных площадок. Свяжитесь с нами со своими требованиями.

Конфиденциально ли использование данных?

Да. Мы работаем по строгим соглашениям о конфиденциальности со всеми клиентами. Ваше использование наших сервисов остается частным.

Нужно ли мне управлять серверами?

Нет, все полностью управляется нами. Мы берем на себя инфраструктуру, серверы и сбор данных. Вы получаете готовые к использованию данные.

API Reference

Базовый URL

https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}

Авторизация: api_key parameter

Алгоритм работы

1
/filtersполучить справочники и значения фильтров
2
/offersполучить список объявлений (с фильтрами или без) - для первичной загрузки
3

Поддержание актуальности (после первичной загрузки):

/change_id?date=...получить стартовый ID для потока изменений
/changes?change_id=...получить поток изменений (дельту) начиная с указанного ID
4
/offerполучить детальные данные объявления по inner_id

Рекомендуемый сценарий интеграции:

1. Используйте /offers для первичной полной выгрузки (пройдите по всем страницам пагинации)

2. Настройте опрос /changes для периодического получения обновлений (новых, измененных, удаленных авто) и синхронизации вашей базы

3. Для вывода на сайте используйте /offers с фильтрами и пагинацией (марка, модель, цена, год и т.д.)

GET/filters

Справочники и возможные значения для фильтрации

https://{access_name}.auto-api.com/api/v2/{platform}/filters?api_key=YOUR_API_KEY

Ответ:

{
  "mark": {
    "Hyundai": {
      "model": {
        "Sonata": {
          "configuration": {
            "DN8": { "complectation": ["Smart", "Modern", "Premium"] }
          }
        }
      }
    },
    "Kia": {
      "model": {
        "K5": {
          "configuration": {
            "DL3": { "complectation": ["LX", "EX", "SX"] }
          }
        }
      }
    }
  },
  "transmission_type": ["Гибрид", "Редуктор", "Автомат", "Механика", "Вариатор", "Робот"],
  "color": ["Серебристый", "Желтый", "Красный", "Фиолетовый", "Другой", "Черный", "Темно-серый", "Белый", "Кофейный", "Оранжевый", "Зеленый", "Синий", "Шампань"],
  "body_type": ["Седан", "Микроавтобус", "Кроссовер/внедорожник", "Легкий грузовик", "Минивэн", "Купе/родстер", "Хэтчбек"],
  "engine_type": ["Гибрид", "Метан", "Подключаемый гибрид", "Дизель", "Бензин/газ", "Последовательный гибрид", "Бензин", "Электро"],
  "drive_type": ["Передний", "Задний", "Полный"]
}

GET/offers

Поиск объявлений с пагинацией и фильтрами

Параметры:

  • page (обязательно) - номер страницы
  • mark, model, configuration, complectation - filters (нечувствительно к регистру)
  • transmission_type, color, body_type, engine_type - filters (нечувствительно к регистру)
  • year_from, year_to - фильтр по годам
  • km_age_from, km_age_to - фильтр по пробегу
  • price_from, price_to - фильтр по цене (в единицах 10 000 KRW)
https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=black

Ответ:

{
  "result": [
    {
      "id": 3219435,
      "inner_id": "40427050",
      "change_type": "added",
      "created_at": "2025-09-08T12:02:03.000Z",
      "data": {
        "id": 1454012,
        "inner_id": "40427050",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
        "mark": "Hyundai",
        "model": "Palisade",
        "generation": "Diesel 2.2 4WD",
        "configuration": "Diesel 2.2 4WD",
        "complectation": "Prestige",
        "year": 2021,
        "color": "Черный",
        "price": 3190,
        "price_won": "31900000",
        "km_age": 92842,
        "engine_type": "Дизель",
        "transmission_type": "Автомат",
        "body_type": "Кроссовер/внедорожник",
        "address": "Busan Gijang-gun",
        "seller_type": "DEALER",
        "is_dealer": true,
        "images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
        "extra": {"diagnosis": {...}, "inspection": {...}, "accidents": [...]}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Поля данных:

  • id - внутренний ID базы данных
  • inner_id - ID объявления на платформе
  • url - ссылка на объявление
  • mark - марка
  • model - модель
  • generation - поколение
  • configuration - конфигурация
  • complectation - комплектация
  • year - год выпуска
  • color - цвет
  • price - цена (в единицах 10 000 KRW)
  • price_won - полная цена в KRW
  • km_age - пробег (км)
  • engine_type - тип двигателя
  • transmission_type - тип трансмиссии
  • body_type - кузов
  • address - адрес
  • seller_type - тип продавца
  • is_dealer - флаг дилера (true/false)
  • section - раздел
  • seller - продавец
  • salon_id - ID дилера
  • description - описание
  • displacement - объем двигателя (cc)
  • offer_created - дата создания объявления
  • images - список фото
  • extra - дополнительные данные (JSON)
  • options - список опций

GET/change_id

Получить первый ID изменения на конкретную дату (для /changes)

Параметры:

  • date (обязательно) - дата в формате гггг-мм-дд
https://{access_name}.auto-api.com/api/v2/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Ответ:

{ "change_id": 1547283 }

Используйте это значение как параметр change_id в /changes

GET/changes

Поток изменений (новые/измененные/удаленные)

Параметры:

  • change_id (обязательно) - начиная с какого change_id
https://{access_name}.auto-api.com/api/v2/{platform}/changes?api_key=YOUR_API_KEY&change_id=1

Ответ:

{
  "result": [
    {
      "id": 456,
      "inner_id": "40427050",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "40427051",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 3490 }
    },
    {
      "id": 458,
      "inner_id": "40427052",
      "change_type": "removed",  // removed - listing deleted
      "created_at": "2025-01-15T10:32:00Z"
    }
  ],
  "meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}

GET/offer

Карточка объявления по inner_id

Параметры:

  • inner_id (обязательно)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050

Ответ: объект данных (как в /offers, но без обертки result)

Данные по URL

Получение полных данных объявления по оригинальной ссылке с любой поддерживаемой платформы. Идеально для быстрого поиска и получения единичных объявлений.

Базовый URL

https://{access_name}.auto-api.com/api/v1/offer/info

Авторизация через заголовок x-api-key

POST/api/v1/offer/info

Отправьте POST-запрос с URL объявления для получения полных данных

Параметры:

  • url (обязательно) - ссылка на объявление с любой поддерживаемой платформы

Пример запроса:

curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419" }'

Ответ:

{
  "inner_id": "39225419",
  "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
  "mark": "BMW",
  "model": "5-Series",
  "generation": "528i",
  "year": 2010,
  "year_month": "2010-08",
  "color": "Серебристый",
  "price": 880,
  "price_won": 8800000,
  "km_age": 132437,
  "engine_type": "Бензин",
  "transmission_type": "Автомат",
  "body_type": "Седан",
  "displacement": "2996",
  "power": "230",
  "vin": "WBAFR1105AC258998",
  "address": "Gwangju Seo-gu",
  "seller_type": "DEALER",
  "is_dealer": true,
  "offer_created": "2025-11-17",
  "images": [
    "https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
    "https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
  ]
}

Поля данных:

  • inner_id - ID объявления на платформе
  • url - ссылка на объявление
  • mark - марка
  • model - модель
  • generation - поколение
  • year - год выпуска
  • year_month - год и месяц выпуска
  • color - цвет
  • price - цена в 10 000 KRW
  • km_age - пробег (км)
  • engine_type - тип двигателя
  • transmission_type - тип трансмиссии
  • body_type - кузов
  • displacement - объем двигателя (см³)
  • power - мощность (л.с.)
  • vin - VIN-код
  • address - адрес
  • seller_type - тип продавца
  • is_dealer - флаг дилера (true/false)
  • offer_created - дата создания объявления
  • images - список фото
Ежедневные выгрузки

Срок хранения

Файлы хранятся минимум 3 дня

Доступность

Новые файлы готовы каждое утро

Формат CSV

Разделитель столбцов - вертикальная черта (|)

Структура URL:

https://{access_name}.auto-api.com/{date}/{file_name}

Параметры:

  • access_name - ваш идентификатор поддомена
  • date - дата в формате гггг-мм-дд (напр. 2025-09-06)
  • file_name - имя файла с расширением

Доступные форматы:

  • CSV - all_active.csv, new_daily.csv, removed_daily.csv
  • JSON - all_active.json, new_daily.json, removed_daily.json
  • Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

Пример cURL

curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
  -H 'Authorization: Basic XXX' \
  -o daily_car_data.csv

Команда Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'