AUTO-API.COM
Logoja e KB Chachacha

KB Chachacha APIScraper & Parser

KB Chachacha API: shpallje të tregtarëve koreanë me çmime në won, vlerësim të çmimit të tregut, raste sigurimi, tregues për peng dhe sekuestrim, pajisje e foto.

Biblioteka zyrtare SDK

SDK-të tona i përmbajnë metodat e API-së si funksione të gatshme, dhe bibliotekat janë me kod të hapur në GitHub.

KB Chachacha API

Në KB Chachacha API, çmimi i shitësit vjen bashkë me vlerësimin e çmimit të tregut nga vetë KB Chachacha: kufiri i poshtëm, mesatarja dhe kufiri i sipërm. Me to është e lehtë të krahasoni shpalljet për të njëjtin model, ndërsa rastet e sigurimit dhe treguesit për peng dhe sekuestrim ju ndihmojnë të zgjidhni shpallje për t'i parë më nga afër. Në anën tuaj nuk nevojitet scraper apo parser për kbchachacha.com: emrat janë tashmë të përkthyer në anglisht, pajisjet vijnë si listë, dhe të dhënat e kontaktit të autosallonit bashkë me fotot janë pjesë e përgjigjes.

API

Shpalljet e reja në KB Chachacha, ndryshimet e çmimeve dhe heqjet nga shitja vijnë si ngjarje përmes /changes.

Eksportime ditore

Një skedar ditor me shpalljet e KB Chachacha që janë aktive atë mëngjes.

Të dhëna të plota

Marka, modeli, gjenerata dhe varianti, viti i modelit dhe muaji i regjistrimit, kilometrazhi, karburanti, transmisioni, klasa e automjetit, çmimi dhe vlerësimi i çmimit të tregut nga KB Chachacha, rastet e sigurimit, ndërrimet e pronësisë, pengjet dhe sekuestrimet, pajisjet, shitësi me adresë dhe telefon, fotot.

Merrni qasje në APIQasja jepet brenda 2 minutash

URL bazë

https://{access_name}.auto-api.com/api/v2/kbchachacha

Autorizimi: api_key parametër

Rrjedha e punës

1
/filtersmarkat, modelet dhe vlerat që i pranojnë filtrat
2

Ngarkimi fillestar i shpalljeve:

/change_id?date=...merrni ID-në e ndryshimit për ngjarjen e parë të ditës
/offersshkarkoni shpalljet faqe pas faqeje
3
/changes?change_id=...shpallje të reja, ndryshime çmimesh, heqje nga shitja
4
/offernjë shpallje sipas inner_id

Nga të filloni:

1. Filloni duke bërë përmes /offers kërkimin që ju duhet: vendosni markën, modelin dhe kufij për çmimin ose kilometrazhin. Shkrimin e markave dhe vlerat e filtrave të tjerë merrini nga /filters.

2. Për të mbajtur në anën tuaj një kopje të plotë të shpalljeve, ju duhet pozicioni fillestar i fluksit. Për ta marrë, thirrni /change_id me datën aktuale sipas orës së Seulit; nëse kthen 0, përsëriteni kërkesën më vonë. Pasi ta keni ruajtur, ngarkoni faqet e /offers njëra pas tjetrës: faqja e fundit është ajo ku next_page është null.

3. Pas ngarkimit, zbatoni ngjarjet nga /changes duke filluar nga pozicioni i ruajtur. Kërkoni grupin tjetër të ngjarjeve me next_change_id nga përgjigjja. Kur nuk ka ngjarje, vargu result kthehet bosh dhe next_change_id është null: në thirrjen tjetër dërgoni të njëjtin change_id.

GET/filters

Kthen të gjitha vlerat e mundshme për filtrim

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

Përgjigjja:

