API за автомобилни обяви от Encar, Mobile.de, Che168, Dongchedi и други

EncarMobile.deAutoScout24Che168GuaziDongchedi+ още 9

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

Изпробвайте API сегаВижте документациятаДостъпът се предоставя до 2 минути
100M+
обяви
15+
платформи
50+
полета с данни
Време за отговор<200ms
Статус на API
работи

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

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

PHPNode.jsPythonGoC#JavaRubyRust
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": ["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": {...}, "accidents": [...]}
      }
    }
  ],
  "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 - допълнителни данни (JSON)
  • 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)

Получаване на обява по URL

Извличане на пълните данни от обявата по подаден оригинален 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": "Silver",
  "price": 880,
  "price_won": 8800000,
  "km_age": 132437,
  "engine_type": "Gasoline",
  "transmission_type": "Automatic",
  "body_type": "Sedan",
  "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 - цена в единици по 10000 KRW
  • km_age - пробег в км
  • engine_type - тип двигател
  • transmission_type - тип скоростна кутия
  • body_type - тип каросерия
  • displacement - обем на двигателя (куб. см)
  • power - мощност в к.с.
  • vin - VIN номер
  • address - адрес
  • seller_type - тип продавач
  • is_dealer - флаг за дилър (true/false)
  • offer_created - дата на създаване на обявата
  • images - масив от URL адреси на изображения
Ежедневни експорти

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

Файловете се съхраняват поне 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'
Възможности на API

Данни от няколко платформи

Извличайте автомобилни обяви от Encar, Mobile.de, AutoScout24 и други чрез едно API.

Обновявания в реално време

Получавайте нови обяви, промени в цените и премахнати обяви, щом се появят.

Пазарни анализи

Исторически данни и тенденции за анализ на цените и проучване на пазара.

Гъвкава доставка

Изберете между достъп до API в реално време и ежедневни масови експорти в CSV, JSON, Excel.

Световни пазари

Покритие в Европа, Азия, Близкия изток и Северна Америка.

Лесна интеграция

RESTful API с документация и работещи примери с код.