API për shpallje makinash nga Encar, Mobile.de, Che168, Dongchedi e të tjera

EncarMobile.deAutoScout24Che168GuaziDongchedi+9 të tjera

Qasje në të dhëna të agreguara nga shpalljet e makinave me një API të vetme dhe të besueshme. Monitoroni në kohë reale shpalljet e reja, ndryshimet e çmimeve, publikimin dhe heqjet nga shitja nëpër platforma.

Provoni API-në taniShikoni dokumentacioninQasja jepet brenda 2 minutash
100M+
shpallje
15+
platforma
50+
fusha të dhënash
Koha e përgjigjes<200ms
Statusi i API-së
në funksion

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
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'
Veçoritë e API-së

Të dhëna nga shumë platforma

Tërhiqni shpallje makinash nga Encar, Mobile.de, AutoScout24 e të tjera me një API të vetme.

Përditësime në kohë reale

Merrni shpalljet e reja, ndryshimet e çmimeve dhe heqjet nga shitja kur ndodhin.

Analitikë tregu

Të dhëna historike dhe tendenca për analizë çmimesh dhe studim tregu.

Dërgim fleksibël

Zgjidhni midis qasjes në API në kohë reale dhe eksportimeve ditore masive në CSV, JSON, Excel.

Tregje botërore

Mbulim në Evropë, Azi, Lindjen e Mesme dhe Amerikën e Veriut.

Integrim i thjeshtë

RESTful API me dokumentacion dhe shembuj kodi që funksionojnë.