{
  "mark": {
    "Kia": {
      "model": ["Carnival", "EV6", "K5", "K8", "Mohave", "Morning", "Niro", "Ray", "Seltos", "Sorento", "Sportage", "Stinger"]
    },
    "Genesis": {
      "model": ["EQ900", "G70", "G80", "G90", "GV60", "GV70", "GV80"]
    },
    "BMW": {
      "model": ["3 Series", "5 Series", "7 Series", "X3", "X5", "X6", "X7", "i4", "i5", "iX"]
    }
    // ... dhe marka të tjera
  },
  "transmission_type": ["Automatic", "CVT", "Manual", "Other"],
  "color": ["Black", "Blue", "Brown", "Gray", "Green", "Orange", "Pearl", "Purple", "Red", "Silver", "White", "Yellow"],
  "body_type": ["Bus", "Compact car", "Full-size car", "Light car", "Mid-size car", "Minivan", "SUV", "Small car", "Sports car", "Truck", "Van"],
  "engine_type": ["CNG", "Diesel", "Electric", "Gasoline", "Gasoline + LPG", "Hybrid", "Hybrid (Diesel)", "Hybrid (Gasoline)", "Hybrid (LPG)", "LPG", "Other"],
  "drive_type": ["2WD", "4WD", "AWD"],
  "region": ["Busan", "Daegu", "Daejeon", "Gangwon", "Gwangju", "Gyeonggi", "Incheon", "Jeju", "North Chungcheong", "North Gyeongsang", "North Jeolla", "Sejong", "Seoul", "South Chungcheong", "South Gyeongsang", "South Jeolla", "Ulsan"]
}

GET/offers

Lista e shpalljeve me faqosje dhe filtra

Parametrat:

  • page (i detyrueshëm) - numri i faqes
  • mark, model - marka dhe modeli, siç shkruhen në /filters
  • transmission_type, color, body_type, engine_type, drive_type, region - transmisioni, ngjyra, klasa e automjetit, karburanti, tërheqja dhe rajoni, siç i kthen metoda /filters; pa dallim midis shkronjave të mëdha dhe të vogla
  • year_from, year_to - intervali për fushën year
  • km_age_from, km_age_to - intervali i kilometrazhit, km
  • price_from, price_to - intervali i çmimit, won
https://{access_name}.auto-api.com/api/v2/kbchachacha/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/kbchachacha/offers?api_key=YOUR_API_KEY&page=1&mark=Kia&model=Mohave&year_from=2021&km_age_to=120000&drive_type=4WD&engine_type=Diesel

Përgjigjja:

