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

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

Официальные SDK библиотеки

Готовые клиентские библиотеки для быстрой интеграции 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 решения для любых автомобильных площадок. Свяжитесь с нами со своими требованиями.

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

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

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

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

Базовый 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

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'