
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.
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.
Shpalljet e reja në KB Chachacha, ndryshimet e çmimeve dhe heqjet nga shitja vijnë si ngjarje përmes /changes.
Një skedar ditor me shpalljet e KB Chachacha që janë aktive atë mëngjes.
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.
URL bazë
https://{access_name}.auto-api.com/api/v2/kbchachachaAutorizimi: api_key parametër
Rrjedha e punës
/filtersmarkat, modelet dhe vlerat që i pranojnë filtratNgarkimi fillestar i shpalljeve:
/change_id?date=...merrni ID-në e ndryshimit për ngjarjen e parë të ditës/offersshkarkoni shpalljet faqe pas faqeje/changes?change_id=...shpallje të reja, ndryshime çmimesh, heqje nga shitja/offernjë shpallje sipas inner_idNga 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_KEYPë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 faqesmark, model- marka dhe modeli, siç shkruhen në /filterstransmission_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ë voglayear_from, year_to- intervali për fushën yearkm_age_from, km_age_to- intervali i kilometrazhit, kmprice_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=DieselPë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-29Pë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=34419Pë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=28740959Pë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ë:
Parametrat:
access_name- nëndomeni juaj personaldate- data e eksportimit në formatin yyyy-mm-dd, p.sh. 2026-10-07file_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.csvShembull komande me Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'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.
Zgjeroni mbulimin e të dhënave tuaja automobilistike në tregjet botërore me API-të tona të platformave: