AUTO-API.COM
Encar

Encar APIScraper & Parser

Eksportime ditore e në kohë reale: shpallje automjetesh, çmime, specifikime, diagnostikim, historik aksidentesh. Qasje profesionale në të dhëna automobilistike.

Biblioteka zyrtare SDK

Zgjidhni gjuhën tuaj, instaloni paketën dhe filloni të tërhiqni shpallje nga Encar. Autentikimi, faqosja dhe parsimi bëhen për ju.

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ë.

API

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.

Eksportime ditore

Shkarkoni çdo ditë pamje të plota të tregut në formatet CSV, JSON ose Excel.

Të dhëna të plota

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.

Merrni qasje në APIQasja jepet brenda 2 minutash

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/encar

Autorizimi: api_key parametër

Rrjedha e punës

1
/filtersmerrni vlerat e disponueshme të filtrave
2

Ngarkimi fillestar:

/change_id?date=...merrni ID-në fillestare për fluksin e ndryshimeve
/offersmerrni të gjitha shpalljet faqe pas faqeje
3
/changes?change_id=...merrni të gjitha ndryshimet në bazën e të dhënave duke filluar nga ID-ja
4
/offermerrni të dhënat e një shpalljeje të caktuar sipas inner_id
5
/detailslista me inner_id të shpalljeve që ia vlen të përjashtohen nga katalogu

pë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_KEY

Pë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 faqes
  • mark, model, configuration, complectation - emrat e markës, modelit, versionit dhe variantit, siç shkruhen në /filters
  • transmission_type, color, body_type, engine_type - vlerat e transmisionit, ngjyrës, karrocerisë dhe karburantit, pa dallim midis shkronjave të mëdha dhe të vogla
  • year_from, year_to - viti i modelit, nga dhe deri
  • km_age_from, km_age_to - kilometrazhi në km, nga dhe deri
  • price_from, price_to - çmimi në won, nga dhe deri
  • vin - kërkim sipas VIN
  • for_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=50000000

Pë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-22

Pë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=48120

Pë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=39464599

Pë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_KEY

Pë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ë proces
  • RENT_LEASE - shpallje me qira dhe me lizing
  • DUPLICATE - 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 pranua
  • 400 - mungon një parametër i detyrueshëm ose një vlerë ka format të gabuar
  • 404 - 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/info

Autorizimi: 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ë muaj
  • requests_left - sa kërkesa mund të bëni ende
  • requests_limit - limiti mujor
  • period_start - muaji i numëruesit
  • platform - 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 pranua
  • 400 - lidhja mungon ose nuk u lexua dot, ose platforma nuk është aktivizuar për çelësin
  • 422 - të dhënat e shpalljes nuk u morën dot
  • 429 - 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ë:

https://{access_name}.auto-api.com/{date}/{file_name}

Parametrat e kërkesës:

  • access_name - identifikuesi i nëndomenit që ju është caktuar
  • date - 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.csv

Komanda 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

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ë.

Përgjigje brenda 2 min