{
  "result": [
    {
      "id": 99818,
      "inner_id": "28740959",
      "change_type": "added",
      "created_at": "2026-09-29T07:19:18.930+03:00",
      "data": {
        "id": "99818",
        "inner_id": "28740959",
        "url": "https://www.kbchachacha.com/public/car/detail.kbc?carSeq=28740959",
        "mark": "Kia",
        "model": "Mohave",
        "generation": "Mohave The Master",
        "configuration": "3.0 Diesel 4WD",
        "complectation": "Masters Gravity",
        "year": "2022",
        "price": "31500000",
        "km_age": "109569",
        "color": "Black",
        "engine_type": "Diesel",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "drive_type": "4WD",
        "displacement": "2959",
        "no_accidents": false,
        "equipment": "[\"Heated Front Seats\", \"Ventilated Driver Seat\", \"Rear Parking Sensors\", \"Sunroof\", \"Smart Key\", \"Factory Navigation\"]",  // përgjigjja e plotë ka 53 opsione
        "description": "1인신조~~ 완전무사고차량입니다.... (렌트이력없음)<br/>2022년 7월등록~~ 모하비마스터3.0 디젤 4WD 마스터즈그래비티 풀옵션 차량입니다.. ...",
        "region": "Daejeon",
        "address": "대전광역시 서구 계룡로232번길 31",
        "seller": "주식회사 김서방",
        "seller_type": "Dealer",
        "salon_id": "114501",
        "is_dealer": true,
        "phone": "05048332992",
        "latitude": "36.3477091",
        "longitude": "127.3539739",
        "offer_created": "2026-09-08",
        "images": "[\"https://img.kbchachacha.com/IMG/carimg/l/img04/img2874/28740959_7670067415681513.jpg\", \"https://img.kbchachacha.com/IMG/carimg/l/img04/img2874/28740959_7670070461572003.jpg\"]",  // përgjigjja e plotë ka 31 foto
        "extra_prep": {
          "registration_month": "2022-07",
          "car_number": "289노1892",
          "seats": 7,
          "seat_color": "Black",
          "is_price_on_request": false,
          "is_lease_takeover": false,
          "lease_monthly_payment": null,
          "market_price_min": 29840000,
          "market_price_avg": 33280000,
          "market_price_max": 36720000,
          "insurance_accidents": 1,
          "insurance_accidents_total": 1,
          "total_loss": false,
          "flood": false,
          "owner_changes": 1,
          "seizure": false,
          "mortgage": false,
          "rental_history": false,
          "kb_diagnosis": true,
          "kb_warranty": true,
          "manufacturer_certified": false,
          "partner_certified": false,
          "kb_certified": false,
          "views": 107,
          "original_names": {
            "mark": "기아",
            "model": "모하비",
            "generation": "모하비 더마스터",
            "configuration": "3.0 디젤 4WD",
            "complectation": "마스터즈 그래비티"
          }
        }
      }
    }
    // ... shpalljet e tjera, deri në 20 për faqe
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Fushat e rekordit

  • id - numri i rekordit te ne; fusha inner_id është ajo që e lidh rekordin me shpalljen në KB Chachacha
  • inner_id - numri i shpalljes në KB Chachacha, parametri carSeq në lidhjen e shpalljes: 28740959
  • url - lidhja e shpalljes në kbchachacha.com
  • mark, model - marka dhe modeli në anglisht: Kia, Mohave
  • generation - gjenerata, p.sh. Mohave The Master
  • configuration - versioni me motor dhe tërheqje: 3.0 Diesel 4WD
  • complectation - varianti: Masters Gravity; mund të jetë bosh
  • year - viti i modelit, ose viti i regjistrimit të parë kur KB Chachacha nuk e jep vitin e modelit; muaji i regjistrimit vjen në registration_month
  • color - ngjyra e karrocerisë nga lista e /filters; bosh nëse KB Chachacha nuk e tregon ngjyrën
  • body_type - klasa e automjetit, siç e përcakton KB Chachacha: "Small car", "Mid-size car", "Full-size car", "SUV", "Minivan", "Truck"; të gjitha vlerat janë në /filters
  • engine_type - lloji i karburantit, vlera nga /filters
  • displacement - vëllimi i motorit, cc; bosh për makinat elektrike
  • transmission_type - transmisioni: "Automatic", "Manual", "CVT" ose "Other"
  • drive_type - 2WD, 4WD ose AWD kur tërheqja është dhënë në emrin e versionit; përndryshe bosh
  • price - çmimi në won koreanë; -1 kur nuk ka çmim: çmim sipas kërkesës ose marrje përsipër e lizingut
  • km_age - kilometrazhi, km
  • no_accidents - true vetëm kur nuk ka asnjë rast sigurimi, përfshirë rastet për dëmtime të makinave të tjera
  • equipment - lista e opsioneve si varg JSON brenda një string-u; string bosh kur nuk janë shënuar opsione
  • description - teksti i shitësit, në koreanisht
  • seller - emri i autosallonit nga shpallja
  • seller_type - kush e ka publikuar shpalljen: "Dealer", "Dealership manager", "Dealership owner" ose "Private seller"
  • is_dealer - false për shitësit privatë, true për të gjithë të tjerët
  • salon_id - ID-ja e autosallonit në KB Chachacha
  • phone - numri i telefonit nga shpallja
  • region - rajoni i Koresë, vlera nga /filters
  • address - adresa e autosallonit në koreanisht
  • latitude, longitude - koordinatat e autosallonit, kur KB Chachacha i jep
  • images - lidhjet e fotove si varg JSON brenda një string-u; string bosh për shpalljet pa foto
  • offer_created - data kur shpallja u publikua për herë të parë
  • extra_prep - të dhëna shtesë të shpalljes, që përshkruhen më poshtë; vlerat që mungojnë vijnë si null

Brenda extra_prep

  • registration_month - muaji i regjistrimit të parë: 2022-07
  • car_number - numri i targës koreane
  • seats - numri i vendeve
  • seat_color - ngjyra e ulëseve
  • is_price_on_request - true kur shitësi nuk ka dhënë çmim dhe u kërkon blerësve ta kontaktojnë për çmimin
  • is_lease_takeover - true te shpalljet për marrje përsipër të lizingut
  • lease_monthly_payment - kësti mujor i lizingut në won; plotësohet vetëm për marrjet përsipër të lizingut
  • market_price_min, market_price_avg, market_price_max - vlerësimi i çmimit të tregut nga KB Chachacha, në won: kufiri i poshtëm, mesatarja, kufiri i sipërm
  • views - numri i shikimeve të shpalljes
  • original_names - marka, modeli, gjenerata, versioni dhe varianti në koreanisht, siç shfaqen në KB Chachacha
  • insurance_accidents - numri i rasteve të sigurimit për dëmtime të kësaj makine
  • insurance_accidents_total - numri total i rasteve të sigurimit, përfshirë ato për dëmtime të makinave të tjera
  • total_loss, flood - nëse makina ka dëm total në historik, nëse ka dëmtim nga përmbytja në historik
  • owner_changes - numri i ndërrimeve të pronësisë
  • seizure, mortgage - nëse makina është nën sekuestrim, nëse ka peng
  • rental_history - true kur makina është përdorur si makinë me qira ose me lizing
  • kb_diagnosis - true kur makina ka kaluar inspektimin e KB
  • kb_warranty - true kur makina mbulohet nga garancia e KB
  • manufacturer_certified, partner_certified, kb_certified - tre tregues: certifikim nga prodhuesi, nga një partner i KB Chachacha, nga vetë KB

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/kbchachacha/change_id?api_key=YOUR_API_KEY&date=2026-09-29

Përgjigjja:

{ "change_id": 34419 }

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/kbchachacha/changes?api_key=YOUR_API_KEY&change_id=34419

Përgjigjja:

{
  "result": [
    {
      "id": 34419,
      "inner_id": "26487093",
      "change_type": "added",    // added: shpallje e re
      "created_at": "2026-09-29T03:46:49.147+03:00",
      "data": { ... }            // të gjitha fushat e shpalljes, si në /offers
    },
    {
      "id": 34420,
      "inner_id": "26502575",
      "change_type": "changed",  // changed: çmimi i ri, në won
      "created_at": "2026-09-29T03:46:49.388+03:00",
      "data": { "new_price": 23000000 }
    },
    {
      "id": 34421,
      "inner_id": "28797429",
      "change_type": "removed",  // removed: shpallja u hoq nga shitja
      "created_at": "2026-09-29T08:48:00.262+03:00",
      "data": {}
    }
  ],
  "meta": { "cur_change_id": 34419, "next_change_id": 34422, "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/kbchachacha/offer?api_key=YOUR_API_KEY&inner_id=28740959

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

Ruajtja

Skedarët mbeten të disponueshëm të paktën 3 ditë

Disponueshmëria

Skedarë të rinj çdo mëngjes

Formati CSV

Kolonat në CSV ndahen me vijën vertikale (|)

Struktura e URL-së:

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

Parametrat:

  • access_name - nëndomeni juaj personal
  • date - data e eksportimit në formatin yyyy-mm-dd, p.sh. 2026-10-07
  • file_name - emri i skedarit me prapashtesë

Skedarët e disponueshëm:

  • 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 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

Shembull komande me Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
KB Chachacha

KB Chachacha (kbchachacha.com) i përket kompanisë financiare KB Capital, pjesë e KB Financial Group. Bashkë me Encar, është një nga dy portalet më të mëdha të shpalljeve për makina të përdorura në Kore. Shumicën e shpalljeve i publikojnë tregtarë të komplekseve të makinave të përdorura në mbarë vendin, nga Seuli deri në Jeju. Ndër makinat në shitje ka marka koreane dhe makina të importuara si Mercedes-Benz, BMW dhe Audi.

KB Chachacha bën vlerësimin e vet për çmimin e tregut të një makine dhe e tregon intervalin pranë çmimit të shitësit. Shpallja tregon numrin e rasteve të sigurimit dhe të ndërrimeve të pronësisë, si dhe tregues për dëm total, përmbytje, sekuestrim dhe peng. Disa makina kanë kaluar inspektimin e KB ose shiten me garanci të KB, dhe disa kanë certifikim nga prodhuesi. Ka edhe shpallje për marrje përsipër të lizingut, ku në vend të çmimit jepet një këst mujor.

Për një importues, shpallja ka gjithçka që duhet për të kontaktuar shitësin: emrin e autosallonit, adresën e tij me koordinata dhe një numër telefoni. Marrjet përsipër të lizingut dhe shpalljet me çmim sipas kërkesës kanë tregues të veçantë, kështu që është e lehtë t'i lini jashtë një krahasimi çmimesh. Metodat e API-së janë të njëjtat si për Encar dhe K Car, kështu që të tria burimet koreane mund të trajtohen në një sistem të vetëm.

Emrat e markave, të modeleve dhe të varianteve vijnë në anglisht; origjinalet koreane ruhen në original_names.

Përgjigje brenda 2 min