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.

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": {...}, "record_open": {...}}
      }
    }
  ],
  "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 - diagnostikimi, raporti i inspektimit dhe historiku i sigurimit
    • diagnosis - diagnostikimi i paneleve të karrocerisë nga Encar
    • inspection - raporti i inspektimit, përfshirë skemën e dëmtimeve të karrocerisë në extra.inspection.outers si listë pjesësh me shenjat e tyre
    • record_open - historiku i sigurimit, përfshirë rastet e sigurimit dhe dëmshpërblimet e tyre në extra.record_open.accidents
  • 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)

Sipas lidhjes së një shpalljeje në encar, che168, dongchedi, guazi ose mobile.de, API-ja kthen të dhënat e saj: fushat si në /offer në API v3 për atë platformë 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ë njërën nga këto platforma

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

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'

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