DokumentacioniReferenca e API-së

Dokumentacioni i API-së së scraper-it automobilistik. Mësoni të merrni të dhëna makinash me endpoint-e API të drejtpërdrejta. Udhëzues integrimi e shembuj kodi.

Biblioteka zyrtare SDK

Biblioteka klienti gati për përdorim, për integrim të shpejtë me API-në në gjuhën tuaj të preferuar të programimit.

PHPNode.jsPythonGoC#JavaRubyRust

Të dhëna automobilistike të pastra dhe të strukturuara, që jepen përmes API-së. Nuk nevojitet konfigurim i ndërlikuar, menaxhim infrastrukture apo mirëmbajtje teknike.

Pse të na zgjidhni

Përvojë në industri

Ofrues API për të dhëna automobilistike me mbi 8 vjet përvojë, që nga viti 2017.

Mbështetje 7 ditë në javë

Ekipi i mbështetjes është i disponueshëm 7 ditë në javë për ndihmë në integrimin me API-në.

Shërbim 24/7

Monitorim ditë e natë për dërgim të besueshëm të të dhënave.

Mundësitë kryesore të API-së | Scraper dhe parser

Njoftime në kohë reale për shpalljet

Merrni qasje të menjëhershme përmes API-së në shpalljet e reja të makinave sapo publikohen.

Eksportime ditore të të dhënave

Merrni eksportime ditore të shpalljeve aktive dhe të hequra për analizë tregu dhe ndjekje të shitjeve.

Formate fleksibile eksportimi

Merrni të dhëna në formatet CSV, JSON, Excel dhe në formate të personalizuara, për integrim të lehtë.

Pyetje të shpeshta | API apo scraper dhe crawler

Si funksionon API-ja automobilistike?

API-ja automobilistike jep qasje në kohë reale në të dhëna nga platformat kryesore të makinave. Jep të dhëna të formatuara përmes REST API.

Çfarë të dhënash jep API-ja automobilistike?

Të dhëna të plota të makinave, duke përfshirë specifikimet, çmimet, të dhënat e shitësit, vendndodhjen dhe kilometrazhin. Merrni qasje në miliona shpallje nga platformat kryesore përmes thirrjeve API.

A ka limite përdorimi?

Pa limite përdorimi. Merrni të gjitha shpalljet aktive nëpër rajone përmes API-së në kohë reale ose eksportimeve ditore. Pa kufizime për partnerët e biznesit.

Si mund t'i ndjek shpalljet e reja të makinave përmes API-së në kohë reale?

Monitoroni shpalljet me parametrin 'change_id'. Nisni me change_id=0, pastaj përdorni ID-në e fundit të ndryshimit + 1. Kapen shpalljet e reja, ndryshimet e çmimeve, heqjet nga shitja nëpër platforma.

Cilat formate të dhënash mbështetni?

Merrni të dhëna në formatet CSV, JSON, Excel dhe në formate bazash të dhënash. Çdo format jep të dhëna gjithëpërfshirëse nga të gjitha platformat.

A mund të ndërtoni qasje të personalizuar në API për një platformë të caktuar?

Po, ndërtojmë zgjidhje API të personalizuara për çdo platformë makinash. Na kontaktoni me kërkesat tuaja.

A mbahet konfidencial përdorimi im i të dhënave?

Po. Punojmë me marrëveshje të rrepta konfidencialiteti me të gjithë klientët. Përdorimi juaj i shërbimeve tona mbetet privat dhe i sigurt.

A më duhet të menaxhoj infrastrukturë ose serverë?

Jo, shërbimi menaxhohet plotësisht nga ne. Kujdesemi për të gjithë infrastrukturën, serverët dhe mbledhjen e të dhënave. Ju merrni të dhëna gati për përdorim.

API Reference

URL bazë

https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}

Autorizimi: api_key parameter

Rrjedha e punës

1
/filtersmerrni vlerat e disponueshme të filtrave
2
/offersmerrni shpallje (me ose pa filtra) - përdoreni për ngarkimin fillestar të të dhënave
3

Për përditësime (që t'i mbani të dhënat të përditësuara pas ngarkimit fillestar):

/change_id?date=...merrni ID-në fillestare për fluksin e ndryshimeve
/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

Mënyra e rekomanduar e integrimit:

1. Së pari përdorni /offers për marrjen fillestare të të dhënave (kaloni nëpër të gjitha faqet)

2. Më pas përdorni /changes për marrjen periodike të të gjitha ndryshimeve (të shtuara/të ndryshuara/të hequra), që të sinkronizoni bazën tuaj lokale të të dhënave me burimin

3. Për integrimin e të dhënave në një faqe interneti mund të përdorni /offers me filtra dhe faqosje (marka, modeli, çmimi, viti etj.)

GET/filters

Kthen të gjitha vlerat e mundshme për filtrim

https://{access_name}.auto-api.com/api/v2/{platform}/filters?api_key=YOUR_API_KEY

Përgjigjja:

{
  "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

Lista e shpalljeve me faqosje dhe filtra

Parametrat:

  • page (i detyrueshëm) - numri i faqes
  • mark, model, configuration, complectation - filters (pa dallim midis shkronjave të mëdha dhe të vogla)
  • transmission_type, color, body_type, engine_type - filters (pa dallim midis shkronjave të mëdha dhe të vogla)
  • year_from, year_to - filtër sipas intervalit të viteve
  • km_age_from, km_age_to - filtër sipas intervalit të kilometrazhit
  • price_from, price_to - filtër sipas intervalit të çmimit (në njësi prej 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

Përgjigjja:

{
  "result": [
    {
      "id": 3219435,
      "inner_id": "40427050",
      "change_type": "added",
      "created_at": "2025-09-08T12:02:03.000Z",
      "data": {
        "id": 1454012,
        "inner_id": "40427050",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
        "mark": "Hyundai",
        "model": "Palisade",
        "generation": "Diesel 2.2 4WD",
        "configuration": "Diesel 2.2 4WD",
        "complectation": "Prestige",
        "year": 2021,
        "color": "Black",
        "price": 3190,
        "price_won": "31900000",
        "km_age": 92842,
        "engine_type": "Diesel",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "address": "Busan Gijang-gun",
        "seller_type": "DEALER",
        "is_dealer": true,
        "images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
        "extra": {"diagnosis": {...}, "inspection": {...}, "accidents": [...]}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Fushat e të dhënave:

  • id - ID-ja e brendshme në bazën e të dhënave
  • inner_id - ID-ja e shpalljes në platformë
  • url - lidhja e shpalljes
  • mark - marka e makinës
  • model - modeli i makinës
  • generation - gjenerata
  • configuration - versioni
  • complectation - varianti
  • year - viti i prodhimit
  • color - ngjyra
  • price - çmimi (në njësi prej 10000 KRW)
  • price_won - çmimi i plotë në KRW
  • km_age - kilometrazhi në km
  • engine_type - lloji i motorit
  • transmission_type - lloji i transmisionit
  • body_type - lloji i karrocerisë
  • address - adresa
  • seller_type - lloji i shitësit
  • is_dealer - tregues nëse shitësi është tregtar (true/false)
  • section - seksioni
  • seller - shitësi
  • salon_id - ID-ja e tregtarit
  • description - përshkrimi
  • displacement - vëllimi i motorit (cc)
  • offer_created - data e krijimit të shpalljes
  • images - varg me URL imazhesh
  • extra - të dhëna shtesë (JSON)
  • options - lista e opsioneve

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/v2/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Përgjigjja:

{ "change_id": 1547283 }

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/v2/{platform}/changes?api_key=YOUR_API_KEY&change_id=1

Përgjigjja:

{
  "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

Një shpallje e vetme sipas inner_id

Parametrat:

  • inner_id (i detyrueshëm)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050

Përgjigjja: objekti data (i njëjtë si në /offers, por pa mbështjellësin result)

Merrni shpalljen sipas URL-së

Tërhiqni të dhënat e plota të shpalljes duke dërguar URL-në origjinale nga çdo platformë e mbështetur. Përshtatet shumë mirë për kërkime të shpejta dhe për marrjen e një shpalljeje të vetme.

URL bazë

https://{access_name}.auto-api.com/api/v1/offer/info

Autorizimi përmes header-it x-api-key

POST/api/v1/offer/info

Dërgoni një kërkesë POST me URL-në e shpalljes për të marrë të dhënat e plota

Parametrat:

  • url (i detyrueshëm) - lidhja e shpalljes në çdo platformë të mbështetur

Shembull kërkese:

curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419" }'

Përgjigjja:

{
  "inner_id": "39225419",
  "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
  "mark": "BMW",
  "model": "5-Series",
  "generation": "528i",
  "year": 2010,
  "year_month": "2010-08",
  "color": "Silver",
  "price": 880,
  "price_won": 8800000,
  "km_age": 132437,
  "engine_type": "Gasoline",
  "transmission_type": "Automatic",
  "body_type": "Sedan",
  "displacement": "2996",
  "power": "230",
  "vin": "WBAFR1105AC258998",
  "address": "Gwangju Seo-gu",
  "seller_type": "DEALER",
  "is_dealer": true,
  "offer_created": "2025-11-17",
  "images": [
    "https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
    "https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
  ]
}

Fushat e të dhënave:

  • inner_id - ID-ja e shpalljes në platformë
  • url - lidhja e shpalljes
  • mark - marka e makinës
  • model - modeli i makinës
  • generation - gjenerata
  • year - viti i prodhimit
  • year_month - viti dhe muaji i prodhimit
  • color - ngjyra
  • price - çmimi në njësi prej 10000 KRW
  • km_age - kilometrazhi në km
  • engine_type - lloji i motorit
  • transmission_type - lloji i transmisionit
  • body_type - lloji i karrocerisë
  • displacement - vëllimi i motorit (cc)
  • power - fuqia në hp
  • vin - kodi VIN
  • address - adresa
  • seller_type - lloji i shitësit
  • is_dealer - tregues nëse shitësi është tregtar (true/false)
  • offer_created - data e krijimit të shpalljes
  • images - varg me URL imazhesh
Eksportime ditore

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'