Encar APIScraper & Parser
Експорти ежедневно и в реално време: автомобилни обяви, цени, характеристики, диагностика, история на произшествията. Професионален достъп до автомобилни данни.
Encar API
Получете достъп до целия корейски автомобилен пазар чрез едно API. Изчистени, структурирани данни от обявите за анализи и решения за покупка. Няма нужда да разработвате собствен скрейпър.
Пълен достъп до всички данни от обявите чрез крайните точки на API-то, както и мониторинг в реално време на нови, обновени и премахнати автомобилни обяви.
Изтегляйте ежедневно пълни моментни снимки на пазара в CSV, JSON или Excel формат.
Включват всяко налично поле: цена, пробег, характеристики, снимки, информация за продавача, диагностични доклади, история на произшествията и всички опции.
Ако обявата има доклад от проверката, диагностика от Encar или застрахователна история, те идват вече структурирани. Опциите са разпределени по групи.
Базов URL
https://{access_name}.auto-api.com/api/v3/encarОторизация: api_key параметър
Ред на работа
/filtersполучаване на наличните стойности на филтритеПървоначално зареждане:
/change_id?date=...получаване на началното ID за потока от промени/offersполучаване на всички обяви страница по страница/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID/offerполучаване на данни за конкретна обява по inner_id/detailsсписъци с inner_id на обяви, които си струва да изключите от каталога сив тях влизат обяви за наем и лизинг, автомобили, за които вече е в ход сделка, и дублирани обяви
в /offers същото прави for_sale=1, а в /changes при събитие added това се вижда в advertisement_type, sales_status и is_duplicate
Откъде да започнете:
1. Преди първото зареждане вземете номера от /change_id за днешната дата и го запазете. След това преминете през /offers страница по страница до края: на последната страница next_page е null.
2. После извиквайте /changes, като започнете от този номер, и подавайте next_change_id от всеки отговор. Така пристигат новите обяви, новите цени и свалените от продажба автомобили. Ако next_change_id е null, все още няма събития: повторете същата заявка по-късно.
3. За да търсите по собствени критерии, извиквайте /offers с филтри.
Формат на данните
- Типовете се запазват: числото идва като число, списъкът като масив, а липсващата стойност като null.
- Датата и часът се дават в UTC, например "2026-06-17T12:24:51Z". Датите имат вида "2021-04-02", а месеците вида "2021-04".
- Всички суми са в KRW.
- Всички обяви имат едни и същи ключове. Ако за даден блок, например диагностиката от Encar, няма данни, блокът е null.
GET/filters
Връща всички възможни стойности за филтриране
https://{access_name}.auto-api.com/api/v3/encar/filters?api_key=YOUR_API_KEYОтговор:
{
"mark": {
"Hyundai": {
"model": {
"Tucson": {
"configuration": {
"Gasoline 1.6 Turbo 2WD": { "complectation": ["Adventure", "Inspiration", "Modern", "Modern Fever", "N Line Inspiration", ...] },
...
}
},
...
}
},
"Kia": {
"model": {
"Carnival": {
"configuration": {
"9-Seater Hi-Limousine": { "complectation": ["Luxury", "Noblesse", "Noblesse Special", "Prestige", "Prestige High roof", ...] },
...
}
},
...
}
},
...
},
"transmission_type": ["Automatic", "CVT", "Manual", "Other", ...],
"color": ["Beige", "Black", "Black two-tone", "Blue", ...],
"body_type": ["Coupe/Roadster", "Hatchback", "Microbus", "Minivan", ...],
"engine_type": ["CNG", "Diesel", "Electric", "Gasoline", ...]
}GET/offers
Обяви страница по страница. Филтрите стесняват резултатите.
Параметри:
page(задължително) - номер на страницатаmark, model, configuration, complectation- имена на марката, модела, модификацията и нивото на оборудване, изписани както във /filterstransmission_type, color, body_type, engine_type- стойности за скоростна кутия, цвят, каросерия и гориво, без разлика между главни и малки буквиyear_from, year_to- моделна година от и доkm_age_from, km_age_to- пробег в км от и доprice_from, price_to- цена във вонове от и доvin- търсене по VINfor_sale=1- изключва от резултатите обявите за наем и лизинг, автомобилите със сделка в ход и дублираните обяви
За да подадете няколко стойности на един филтър, повторете параметъра със скоби: mark[]=BMW&mark[]=Mercedes-Benz
https://{access_name}.auto-api.com/api/v3/encar/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/encar/offers?api_key=YOUR_API_KEY&page=1&mark=BMW&model=X5&year_from=2020&for_sale=1https://{access_name}.auto-api.com/api/v3/encar/offers?api_key=YOUR_API_KEY&page=1&mark[]=BMW&mark[]=Mercedes-Benz&engine_type[]=Gasoline&engine_type[]=Diesel&price_to=50000000Отговор:
{
"result": [
{
"id": 136402,
"inner_id": "39464599",
"change_type": "added",
"created_at": "2026-06-17T12:24:51Z",
"data": {
"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,
"model_year": 2017,
"first_registration": "2017-10",
"first_registration_date": "2017-10-16",
"year_month": "2017-10",
"km_age": 124736,
"owners_count": 3,
"price": 17500000,
"currency": "KRW",
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "Sedan",
"drive_type": null,
"color": "Gray",
"color_seller_note": null,
"color_hex": "#616161",
"seat_color": "Black",
"seat_color_hex": "#000000",
"displacement": 2,
"displacement_cc": 1998,
"power": 252,
"power_ice_hp": 252,
"power_electro_kw": null,
"seat_count": 5,
"vin": "WBAJD3107HWA90961",
"plate_number": "172머7357",
"section": "Used",
"advertisement_type": "Sale",
"lease": null,
"sales_status": "Available",
"is_duplicate": false,
"duplicate_of": null,
"is_brand_certified": false,
"is_domestic": false,
"import_type": "Official import",
"seller_type": "Dealer",
"is_dealer": true,
"is_owner_verified": false,
"seller": "wb6814",
"salon_id": "5943",
"seller_firm": "(주)넘버원모터스",
"region": "Busan",
"address": "부산 사상구",
"pledge_count": 0,
"seizure_count": 0,
"seller_headline": null,
"description": "실매물 보장! BMW 530i M 스포츠 판...",
"offer_created": "2026-07-28T22:50:17Z",
"first_advertised_at": "2026-06-17T12:17:20Z",
"created_at": "2026-06-17T12:24:51Z",
"photos": [
"https://ci.encar.com/carpicture06/pic3946/39464599_001.jpg?...",
"https://ci.encar.com/carpicture06/pic3946/39464599_002.jpg?...",
"https://ci.encar.com/carpicture06/pic3946/39464599_003.jpg?...",
"https://ci.encar.com/carpicture06/pic3946/39464599_004.jpg?...",
...
],
"photo_details": [
{ "type": "Exterior", "url": "https://ci.encar.com/carpicture06/pic3946/39464599_001.jpg?..." },
{ "type": "Exterior", "url": "https://ci.encar.com/carpicture06/pic3946/39464599_002.jpg?..." },
{ "type": "Exterior", "url": "https://ci.encar.com/carpicture06/pic3946/39464599_003.jpg?..." },
{ "type": "Exterior", "url": "https://ci.encar.com/carpicture06/pic3946/39464599_004.jpg?..." },
...
],
"original": { // оригинални стойности от encar.com
"mark": "BMW",
"model": "5시리즈",
"generation": "5시리즈 (G30)",
"configuration": "530i M 스포츠",
"complectation": null,
"engine_type": "가솔린",
"transmission_type": "오토",
"body_type": "중형차",
"drive_type": null,
"color": "쥐색",
"seat_color": "검정색 계열",
"seller_type": "DEALER"
},
"catalog_ids": {
"mark": "012",
"model": "003",
"generation": "060",
"configuration": "005",
"complectation": null,
"jato": "783960120170908"
},
"options": {
"Exterior": ["Sunroof", "LED headlights", "Power trunk", "Power folding mirrors", ...],
"Interior": ["Heated steering wheel", "Power adjustable steering wheel", "Paddle shifters", "Steering wheel audio controls", ...],
"Safety": ["Driver airbag", "Passenger airbag", "Side airbags", "Curtain airbags", ...],
"Comfort": ["Adaptive cruise control", "Head-up display (HUD)", "Electronic parking brake (EPB)", "Automatic climate control", ...],
"Multimedia": ["Navigation system", "Front multimedia screen", "Bluetooth", "USB port"],
"Seats": ["Leather seats", "Power driver seat", "Power passenger seat", "Heated front seats", ...]
},
"options_seller_notes": null,
"tire_seller_note": null,
"inspection": {
"record_number": "3035008743",
"issue_date": "2025-04-17",
"valid_from": "2023-10-16",
"valid_until": "2025-10-15",
"first_registration_date": "2017-10-16",
"model_year": 2017,
"mileage": 124727,
"engine_code": "B46B20A",
"warranty_type": "Seller warranty",
"accident": false,
"simple_repair": true,
"flood": false,
"special_history": [],
"recall": false,
"recall_completed": null,
"tuning": false,
"tuning_types": [],
"usage_changes": [],
"odometer_state": "Good",
"mileage_assessment": null,
"vin_state": "Normal",
"co_percent": 0,
"hc_ppm": 0,
"smoke_percent": null,
"comment": "...",
"panels": {
"Outer panels, rank 1": {
"Hood": "Replaced",
"Front fender (left)": "Replaced",
"Front fender (right)": "Sheet metal work or welding",
"Rear door (right)": "Replaced",
"Radiator support": "Replaced"
}
},
"panel_codes": {
"P011": ["X"],
"P021": ["X"],
"P022": ["W"],
"P034": ["X"],
"P051": ["X"]
},
"systems": {
"Self-diagnosis": {
"Engine": "Good",
"Transmission": "Good"
},
"Engine": {
"Idle operation": "Good",
"Oil leak: valve cover": "None",
"Oil leak: cylinder head and gasket": "None",
...
},
"Transmission": {
"Automatic transmission: oil leak": "None",
"Automatic transmission: oil level and condition": "Normal",
"Automatic transmission: idle operation": "Good"
},
"Drivetrain": {
"Clutch assembly": "Good",
"CV joint": "Good",
"Propeller shaft and bearings": "Good",
...
},
...
},
"photos": [
"https://ci.encar.com/carsdata/cars/inspection/39464599_photoFront.jpg",
"https://ci.encar.com/carsdata/cars/inspection/39464599_photoBack.jpg"
],
"scans": []
},
"diagnosis": {
"date": "2025-04-17",
"center": "부산 사상",
"result": "Outer panels replaced, frame intact",
"panels": {
"Hood": "Replaced",
"Front fender (left)": "Replaced",
"Front fender (right)": "No issues",
"Front door (left)": "No issues",
"Front door (right)": "No issues",
"Rear door (left)": "No issues",
"Rear door (right)": "Replaced",
"Trunk lid": "No issues"
},
"panel_codes": {
"P011": "Replaced",
"P021": "Replaced",
"P022": "No issues",
"P031": "No issues",
"P032": "No issues",
"P033": "No issues",
"P034": "Replaced",
"P041": "No issues"
},
"comment": "...",
"panels_comment": "..."
},
"history": {
"report_date": "2025-04-17",
"first_registration_date": "2017-10-16",
"owner_changes": 2,
"owner_change_dates": ["2025-04-07", "2022-10-28"],
"plate_changes": 1,
"plate_history": [
{ "date": "2017-10-16", "use": "Rental", "vehicle_kind": "Passenger car" },
{ "date": "2022-10-28", "use": "Private use", "vehicle_kind": "Passenger car" }
],
"use": "Private use",
"rental_history": true,
"commercial_history": false,
"government_history": false,
"own_damage_count": 6,
"own_damage_cost_won": 17126193,
"other_damage_count": 2,
"other_damage_cost_won": 771994,
"accidents": [
{
"date": "2023-11-29",
"damage_to": "This car",
"paid_by": "Other party's insurer",
"insurance_benefit_won": 4152000,
"parts_won": 1753200,
"labor_won": 450972,
"painting_won": 1279808
},
{
"date": "2022-12-02",
"damage_to": "This car",
"paid_by": "Other party's insurer",
"insurance_benefit_won": 7566400,
"parts_won": 2535600,
"labor_won": 2024300,
"painting_won": 1441440
},
{
"date": "2021-12-24",
"damage_to": "This car",
"paid_by": "Other party's insurer",
"insurance_benefit_won": 1280000,
"parts_won": 0,
"labor_won": 285950,
"painting_won": 796415
},
...
],
"total_loss_count": 0,
"total_loss_date": null,
"flood_total_loss_count": 0,
"flood_partial_loss_count": null,
"flood_date": null,
"theft_count": 0,
"theft_date": null,
"uninsured_periods": [
{ "from": "2019-10", "to": "2022-10" }
],
"vehicle": {
"kind": "Passenger car",
"body": null,
"doors": null,
"fuel": "Gasoline",
"displacement": 1998,
"year": 2017
}
}
}
}
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Полета с данни:
Обява
id - вътрешно ID в базата данни
inner_id - ID на обявата в платформата
url - връзка към обявата
price, currency - Цена във вонове, currency винаги е KRW. При наем и лизинг това не е цената на автомобила, условията на сделката са в lease.
section - "Used" или "New".
advertisement_type - Какво предлага обявата: "Sale", "Operating lease", "Finance lease", "Rental takeover", "Rental".
sales_status - "Available" или "Reserved", ако за автомобила вече е в ход сделка.
is_duplicate, duplicate_of - true, когато това е още една обява за същия автомобил. Тогава duplicate_of съдържа inner_id на първата обява.
lease - При наем и лизинг: monthly_payment_won (месечна вноска), months_left (оставащи месеци), deposit_won (депозит), advance_payment_won (аванс), residual_value_won (остатъчна стойност). При продажба е null.
seller_headline - Надпис на продавача над обявата. Ако надписите са няколко, всеки е на нов ред.
description - описание
offer_created - Дата и час, когато продавачът последно е редактирал обявата.
first_advertised_at - Дата и час, когато автомобилът е обявен за продажба.
created_at - Дата и час, когато обявата е постъпила в нашата база данни.
Автомобил
mark, model - Марка и модел.
generation, generation_code - Поколение. Кодът на каросерията (G05, W213 и подобни) е посочен само при някои модели.
configuration, complectation - Модификация (двигател, задвижване, брой места) и ниво на оборудване.
year, model_year - Моделна година, двете полета съвпадат.
year_month - Година и месец на производство.
first_registration_date, first_registration - Първа регистрация: пълна дата и месец.
km_age - пробег в км
owners_count - Колко собственици е имал автомобилът.
vin - VIN номер от 17 знака.
plate_number - Регистрационен номер.
is_domestic - true за корейските марки.
import_type - При чуждестранните марки: "Official import" или "Parallel import".
is_brand_certified - true, ако автомобилът е преминал сертификацията на производителя.
pledge_count, seizure_count - Колко залога и запора са вписани за автомобила.
Характеристики
engine_type, transmission_type, body_type - Двигател, скоростна кутия и каросерия.
drive_type - Задвижване (2WD, 4WD, AWD), не е посочено за всеки автомобил.
displacement, displacement_cc - Обем на двигателя в литри и в кубически сантиметри.
power - Обща мощност, к.с.
power_ice_hp - Мощност на двигателя с вътрешно горене, к.с.
power_electro_kw - Мощност на електрическата част, kW.
seat_count - Брой места.
color, color_hex - Цвят на каросерията като дума и като HEX код.
color_seller_note - Бележка на продавача за цвета.
seat_color, seat_color_hex - Цвят на интериора като дума и като HEX код.
Продавач
seller_type, is_dealer - "Dealer" или "Private seller", is_dealer повтаря това като true/false.
is_owner_verified - true, ако Encar е проверил, че продавачът е собственик на автомобила.
seller - Продавачът, както е посочен в Encar.
salon_id, seller_firm - ID и име на дилърската фирма.
region, address - Къде се намира продавачът: регион и адрес.
Снимки, опции и справочни данни
photos - масив от URL адреси на изображения
photo_details - Същите снимки, всяка с type и url. Снимките на дъното на автомобила, направени при диагностиката от Encar, идват последни. Видове: "Exterior", "Interior", "Options", "Thumbnail", "Encar diagnosis", "Underbody", "Underbody front left", "Underbody front right", "Underbody rear left", "Underbody rear right".
options - Опции, разпределени по групи "Exterior", "Interior", "Safety", "Comfort", "Multimedia", "Seats", "Tuning". Групи без опции не се връщат.
options_seller_notes - Допълнения на продавача към списъка с опции.
tire_seller_note - Коментар на продавача за гумите.
original - Оригинални имена и стойности от encar.com.
catalog_ids - Кодове на автомобила в каталога на encar.com, от марката до нивото на оборудване, плюс кода JATO.
Доклад от проверката (inspection)
Документ от проверката преди продажба. Ако документът липсва, inspection е null. Ако докладът е приложен само като сканирани копия, от полетата са попълнени само scans, accident и simple_repair.
record_number, issue_date - Номер на доклада и дата на издаване.
valid_from, valid_until - Първи и последен ден на валидност на периодичния технически преглед на автомобила.
first_registration_date, model_year, mileage - Данни за автомобила от доклада: първа регистрация, година, пробег в км.
engine_code - Код на двигателя.
warranty_type - Чия гаранция е посочена в доклада: "Seller warranty" или "Insurance company warranty".
accident - true, ако според правилата на доклада автомобилът е с произшествие: има ремонтирани или сменени носещи елементи или рязан и заваряван заден калник, покрив или страничен праг.
simple_repair - true, ако са ремонтирани или сменени навесни детайли от каросерията.
flood - true, ако автомобилът е пострадал от наводнение.
special_history - Специални означения в доклада, например "Flood".
recall, recall_completed - Дали автомобилът попада в сервизна кампания и дали работите по нея са извършени (true/false).
tuning, tuning_types - Флаг за тунинг (true/false) и списък с видовете: "Legal", "Illegal", "Structural modification", "Equipment modification".
usage_changes - Предишно използване на автомобила, ако е било променяно: "Rental", "Lease", "Commercial use".
odometer_state - Състояние на одометъра: "Good" или "Faulty".
mileage_assessment - Как докладът оценява пробега: "High", "Average", "Low".
vin_state - Състояние на номера на шасито: "Normal", "Corroded", "Damaged", "Mismatch", "Altered", "Erased".
co_percent, hc_ppm, smoke_percent - Измерване на отработените газове: CO (%), въглеводороди (ppm), димност (%).
comment - Коментар на инспектора.
panels - Детайли от каросерията със забележки, разпределени по групите на доклада "Outer panels, rank 1", "Outer panels, rank 2", "Structural frame, rank A", "Structural frame, rank B", "Structural frame, rank C". Всеки детайл има означение: "Replaced", "Sheet metal work or welding", "Cutting and welding", "Corrosion", "Scratch", "Dent", "Damage".
systems - Раздели на доклада с възли и системи, като всяка позиция има оценка: "Good", "Normal", "None", "Minor leak", "Leak", "Low", "High", "Faulty", "Present".
photos, scans - Снимки, направени при проверката, и сканирани копия на самия доклад.
Диагностика от Encar (diagnosis)
Оглед на каросерията от служител на Encar. Ако автомобилът не е минал диагностика, diagnosis е null.
date, center - Кога и къде е направена диагностиката.
result - Заключение: "No panels replaced, frame intact" или "Outer panels replaced, frame intact".
panels - Осем външни детайла от каросерията, всеки с резултат: "No issues", "Replaced", "Repaired", "Painted".
comment, panels_comment - Заключение на специалиста и коментарът му за каросерията.
Застрахователна история (history)
Изплатени застрахователни обезщетения, смени на собственика и смени на регистрационния номер. history е null, когато няма история или собственикът я е скрил.
report_date - Дата, към която е съставен докладът.
first_registration_date - Кога автомобилът е регистриран за първи път.
owner_changes, owner_change_dates - Колко пъти е сменян собственикът и на кои дати.
plate_changes - Колко пъти е сменян регистрационният номер.
plate_history - Регистрации и смени на регистрационния номер: date, use (за какво е използван автомобилът от този ден), vehicle_kind (клас).
use - Текущо използване: "Private use", "Rental", "Commercial use", "Government use".
rental_history, commercial_history, government_history - true, ако автомобилът някога е бил отдаван под наем, използван за търговски цели или от държавни институции.
own_damage_count, own_damage_cost_won - Застрахователни събития с щети по този автомобил: колко и на каква сума.
other_damage_count, other_damage_cost_won - Застрахователни събития, при които този автомобил е нанесъл щети на други: колко и на каква сума.
accidents - Застрахователни събития, първо най-новите: date, damage_to (кой е пострадал: "This car" или "Another car"), paid_by (кой е платил: "This car's insurer" или "Other party's insurer"), insurance_benefit_won (изплатено обезщетение), parts_won, labor_won, painting_won (резервни части, труд, боядисване).
total_loss_count, total_loss_date - Тотална щета на автомобила: колко пъти и кога.
flood_total_loss_count, flood_partial_loss_count, flood_date - Случаи на наводнение: колко с тотална щета, колко с частична щета и датата.
theft_count, theft_date - Кражби: колко и кога.
uninsured_periods - Кога автомобилът е бил без застраховка: from и to, начален и краен месец.
vehicle - Автомобилът в застрахователната база данни: kind (клас), body (каросерия), doors (врати), fuel (гориво), displacement (обем, куб. см), year (година).
GET/change_id
Получаване на първото ID на промяна по дата (за използване в /changes)
Параметри:
date(задължително) - дата във формат yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/encar/change_id?api_key=YOUR_API_KEY&date=2026-10-22Отговор:
{
"change_id": 48107
}Използвайте върнатата стойност като параметър change_id в /changes
GET/changes
Поток от промени (добавени/променени/премахнати)
Параметри:
change_id(задължително) - от кое ID на промяна да се започне
https://{access_name}.auto-api.com/api/v3/encar/changes?api_key=YOUR_API_KEY&change_id=48120Отговор:
{
"result": [
{
"id": 48121,
"inner_id": "41284960",
"change_type": "changed",
"created_at": "2026-10-22T07:14:38Z",
"data": { // цената е променена, новата е в KRW
"new_price": 27500000
}
},
{
"id": 48126,
"inner_id": "40871153",
"change_type": "removed",
"created_at": "2026-10-22T07:31:05Z",
"data": {} // свален от продажба
},
{
"id": 48134,
"inner_id": "43002118",
"change_type": "added",
"created_at": "2026-10-22T07:52:47Z",
"data": { ... } // цялото тяло на обявата
}
// ... следват останалите събития, до 20 на страница
],
"meta": {
"cur_change_id": 48120,
"next_change_id": 48140,
"limit": 20
}
}GET/offer
Една обява по inner_id
Параметри:
inner_id(задължително)
https://{access_name}.auto-api.com/api/v3/encar/offer?api_key=YOUR_API_KEY&inner_id=39464599Отговорът съдържа само обекта data, без обвивката result.
GET/details
Готови списъци с inner_id на обяви, които не са за продажба на автомобил: можете да ги скриете в каталога си
https://{access_name}.auto-api.com/api/v3/encar/details?api_key=YOUR_API_KEYОтговор:
{
"CONTRACT": ["42953666", "42994378", "42985860", ...],
"RENT_LEASE": ["42993494", "42994441", "43001427", ...],
"DUPLICATE": ["42997972", "42998256", "42998942", ...]
}Полета с данни:
CONTRACT- за автомобила вече е в ход сделкаRENT_LEASE- обяви за наем и лизингDUPLICATE- дублирани обяви за един и същ автомобил
В /changes тези обяви идват заедно с останалите. Можете да изключвате такива обяви по тези списъци, а при събития added и по полетата advertisement_type, sales_status, is_duplicate. В /offers това прави for_sale=1.
Грешки
При грешка отговорът съдържа поле error с описание: { "error": "parameter page is required" }
401- ключът api_key не е приет400- липсва задължителен параметър или някоя стойност е в неправилен формат404- няма обява с такъв inner_id (/offer)429- лимитът на заявките е изчерпан
API-то връща данните на обява в encar.com по връзка към нея: полетата както в /offer и блок meta с оставащия лимит.
Базов URL
https://{access_name}.auto-api.com/api/v2/offer/infoОторизация: хедър x-api-key
POST/api/v2/offer/info
Една обява по връзката към нея
Параметри:
url(задължително) - URL адрес на страницата на обявата в encar.com
Примерна заявка:
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
Към месечния лимит се отчитат само отговорите с обява, а грешките не го изразходват.
Грешки
При грешка отговорът съдържа поле error с описание: { "error": "Failed to get info" }
401- ключът x-api-key не е приет400- липсва връзка или тя не е разпозната, или платформата не е включена за ключа422- данните от обявата не могат да бъдат получени429- лимитът на заявките е изчерпан
Политика за съхранение на данните
Файловете се съхраняват поне 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.com стартира през 2001 г. и бързо стана предпочитаната платформа за покупка и продажба на автомобили в Южна Корея. Днес там във всеки момент ще намерите около 240 000 автомобила, обявени за продажба - от миниатюрни кей карове, популярни по тесните улици на Сеул, до вносни автомобили BMW и Mercedes. Сайтът обработва над 15 милиона търсения месечно, което го прави най-големия онлайн пазар за автомобили в Корея.
Едно нещо отличава Encar от типичните сайтове за обяви: там наистина проверяват автомобилите. В Корея при продажба на употребяван автомобил е задължителен доклад от проверката му, който показва кои елементи на каросерията са сменени, ремонтирани или повредени. Освен това Encar прави собствена диагностика на панелите на каросерията. Корейските купувачи дори няма да погледнат автомобил без тези доклади. Платформата показва и застрахователната история на автомобила: застрахователни събития и изплатени по тях обезщетения.
За всеки, който работи с данни за автомобили от Корея, Encar е незаменима платформа. API-то предоставя тези данни непрекъснато чрез подредени крайни точки, включително характеристики на автомобилите, разшифровани пакети с опции, VIN номера и изчистени набори от данни за анализ.
Encar API работи 24/7, като предоставя новите обяви в рамките на минути след публикуването им и следи премахнатите обяви, за да се разбере какви са реалните продажни цени спрямо обявените цени. Тези ключови данни се доставят чрез крайните точки на нашето API без нужда от собствени парсъри или кроулъри.
Разширете покритието на автомобилните си данни по световните пазари с нашите API за отделните платформи: