K Car APIScraper a parser
K Car API: vozy z kcar.com s VIN, pevnou cenou ve wonech, údaji o opravách karoserie, pojistnou historií a fotkami. Feed změn a denní soubory.
K Car API
K Car API vám pomůže prozkoumat vůz dřív, než se obrátíte na pobočku. V záznamu můžete porovnat výsledek prohlídky karoserie s pojistnou historií a záznamy nájezdu, prohlédnout si fotografie a aktuální cenu a podle VIN vůz ověřit v dalších zdrojích. Sběr dat z kcar.com zajišťujeme my: vlastní parser ani scraper nepotřebujete.
Ve feedu změn je vidět, kdy se vůz K Car objevil v prodeji, kdy se změnila jeho cena a kdy byl z prodeje stažen.
Denní export K Car obsahuje všechny vozy, které zůstávají v prodeji.
VIN, modelový rok a měsíc první registrace, nájezd s historií, výkon, palivo, převodovka a pohon, výsledek prohlídky a seznam vyměněných a opravených dílů karoserie, pojistná historie, výbava, pobočka se souřadnicemi, fotky.
Základní URL
https://{access_name}.auto-api.com/api/v2/kcarAutorizace: api_key parametr
Pracovní postup
/filtersznačky, modely a hodnoty filtrůPrvní načtení nabídky:
/change_id?date=...uložit ID změny, od kterého se bude feed číst/offersstáhnout vozy v prodeji, všechny nebo podle filtrů/changes?change_id=...nově zařazené vozy, nové ceny a stažení z prodeje od tohoto ID změny/offerjeden vůz podle inner_idKde začít:
1. Výchozí pozici ve feedu si uložte ještě před načtením vozů: zavolejte /change_id s aktuálním datem podle soulského času. Pokud přijde 0, žádné události za tento den ještě nebyly: zopakujte volání později se stejným datem.
2. Nabídku stáhněte přes /offers a přecházejte na stránku z next_page, dokud nebude null. Potom zpracujte /changes od uložené pozice: během načítání mohla část vozů zlevnit, zdražit nebo být stažena z prodeje.
3. Dál si po každé dávce událostí ukládejte next_change_id a /changes volejte už s ním. Když je null, pozici neměňte a zkuste to později. Vozy pro konkrétní zakázku vybírejte přes /offers s filtry.
GET/filters
Vrací všechny možné hodnoty pro filtrování
https://{access_name}.auto-api.com/api/v2/kcar/filters?api_key=YOUR_API_KEYOdpověď:
{
"mark": {
"Hyundai": {
"model": ["Accent", "Avante", "Casper", "Genesis", "Grandeur", "Ioniq", "Kona", "Nexo", "Palisade", "Porter", "Santa Fe", "Sonata", "Starex", "Staria", "Tucson", "Venue", "i40"]
},
"Kia": {
"model": ["Bongo III Truck", "Carnival", "EV3", "EV6", "K3", "K5", "K7", "K8", "K9", "Mohave", "Morning", "Niro", "Pride", "Ray", "Seltos", "Sorento", "Sportage"]
},
"Genesis": {
"model": ["EQ900", "G70", "G80", "G90", "GV70", "GV80"]
}
// ... ostatní značky
},
"transmission_type": ["Automatic", "Manual"],
"color": ["Black", "Blue", "Gray", "Pearl", "Red", "Silver", "Silver Gray", "White", "Yellow"],
"body_type": ["Bus", "Hatchback", "Minivan", "Pickup", "SUV", "Sedan", "Truck (Double Cab)", "Truck (Regular Cab)", "Truck (Super Cab)", "Van", "Wagon"],
"engine_type": ["Diesel", "Electric", "Gasoline", "Hybrid (Gasoline)", "Hydrogen", "LPG"],
"drive_type": ["AWD", "FWD", "RWD"],
"region": ["Chungbuk", "Chungnam", "Gangwon", "Gyeongbuk", "Gyeonggi/Incheon", "Gyeongnam", "Home Service Mega Center", "Jeonbuk", "Jeonnam", "Seoul"]
}GET/offers
Seznam inzerátů s stránkováním a filtry
Parametry:
page(povinné) - číslo stránkymark, model- značka a model zapsané jako v /filterstransmission_type, color, body_type, engine_type, drive_type, region- převodovka, barva, typ karoserie, palivo, pohon a region: hodnoty z /filters, na velikosti písmen nezáležíyear_from, year_to- rozsah podle pole yearkm_age_from, km_age_to- rozsah nájezdu v kmprice_from, price_to- rozsah ceny v korejských wonech
https://{access_name}.auto-api.com/api/v2/kcar/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/kcar/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&model=Palisade&year_from=2022&km_age_to=60000&price_to=30000000&engine_type=GasolineOdpověď:
{
"result": [
{
"id": 142,
"inner_id": "EC61380785",
"change_type": "added",
"created_at": "2026-09-29T02:49:46.872+03:00",
"data": {
"id": "142",
"inner_id": "EC61380785",
"url": "https://www.kcar.com/bc/detail/carInfoDtl?i_sCarCd=EC61380785",
"mark": "Hyundai",
"model": "Palisade",
"generation": "The New Palisade",
"body_configuration": "",
"configuration": "Gasoline 3.8 2WD",
"complectation": "Exclusive",
"title": "Hyundai The New Palisade Gasoline 3.8 2WD Exclusive",
"year": "2023",
"price": "27900000",
"km_age": "25339",
"color": "White",
"engine_type": "Gasoline",
"body_type": "SUV",
"transmission_type": "Automatic",
"drive_type": "FWD",
"displacement": "3778",
"doors_count": "5",
"horse_power": "295",
"vin": "KMHR281EBPU592982",
"no_accidents": false,
"equipment": "[\"ABS\", \"Navigation\", \"Leather seats\", \"Alloy wheels\", \"Airbag: side\", \"Power seat: driver\"]", // v úplné odpovědi 39 položek výbavy
"region": "Gyeonggi/Incheon",
"seller": "K Car Gimpo",
"salon_id": "087",
"address": "경기도김포시김포대로1523-1 (장기동) 2동",
"latitude": "37.658929",
"longitude": "126.665366",
"description": "● 차량 연식 대비 주행거리 매우 짧은 차량이며, 컨디션 역시 매우 우수한 차량입니다.<br/>● 신차가 대비 합리적으로 구매 가능한 가성비 추천 차량입니다. ...",
"offer_created": "2026-06-27",
"images": "[\"https://img.kcar.com/3dcarpicture/2026/08/087/61380785_2/main/main780.jpg\", \"https://img.kcar.com/3dcarpicture/2026/08/087/61380785_2/extra/extra_0_hq.jpg\"]", // v úplné odpovědi 40 fotek
"extra_prep": {
"first_registration": "2023-03",
"model_year": 2023,
"price_base": 28400000,
"is_discount": true,
"is_time_deal": false,
"is_reserved": false,
"car_class": "SUV",
"seats": 7,
"accident_history": "Minor repair",
"body_damage": {
"frame": {},
"exterior": { "bonnet": "repaired", "front-fender-right": "repaired", "front-door-right": "repaired", "back-door-right": "repaired" }
},
"insurance_history": {
"checked_at": "2026-08-10",
"accidents_count": 3,
"own_damage_count": 2,
"own_damage_amount": 771970,
"other_damage_count": 1,
"other_damage_amount": 1422584,
"total_loss_count": 0,
"flood_count": 0,
"theft_count": 0,
"owner_changes_count": 3,
"plate_changes_count": 0,
"rental_history": false,
"business_use_history": false,
"government_use_history": false,
"uninsured_periods": "2023-03~2024-05"
},
"mileage_history": [
{ "date": "2025-05-29", "km": 16667, "source": "Insurance company" },
{ "date": "2025-04-30", "km": 15993, "source": "K Car" }
],
"badges": ["Low mileage", "Manufacturer warranty", "Driver assistance"],
"inspection_date": "2026-08-10",
"views_count": 6054,
"favorites_count": 53
}
}
}
// ... ostatní vozy, až 20 na stránce
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Pole záznamu
- id - naše interní číslo záznamu; inzerát na K Car se identifikuje podle inner_id
- inner_id - kód inzerátu na K Car, stejný jako v odkazu: EC61380785
- url - odkaz na inzerát na kcar.com
- title - úplný název vozu na jednom řádku
- mark, model - značka a model v latince, například Hyundai a Palisade
- generation - generace modelu: The New Palisade, Grandeur (GN7)
- body_configuration - tovární kód karoserie, pokud ho K Car uvádí v závorce v názvu generace: GN7, RG3; jinak prázdné
- configuration - verze: motor a pohon, například Gasoline 3.8 2WD
- complectation - výbavová verze: Exclusive, Calligraphy; může být prázdná
- year - modelový rok; pokud není uveden nebo ještě nenastal, rok první registrace
- vin - kompletní VIN, 17 znaků
- color - barva karoserie, hodnoty z /filters
- body_type - typ karoserie, hodnoty z /filters
- doors_count - počet dveří; u části vozů prázdné
- engine_type - typ paliva, hodnoty z /filters
- displacement - objem motoru v cm³; u elektromobilů a vodíkových vozů prázdné
- horse_power - výkon v koních
- transmission_type - převodovka, hodnoty z /filters
- drive_type - pohon: FWD, RWD nebo AWD
- price - aktuální cena v korejských wonech; týdenní sleva je už započtena
- km_age - nájezd v kilometrech
- no_accidents - true, když podle prohlídky K Car nebyly nosné části karoserie ani vnější panely měněny ani opravovány; pojistné události přitom vůz mít může, jsou v insurance_history
- equipment - výbava: pole JSON s názvy položek výbavy zapsané jako řetězec
- description - popis vozu od K Car v korejštině
- seller - pobočka K Car, kde vůz stojí: K Car Gimpo
- salon_id - kód pobočky
- region - region pobočky, hodnoty z /filters
- address - adresa pobočky v korejštině
- latitude, longitude - souřadnice pobočky
- images - odkazy na fotografie: pole JSON zapsané jako řetězec; obvykle několik desítek snímků
- offer_created - datum zveřejnění inzerátu podle korejského času
- extra_prep - objekt s dalšími daty, pole jsou popsána níže; chybějící hodnoty přicházejí jako null
Uvnitř extra_prep
- first_registration - měsíc první registrace: 2023-03
- model_year - modelový rok jako číslo
- price_base - cena bez týdenní slevy ve wonech; když sleva není, shoduje se s price
- is_discount - true, když se na vůz vztahuje týdenní sleva
- is_time_deal - true u vozů v časově omezené akci
- is_reserved - true, když si vůz zarezervoval kupující
- car_class - třída vozu podle klasifikace K Car: "Light car", "Compact", "Mid-size", "SUV" a další
- seats - počet míst
- badges - štítky inzerátu, například "One owner", "Low mileage", "Manufacturer warranty"
- views_count, favorites_count - kolikrát byl inzerát zobrazen a přidán do oblíbených
- inspection_date - datum prohlídky K Car
- accident_history - hodnocení K Car: "No accident", "Minor repair" nebo "Accident"; které díly byly vyměněny nebo opraveny, ukazuje body_damage
- body_damage - vyměněné a opravené díly karoserie: ve frame nosné části karoserie, v exterior vnější panely; hodnota replaced znamená výměnu, repaired opravu; prázdné objekty znamenají, že nejsou žádné nálezy, a null přichází, když data z prohlídky karoserie chybějí
- insurance_history - pojistná historie: datum výpisu (checked_at), celkový počet pojistných událostí (accidents_count), události a plnění za škody na tomto voze (own_damage_count, own_damage_amount), události a výše škod způsobených jiným vozidlům (other_damage_count, other_damage_amount), částky ve wonech; počty totálních škod, zatopení, krádeží, změn majitele a změn registrační značky; příznaky využití v autopůjčovně, ke komerčním účelům a ve státní správě; období bez pojištění
- mileage_history - nájezd podle data: datum, kilometry a zdroj záznamu
GET/change_id
Získat první ID změny podle data (pro použití v /changes)
Parametry:
date(povinné) - datum ve formátu yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/kcar/change_id?api_key=YOUR_API_KEY&date=2026-09-29Odpověď:
{ "change_id": 283 }Použijte vrácenou hodnotu jako parametr change_id v /changes
GET/changes
Stream změn (přidáno/změněno/odstraněno)
Parametry:
change_id(povinné) - od kterého ID změny
https://{access_name}.auto-api.com/api/v2/kcar/changes?api_key=YOUR_API_KEY&change_id=283Odpověď:
{
"result": [
{
"id": 283,
"inner_id": "EC61410729",
"change_type": "added", // added: vůz se objevil v prodeji
"created_at": "2026-09-29T02:58:42.752+03:00",
"data": { ... } // úplný záznam, jako v /offers
},
{
"id": 284,
"inner_id": "EC61414869",
"change_type": "changed", // changed: nová cena ve wonech
"created_at": "2026-09-29T03:16:53.512+03:00",
"data": { "new_price": 10200000 }
},
{
"id": 285,
"inner_id": "EC60843517",
"change_type": "removed", // removed: vůz byl stažen z prodeje
"created_at": "2026-09-29T03:16:54.711+03:00",
"data": {}
}
],
"meta": { "cur_change_id": 283, "next_change_id": 286, "limit": 20 }
}GET/offer
Jednotlivý inzerát podle inner_id
Parametry:
inner_id(povinné)
https://{access_name}.auto-api.com/api/v2/kcar/offer?api_key=YOUR_API_KEY&inner_id=EC61380785Odpověď: objekt data (stejný jako v /offers, ale bez wrapperu result)
Uchování
Soubory zůstávají dostupné nejméně 3 dny
Dostupnost
Nové soubory každé ráno
Formát CSV
Sloupce CSV jsou odděleny znakem svislítko (|)
Struktura URL:
Parametry:
access_name- vaše osobní subdoménadate- datum exportu ve formátu rrrr-mm-dd, např. 2026-10-06file_name- název souboru s příponou
Dostupné soubory:
- 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
Příklad požadavku 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.csvPříklad příkazu Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'K Car (kcar.com) prodává ojeté vozy z vlastního skladu a zůstává největším prodejcem tohoto typu v Jižní Koreji. Společnost vyrostla z divize přímého prodeje SK Encar a od roku 2018 působí pod značkou K Car. Vozy vykupuje od majitelů, kontroluje je a prodává prostřednictvím sítě poboček po celé zemi, a to i s dodáním až domů.
Ceny u K Car jsou pevné, nesmlouvá se, na část vozů se vztahují týdenní slevy. Před prodejem vůz prochází prohlídkou a v inzerátu je uvedeno, do které skupiny byl zařazen: bez nehody, drobná oprava nebo nehoda. Tamtéž jsou vypsány vyměněné a opravené díly karoserie, pojistné události s výší plnění a datované záznamy nájezdu. VIN je zveřejněn celý.
Výsledek prohlídky K Car se vyplatí číst spolu s pojistnou historií: vůz ze skupiny "bez nehody" může mít vyplacená pojistná plnění, protože skupina popisuje jen nosné části karoserie a vnější panely. Pro výpočet cla a dovozních poplatků je v záznamu měsíc první registrace, objem a výkon motoru. Pokud si vůz už zarezervoval kupující, ukáže to příznak is_reserved.
Feed /changes hlásí nové inzeráty, změny ceny a stažení z prodeje. Rezervaci a ostatní data vozu v aktuální podobě vrací /offer.
Automobilová data z různých světových trhů s našimi platformovými API: