API за автомобилни обяви от Encar, Mobile.de, Che168, Dongchedi и други
Достъп до обединени данни от автомобилни обяви чрез едно надеждно 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": {...}, "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 адреса:
Параметри на заявката:
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'Данни от няколко платформи
Извличайте автомобилни обяви от Encar, Mobile.de, AutoScout24 и други чрез едно API.
Обновявания в реално време
Получавайте нови обяви, промени в цените и премахнати обяви, щом се появят.
Пазарни анализи
Исторически данни и тенденции за анализ на цените и проучване на пазара.
Гъвкава доставка
Изберете между достъп до API в реално време и ежедневни масови експорти в CSV, JSON, Excel.
Световни пазари
Покритие в Европа, Азия, Близкия изток и Северна Америка.
Лесна интеграция
RESTful API с документация и работещи примери с код.