ДокументацияСправочник за API
Документация на API и скрейпър за автомобилни данни: как да получите достъп чрез директни крайни точки на 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
Ред на работа
/filtersполучаване на наличните стойности на филтрите/offersполучаване на обяви (с филтри или без) - използвайте за първоначално зареждане на даннитеЗа обновявания (за да поддържате данните актуални след първоначалното зареждане):
/change_id?date=...получаване на началното ID за потока от промени/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID/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
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 адреса:
Параметри на заявката:
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'