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

Документация на API и скрейпър за автомобилни данни: как да получите достъп чрез директни крайни точки на API-то. Ръководства за интеграция и примери с код.

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

Готови за използване клиентски библиотеки на предпочитания от вас език за програмиране за бърза интеграция с API.

Изчистени, структурирани автомобилни данни, доставяни чрез API. Не са нужни сложни настройки, управление на инфраструктура или техническа поддръжка.

Защо да изберете нас

Опит в бранша

Доставчик на API за автомобилни данни с над 8 години опит, от 2017 г.

Поддръжка 7 дни в седмицата

Екипът за поддръжка е на разположение 7 дни в седмицата за помощ при интеграцията с API.

Услуга 24/7

Денонощен мониторинг за надеждна доставка на данни.

Основни възможности на API | Скрейпъри и парсъри

Известия за обяви в реално време

Получавайте незабавен достъп чрез API до новите автомобилни обяви още при публикуването им.

Ежедневни експорти на данни

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

Гъвкави формати за експорт

Получавайте данни в CSV, JSON, Excel и формати по поръчка за лесна интеграция.

Често задавани въпроси | API срещу скрейпър и кроулър

Как работи API-то за автомобилни данни?

API-то за автомобилни данни предоставя достъп в реално време до данни от големите онлайн пазари за автомобили. Доставя форматирани данни чрез REST API.

Какви данни предоставя API-то за автомобилни данни?

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

Има ли лимити за използване?

Няма лимити за използване. Получавайте всички активни обяви от различните региони чрез API в реално време или ежедневни експорти. Няма ограничения за бизнес партньори.

Как мога да следя нови автомобилни обяви чрез API в реално време?

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

Кои формати на данни поддържате?

Получавайте данни в CSV, JSON, Excel и формати за бази данни. Всеки формат предоставя изчерпателни данни от всички платформи.

Можете ли да разработите достъп до API по поръчка за конкретна платформа?

Да, разработваме индивидуални 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": ["Manual", "Automatic", "Semi-Automatic", "CVT", "Other"],
  "color": ["White", "Black", "Silver", "Gray", "Blue", "Red", "Brown", "Beige", "Gold", "Green", "Yellow", "Orange", "Purple", "Pink", "Pearl", "Burgundy", "Turquoise", "Sky Blue", "Other"],
  "body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Pickup Truck", "Coupe/Roadster", "Microbus", "RV", "Other"],
  "engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid (Gasoline)", "Hybrid (Diesel)", "Hydrogen", "LPG", "CNG", "Gasoline + LPG", "Gasoline + CNG", "LPG + Electric", "Other"]
}

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 - филтър по диапазон на цената (в единици по 10000 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": "Black",
        "price": 3190,
        "price_won": "31900000",
        "km_age": 92842,
        "engine_type": "Diesel",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "address": "Busan Gijang-gun",
        "seller_type": "DEALER",
        "is_dealer": true,
        "images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
        "extra": {"diagnosis": {...}, "inspection": {...}, "record_open": {...}}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Полета с данни:

  • id - вътрешно ID в базата данни
  • inner_id - ID на обявата в платформата
  • url - връзка към обявата
  • mark - марка на автомобила
  • model - модел на автомобила
  • generation - поколение
  • configuration - модификация
  • complectation - ниво на оборудване
  • year - година на производство
  • color - цвят
  • price - цена (в единици по 10000 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 - масив от URL адреси на изображения
  • extra - диагностика, доклад от проверката и застрахователна история
    • diagnosis - диагностика на панелите на каросерията от Encar
    • inspection - доклад от проверката, включително схемата на щетите в полето extra.inspection.outers като списък с елементи на каросерията и означенията им
    • record_open - застрахователна история, включително застрахователните събития и изплатените по тях обезщетения в полето extra.record_open.accidents
  • options - списък с опции

GET/change_id

Получаване на първото ID на промяна по дата (за използване в /changes)

Параметри:

  • date (задължително) - дата във формат yyyy-mm-dd
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 (задължително) - от кое 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

Отговор: обект data (същият като в /offers, но без обвивката result)

API-то връща данните на обява в encar, che168, dongchedi, guazi или mobile.de по връзка към нея: полетата както в /offer на API v3 за тази платформа и блок meta с оставащия лимит.

Базов URL

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

Оторизация: хедър x-api-key

POST/api/v2/offer/info

Една обява по връзката към нея

Параметри:

  • url (задължително) - URL адрес на страницата на обявата в една от тези платформи

Примерна заявка:

curl -L 'https://{access_name}.auto-api.com/api/v2/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=39464599" }'

Отговор:

{
  "id": 136402,
  "inner_id": "39464599",
  "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39464599",
  "mark": "BMW",
  "model": "5 Series",
  "generation": "5 Series (G30)",
  "generation_code": "G30",
  "configuration": "530i M Sport Package",
  "complectation": null,
  "year": 2017,
  // ... останалите полета на обявата, както в /offer на API v3
  "meta": {
    "requests_made": 48,
    "requests_left": 1952,
    "requests_limit": 2000,
    "period_start": "2026-11",
    "platform": "encar"
  }
}

Полетата на обявата са същите, които връща /offer в API v3. Блокът meta идва последен.

Какво има в meta:

  • requests_made - колко успешни заявки са направени през текущия месец
  • requests_left - колко още заявки можете да направите
  • requests_limit - месечният лимит
  • period_start - месецът на брояча
  • platform - от коя платформа е обявата: encar, che168, dongchedi, guazi или mobilede

Към месечния лимит се отчитат само отговорите с обява, а грешките не го изразходват.

Политика за съхранение на данните

Файловете се съхраняват поне 3 дни

График на достъпност на API

Нови ежедневни файлове, достъпни за изтегляне

Формат на CSV данните

CSV файловете използват вертикална черта (|) като разделител на колоните

Структура на URL адреса:

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

Параметри на заявката:

  • access_name - предоставеният ви идентификатор на поддомейна
  • date - желаната дата във формат yyyy-mm-dd (напр. 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

Примерна API заявка с 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'