Encar APIScraper & Parser
Eksportime ditore e në kohë reale: shpallje automjetesh, çmime, specifikime, diagnostikim, historik aksidentesh. Qasje profesionale në të dhëna automobilistike.
Encar API
Merrni qasje në të gjithë tregun korean të makinave me një API të vetme. Të dhëna shpalljesh, të pastra dhe të strukturuara, për analitikë dhe vendime blerjeje. Nuk keni nevojë të ndërtoni scraper vetë.
Qasje e plotë në të gjitha të dhënat e shpalljeve përmes endpoint-eve të API-së, si dhe monitorim në kohë reale i automjeteve të sapodala në shitje, të përditësuara dhe të hequra nga shitja.
Shkarkoni çdo ditë pamje të plota të tregut në formatet CSV, JSON ose Excel.
Përfshin çdo fushë të disponueshme: çmimi, kilometrazhi, specifikimet, fotot, të dhënat e shitësit, raportet e diagnostikimit, historiku i aksidenteve dhe të gjitha opsionet.
Nëse një shpallje ka raportin e inspektimit, diagnostikimin e Encar ose historikun e sigurimit, ato vijnë tashmë të strukturuara. Opsionet janë të ndara në grupe.
URL bazë
https://{access_name}.auto-api.com/api/v3/encarAutorizimi: api_key parametër
Rrjedha e punës
/filtersmerrni vlerat e disponueshme të filtraveNgarkimi fillestar:
/change_id?date=...merrni ID-në fillestare për fluksin e ndryshimeve/offersmerrni të gjitha shpalljet faqe pas faqeje/changes?change_id=...merrni të gjitha ndryshimet në bazën e të dhënave duke filluar nga ID-ja/offermerrni të dhënat e një shpalljeje të caktuar sipas inner_id/detailslista me inner_id të shpalljeve që ia vlen të përjashtohen nga katalogupërfshijnë shpalljet me qira dhe me lizing, makinat me shitblerje tashmë në proces dhe shpalljet e përsëritura
në /offers të njëjtën gjë e bën for_sale=1, ndërsa në /changes ngjarja added e tregon këtë në advertisement_type, sales_status dhe is_duplicate
Si të filloni:
1. Para ngarkimit të parë, merrni numrin nga /change_id për datën e sotme dhe ruajeni. Pastaj kaloni nëpër /offers faqe pas faqeje deri në fund: në faqen e fundit next_page është null.
2. Më pas thirrni rregullisht /changes duke filluar nga ky numër dhe dërgoni next_change_id nga çdo përgjigje. Kështu vijnë shpalljet e reja, çmimet e reja dhe heqjet nga shitja. Nëse next_change_id është null, ende nuk ka ngjarje: përsëritni të njëjtën kërkesë më vonë.
3. Për të kërkuar sipas kritereve tuaja, thirrni /offers me filtra.
Formati i të dhënave
- Llojet e të dhënave ruhen: një numër vjen si numër, një listë si varg, një vlerë që mungon si null.
- Vulat kohore janë në UTC, për shembull "2026-06-17T12:24:51Z". Datat jepen si "2021-04-02", muajt si "2021-04".
- Të gjitha shumat janë në KRW.
- Çdo shpallje ka të njëjtët çelësa. Nëse një bllok si diagnostikimi i Encar nuk ka të dhëna, blloku është null.
GET/filters
Kthen të gjitha vlerat e mundshme për filtrim
https://{access_name}.auto-api.com/api/v3/encar/filters?api_key=YOUR_API_KEYPërgjigjja:
{
"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
Shpalljet faqe pas faqeje. Filtrat i ngushtojnë rezultatet.
Parametrat:
page(i detyrueshëm) - numri i faqesmark, model, configuration, complectation- emrat e markës, modelit, versionit dhe variantit, siç shkruhen në /filterstransmission_type, color, body_type, engine_type- vlerat e transmisionit, ngjyrës, karrocerisë dhe karburantit, pa dallim midis shkronjave të mëdha dhe të voglayear_from, year_to- viti i modelit, nga dhe derikm_age_from, km_age_to- kilometrazhi në km, nga dhe deriprice_from, price_to- çmimi në won, nga dhe derivin- kërkim sipas VINfor_sale=1- përjashtoni nga rezultatet shpalljet me qira dhe me lizing, makinat me shitblerje në proces dhe shpalljet e përsëritura
Për të dërguar disa vlera në një filtër, përsëritni parametrin me kllapa katrore: 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=50000000Përgjigjja:
{
"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": { // vlerat origjinale nga 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
}
}Fushat e të dhënave:
Shpallja
id - ID-ja e brendshme në bazën e të dhënave
inner_id - ID-ja e shpalljes në platformë
url - lidhja e shpalljes
price, currency - Çmimi në won, currency është gjithmonë KRW. Te shpalljet me qira dhe me lizing ky nuk është çmimi i makinës, kushtet e marrëveshjes jepen në lease.
section - "Used" ose "New".
advertisement_type - Çfarë ofron shpallja: "Sale", "Operating lease", "Finance lease", "Rental takeover", "Rental".
sales_status - "Available", ose "Reserved" nëse shitblerja e makinës është tashmë në proces.
is_duplicate, duplicate_of - true kur kjo është edhe një shpallje për të njëjtën makinë. Atëherë duplicate_of përmban numrin inner_id të shpalljes së parë.
lease - Për shpalljet me qira dhe me lizing: monthly_payment_won (kësti mujor), months_left (muajt e mbetur), deposit_won (depozita), advance_payment_won (paradhënia), residual_value_won (vlera e mbetur). Për shpalljet e shitjes është null.
seller_headline - Mbishkrimi i shitësit mbi shpalljen. Nëse ka disa mbishkrime, secili fillon në rresht të ri.
description - përshkrimi
offer_created - Koha e ndryshimit të fundit të shpalljes nga shitësi.
first_advertised_at - Koha kur makina u nxor në shitje.
created_at - Koha kur shpallja hyri në bazën tonë të të dhënave.
Makina
mark, model - Marka dhe modeli.
generation, generation_code - Gjenerata. Kodi i karrocerisë (G05, W213 e të ngjashme) jepet vetëm për disa modele.
configuration, complectation - Versioni (motori, tërheqja, numri i vendeve) dhe varianti.
year, model_year - Viti i modelit, të dyja fushat janë të njëjta.
year_month - Viti dhe muaji i prodhimit.
first_registration_date, first_registration - Regjistrimi i parë: data e plotë dhe muaji.
km_age - kilometrazhi në km
owners_count - Sa pronarë ka pasur makina.
vin - VIN me 17 karaktere.
plate_number - Numri i targës.
is_domestic - true për markat koreane.
import_type - Për markat e huaja: "Official import" ose "Parallel import".
is_brand_certified - true nëse makina ka kaluar certifikimin e prodhuesit.
pledge_count, seizure_count - Sa pengje dhe sekuestrime janë regjistruar për makinën.
Specifikimet
engine_type, transmission_type, body_type - Motori, transmisioni dhe karroceria.
drive_type - Tërheqja (2WD, 4WD, AWD), nuk jepet për çdo makinë.
displacement, displacement_cc - Vëllimi i motorit në litra dhe në centimetra kub.
power - Fuqia totale, hp.
power_ice_hp - Fuqia e motorit me djegie të brendshme, hp.
power_electro_kw - Fuqia e pjesës elektrike, kW.
seat_count - Numri i vendeve.
color, color_hex - Ngjyra e karrocerisë me fjalë dhe si kod HEX.
color_seller_note - Shënimi i shitësit për ngjyrën.
seat_color, seat_color_hex - Ngjyra e brendësisë me fjalë dhe si kod HEX.
Shitësi
seller_type, is_dealer - "Dealer" ose "Private seller", is_dealer e përsërit këtë si true/false.
is_owner_verified - true nëse Encar ka verifikuar që shitësi është pronari i makinës.
seller - Shitësi, siç është emërtuar në Encar.
salon_id, seller_firm - ID-ja dhe emri i kompanisë së tregtarit.
region, address - Ku ndodhet shitësi: rajoni dhe adresa.
Fotot, opsionet dhe të dhënat referuese
photos - varg me URL imazhesh
photo_details - Të njëjtat foto, secila me llojin në type dhe lidhjen në url. Fotot e pjesës së poshtme të makinës, të bëra gjatë diagnostikimit të Encar, vijnë të fundit. Llojet: "Exterior", "Interior", "Options", "Thumbnail", "Encar diagnosis", "Underbody", "Underbody front left", "Underbody front right", "Underbody rear left", "Underbody rear right".
options - Opsionet, të ndara në grupet "Exterior", "Interior", "Safety", "Comfort", "Multimedia", "Seats", "Tuning". Grupet pa opsione nuk kthehen.
options_seller_notes - Shtesat e shitësit në listën e opsioneve.
tire_seller_note - Komenti i shitësit për gomat.
original - Emrat dhe vlerat origjinale nga encar.com.
catalog_ids - Kodet e makinës në katalogun e encar.com, nga marka deri te varianti, si dhe kodi JATO.
Raporti i inspektimit (inspection)
Dokumenti i inspektimit para shitjes. Pa këtë dokument, inspection është null. Nëse raporti është bashkëngjitur vetëm si skanime, janë të plotësuara vetëm fushat scans, accident dhe simple_repair.
record_number, issue_date - Numri i raportit dhe data e lëshimit.
valid_from, valid_until - Dita e parë dhe dita e fundit e vlefshmërisë së kontrollit teknik.
first_registration_date, model_year, mileage - Të dhënat e makinës sipas raportit: regjistrimi i parë, viti, kilometrazhi në km.
engine_code - Kodi i motorit.
warranty_type - Garancia e kujt përmendet në raport: "Seller warranty" ose "Insurance company warranty".
accident - true nëse sipas rregullave të raportit makina konsiderohet e aksidentuar: janë riparuar ose ndërruar pjesë të kornizës strukturore, ose është prerë dhe salduar një parafango e pasme, tavani ose një prag anësor.
simple_repair - true nëse janë riparuar ose ndërruar pjesë që montohen me bulona.
flood - true nëse makina ka qenë e përmbytur.
special_history - Shënime të veçanta në raport, për shembull "Flood".
recall, recall_completed - Nëse makina përfshihet në një fushatë rikthimi në servis dhe nëse punimet e fushatës janë kryer (true/false).
tuning, tuning_types - Tregues nëse ka tuning (true/false) dhe lista e llojeve: "Legal", "Illegal", "Structural modification", "Equipment modification".
usage_changes - Përdorimi i mëparshëm i makinës, nëse ka ndryshuar: "Rental", "Lease", "Commercial use".
odometer_state - Gjendja e odometrit: "Good" ose "Faulty".
mileage_assessment - Si e vlerëson raporti kilometrazhin: "High", "Average", "Low".
vin_state - Gjendja e numrit të shasisë: "Normal", "Corroded", "Damaged", "Mismatch", "Altered", "Erased".
co_percent, hc_ppm, smoke_percent - Matja e gazrave të shkarkimit: CO (%), hidrokarburet (ppm), tymi (%).
comment - Komenti i inspektorit.
panels - Pjesët e karrocerisë me vërejtje, të ndara sipas grupeve të raportit "Outer panels, rank 1", "Outer panels, rank 2", "Structural frame, rank A", "Structural frame, rank B", "Structural frame, rank C". Çdo pjesë ka shenjën e vet: "Replaced", "Sheet metal work or welding", "Cutting and welding", "Corrosion", "Scratch", "Dent", "Damage".
systems - Seksionet e raportit me komponentët dhe sistemet, çdo element ka një vlerësim: "Good", "Normal", "None", "Minor leak", "Leak", "Low", "High", "Faulty", "Present".
photos, scans - Fotot e bëra gjatë inspektimit dhe kopjet e skanuara të vetë raportit.
Diagnostikimi i Encar (diagnosis)
Kontroll i karrocerisë nga një punonjës i Encar. Nëse makina nuk është diagnostikuar, diagnosis është null.
date, center - Kur dhe ku u krye diagnostikimi.
result - Përfundimi: "No panels replaced, frame intact" ose "Outer panels replaced, frame intact".
panels - Tetë pjesë të jashtme të karrocerisë, secila me një rezultat: "No issues", "Replaced", "Repaired", "Painted".
comment, panels_comment - Përfundimi i specialistit dhe komenti i tij për karrocerinë.
Historiku i sigurimit (history)
Dëmshpërblimet e sigurimit, ndërrimet e pronarit dhe ndërrimet e targës. history është null kur nuk ka historik ose kur pronari e ka fshehur.
report_date - Data për të cilën është përpiluar raporti.
first_registration_date - Kur u regjistrua makina për herë të parë.
owner_changes, owner_change_dates - Sa herë është ndërruar pronari dhe në cilat ditë.
plate_changes - Sa herë është ndërruar targa.
plate_history - Regjistrimet dhe ndërrimet e targës: date, use (për çfarë është përdorur makina nga ajo ditë), vehicle_kind (klasa).
use - Përdorimi aktual: "Private use", "Rental", "Commercial use", "Government use".
rental_history, commercial_history, government_history - true nëse makina është përdorur ndonjëherë për qira, për qëllime komerciale ose nga shteti.
own_damage_count, own_damage_cost_won - Rastet e sigurimit ku u dëmtua kjo makinë: sa raste dhe për çfarë shume.
other_damage_count, other_damage_cost_won - Rastet e sigurimit ku kjo makinë dëmtoi të tjerë: sa raste dhe për çfarë shume.
accidents - Rastet e sigurimit, duke filluar nga më i fundit: date, damage_to (cila makinë u dëmtua: "This car" ose "Another car"), paid_by (kush pagoi: "This car's insurer" ose "Other party's insurer"), insurance_benefit_won (dëmshpërblimi), parts_won, labor_won, painting_won (kostoja e pjesëve, e punës dhe e lyerjes).
total_loss_count, total_loss_date - Dëmi total i makinës: sa herë dhe kur.
flood_total_loss_count, flood_partial_loss_count, flood_date - Përmbytjet: sa me dëm total, sa me dëm të pjesshëm dhe data.
theft_count, theft_date - Vjedhjet: sa herë dhe kur.
uninsured_periods - Kur makina ka qenë pa sigurim: from dhe to, muajt e fillimit dhe të mbarimit.
vehicle - Makina në bazën e të dhënave të sigurimeve: kind (klasa), body (karroceria), doors (dyert), fuel (karburanti), displacement (vëllimi, cc), year (viti).
GET/change_id
Merrni ID-në e parë të ndryshimit sipas datës (për përdorim në /changes)
Parametrat:
date(i detyrueshëm) - data në formatin yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/encar/change_id?api_key=YOUR_API_KEY&date=2026-10-22Përgjigjja:
{
"change_id": 48107
}Përdorni vlerën e kthyer si parametrin change_id në /changes
GET/changes
Fluksi i ndryshimeve (të shtuara/të ndryshuara/të hequra)
Parametrat:
change_id(i detyrueshëm) - nga cila ID ndryshimi të fillohet
https://{access_name}.auto-api.com/api/v3/encar/changes?api_key=YOUR_API_KEY&change_id=48120Përgjigjja:
{
"result": [
{
"id": 48121,
"inner_id": "41284960",
"change_type": "changed",
"created_at": "2026-10-22T07:14:38Z",
"data": { // çmimi ndryshoi, çmimi i ri në KRW
"new_price": 27500000
}
},
{
"id": 48126,
"inner_id": "40871153",
"change_type": "removed",
"created_at": "2026-10-22T07:31:05Z",
"data": {} // u hoq nga shitja
},
{
"id": 48134,
"inner_id": "43002118",
"change_type": "added",
"created_at": "2026-10-22T07:52:47Z",
"data": { ... } // trupi i plotë i shpalljes
}
// ... pastaj ngjarjet e tjera, deri në 20 për faqe
],
"meta": {
"cur_change_id": 48120,
"next_change_id": 48140,
"limit": 20
}
}GET/offer
Një shpallje e vetme sipas inner_id
Parametrat:
inner_id(i detyrueshëm)
https://{access_name}.auto-api.com/api/v3/encar/offer?api_key=YOUR_API_KEY&inner_id=39464599Përgjigjja përmban vetëm objektin data, pa mbështjellësin result.
GET/details
Lista të gatshme me inner_id të shpalljeve që nuk janë shitje makinash: këto shpallje mund t'i fshihni nga katalogu
https://{access_name}.auto-api.com/api/v3/encar/details?api_key=YOUR_API_KEYPërgjigjja:
{
"CONTRACT": ["42953666", "42994378", "42985860", ...],
"RENT_LEASE": ["42993494", "42994441", "43001427", ...],
"DUPLICATE": ["42997972", "42998256", "42998942", ...]
}Fushat e të dhënave:
CONTRACT- shitblerja e makinës është tashmë në procesRENT_LEASE- shpallje me qira dhe me lizingDUPLICATE- shpallje të përsëritura për të njëjtën makinë
Në /changes këto shpallje vijnë bashkë me të tjerat. Mund t'i përjashtoni këto shpallje me anë të këtyre listave, ndërsa te ngjarjet added edhe sipas advertisement_type, sales_status, is_duplicate. Në /offers këtë e bën for_sale=1.
Gabimet
Në rast gabimi, përgjigjja ka fushën error me një përshkrim: { "error": "parameter page is required" }
401- api_key nuk u pranua400- mungon një parametër i detyrueshëm ose një vlerë ka format të gabuar404- nuk ka shpallje me këtë inner_id (/offer)429- limiti i kërkesave është shteruar
Sipas lidhjes së një shpalljeje në encar.com, API-ja kthen të dhënat e saj: fushat si në /offer dhe një bllok meta me limitin e mbetur.
URL bazë
https://{access_name}.auto-api.com/api/v2/offer/infoAutorizimi: header x-api-key
POST/api/v2/offer/info
Një shpallje sipas lidhjes së saj
Parametrat:
url(i detyrueshëm) - adresa e faqes së shpalljes në encar.com
Shembull kërkese:
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" }'Përgjigjja:
{
"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,
// ... fushat e tjera të shpalljes, si në /offer në API v3
"meta": {
"requests_made": 48,
"requests_left": 1952,
"requests_limit": 2000,
"period_start": "2026-11",
"platform": "encar"
}
}Fushat e shpalljes janë të njëjta me ato që kthen /offer në API v3. Blloku meta vjen i fundit.
Çfarë ka në meta:
requests_made- sa kërkesa të suksesshme janë bërë këtë muajrequests_left- sa kërkesa mund të bëni enderequests_limit- limiti mujorperiod_start- muaji i numëruesitplatform- nga cila platformë është shpallja: encar, che168, dongchedi, guazi ose mobilede
Në limitin mujor llogariten vetëm përgjigjet me shpallje; gabimet nuk e harxhojnë.
Gabimet
Në rast gabimi, përgjigjja ka fushën error me një përshkrim: { "error": "Failed to get info" }
401- x-api-key nuk u pranua400- lidhja mungon ose nuk u lexua dot, ose platforma nuk është aktivizuar për çelësin422- të dhënat e shpalljes nuk u morën dot429- limiti i kërkesave është shteruar
Politika e ruajtjes së të dhënave
Skedarët ruhen të paktën 3+ ditë
Orari i disponueshmërisë së API-së
Skedarë ditorë të rinj, të disponueshëm për shkarkim
Formati i të dhënave CSV
Skedarët CSV përdorin vijën vertikale (|) si ndarës kolonash
Struktura e URL-së:
Parametrat e kërkesës:
access_name- identifikuesi i nëndomenit që ju është caktuardate- data e dëshiruar në formatin yyyy-mm-dd (p.sh. 2025-09-06)file_name- emri i skedarit të eksportimit me prapashtesë
Formatet e disponueshme:
- 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
Shembull kërkese API me 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.csvKomanda e shkarkimit me Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Encar.com nisi punën në vitin 2001 dhe shpejt u bë platforma kryesore për blerjen dhe shitjen e makinave në Korenë e Jugut. Sot aty gjeni në çdo moment rreth 240 000 makina në shitje, nga makinat e vockla kei car, të preferuara në rrugët e ngushta të Seulit, deri te BMW dhe Mercedes të importuara. Faqja e internetit përpunon mbi 15 milionë kërkime në muaj, gjë që e bën platformën më të madhe automobilistike në Kore.
Një gjë e dallon Encar nga portalet e zakonshme të shpalljeve: platforma i verifikon vërtet makinat. Raporti i inspektimit është i detyrueshëm në Kore për shitjen e makinave të përdorura dhe tregon cilat pjesë të karrocerisë janë ndërruar, riparuar ose dëmtuar. Përveç kësaj, Encar kryen diagnostikimin e vet të paneleve të karrocerisë. Blerësit koreanë as nuk shikojnë një makinë pa këto raporte. Platforma tregon edhe historikun e sigurimit të makinës: rastet e sigurimit dhe dëmshpërblimet e tyre.
Për këdo që punon me të dhëna automjetesh nga Koreja, Encar është platforma e domosdoshme. API-ja i jep këto të dhëna vazhdimisht përmes endpoint-eve të organizuara, përfshirë specifikime automjetesh, paketa opsionesh të dekoduara, numra VIN dhe sete të pastra të dhënash për analizë.
Encar API punon 24/7, jep shpalljet e reja brenda pak minutash nga publikimi dhe ndjek heqjet nga shitja, për të kuptuar çmimet reale të shitjes kundrejt çmimeve të kërkuara. Këto të dhëna thelbësore jepen përmes endpoint-eve të API-së sonë, pa nevojë për parser apo crawler të ndërtuar vetë.
Zgjeroni mbulimin e të dhënave tuaja automobilistike në tregjet botërore me API-të tona të platformave: