K Car APIScraper y parser
K Car API: coches de kcar.com con VIN, precio fijo en wones, reparaciones de carrocería, historial del seguro y fotos. Feed de cambios y archivos diarios.
K Car API
La K Car API le ayuda a estudiar un coche antes de contactar con la sucursal. En el registro puede contrastar la inspección de la carrocería con el historial del seguro y las lecturas de kilometraje, ver las fotos y el precio actual y, con el VIN, cotejar el coche con otras fuentes. De recopilar los datos de kcar.com nos encargamos nosotros: no necesita un parser ni un scraper propios.
El feed de cambios muestra cuándo un coche de K Car sale a la venta, cuándo cambia su precio y cuándo se retira de la venta.
La exportación diaria de K Car reúne todos los coches que siguen a la venta.
VIN, año del modelo y mes de primera matriculación, kilometraje con su historial, potencia, combustible, caja de cambios y tracción, resultado de la inspección y lista de piezas de carrocería sustituidas y reparadas, historial del seguro, equipamiento, sucursal con coordenadas, y fotos.
URL base
https://{access_name}.auto-api.com/api/v2/kcarAutorización: api_key parámetro
Flujo de trabajo
/filtersmarcas, modelos y valores de los filtrosPrimera carga del stock:
/change_id?date=...guardar el ID de cambio desde el que leer el feed/offersdescargar los coches en venta, todos o con filtros/changes?change_id=...incorporaciones al stock, precios nuevos y retiradas a partir de ese ID de cambio/offerun coche por inner_idPor dónde empezar:
1. Guarde la posición inicial del feed antes de cargar los coches: llame a /change_id con la fecha actual en hora de Seúl. Si devuelve 0, todavía no ha habido eventos ese día: repita la llamada más tarde con la misma fecha.
2. Descargue el stock con /offers, pasando a la página que indica next_page hasta que sea null. Después procese /changes desde la posición guardada: mientras duraba la carga, algunos coches pueden haber bajado o subido de precio o haberse retirado de la venta.
3. A partir de ahí, guarde next_change_id después de cada lote de eventos y pida /changes ya con ese valor. Cuando sea null, no cambie la posición y vuelva a consultar más tarde. Para elegir coches para un encargo concreto, use /offers con filtros.
GET/filters
Devuelve todos los valores posibles para filtrado
https://{access_name}.auto-api.com/api/v2/kcar/filters?api_key=YOUR_API_KEYRespuesta:
{
"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"]
}
// ... las demás marcas
},
"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
Lista de listados con paginación y filtros
Parámetros:
page(requerido) - número de páginamark, model- marca y modelo tal como se escriben en /filterstransmission_type, color, body_type, engine_type, drive_type, region- caja, color, tipo de carrocería, combustible, tracción y región: valores de /filters, sin distinguir mayúsculasyear_from, year_to- rango según el campo yearkm_age_from, km_age_to- rango de kilometraje, en kmprice_from, price_to- rango de precio, en wones coreanos
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=GasolineRespuesta:
{
"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\"]", // 39 opciones en la respuesta completa
"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\"]", // 40 fotos en la respuesta completa
"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
}
}
}
// ... los demás coches, hasta 20 por página
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Campos del registro
- id - nuestro número interno del registro; el anuncio en K Car se identifica por inner_id
- inner_id - código del anuncio en K Car, el mismo que aparece en el enlace: EC61380785
- url - enlace al anuncio en kcar.com
- title - nombre completo del coche en una sola línea
- mark, model - marca y modelo en alfabeto latino, por ejemplo Hyundai y Palisade
- generation - generación del modelo: The New Palisade, Grandeur (GN7)
- body_configuration - código de carrocería de fábrica, si K Car lo da entre paréntesis en el nombre de la generación: GN7, RG3; si no, vacío
- configuration - versión: motor y tracción, por ejemplo Gasoline 3.8 2WD
- complectation - acabado: Exclusive, Calligraphy; puede estar vacío
- year - año del modelo; si no se indica o es posterior al año en curso, año de primera matriculación
- vin - VIN completo, 17 caracteres
- color - color de la carrocería, valores de /filters
- body_type - tipo de carrocería, valores de /filters
- doors_count - número de puertas; vacío en algunos coches
- engine_type - tipo de combustible, valores de /filters
- displacement - cilindrada del motor, en cm³; vacío en los eléctricos y los coches de hidrógeno
- horse_power - potencia en CV
- transmission_type - caja de cambios, valores de /filters
- drive_type - tracción: FWD, RWD o AWD
- price - precio actual en wones coreanos; el descuento semanal ya está incluido
- km_age - kilometraje en kilómetros
- no_accidents - true si, según la inspección de K Car, la estructura y los paneles exteriores no tienen sustituciones ni reparaciones; aun así puede haber siniestros del seguro, que figuran en insurance_history
- equipment - equipamiento: array JSON con los nombres de las opciones, dentro de una cadena
- description - descripción del coche escrita por K Car, en coreano
- seller - sucursal de K Car donde está el coche: K Car Gimpo
- salon_id - código de la sucursal
- region - región de la sucursal, valores de /filters
- address - dirección de la sucursal, en coreano
- latitude, longitude - coordenadas de la sucursal
- images - enlaces de las fotos: array JSON dentro de una cadena; normalmente, varias decenas de imágenes
- offer_created - fecha de publicación del anuncio, en hora de Corea
- extra_prep - objeto con datos adicionales, sus campos se describen más abajo; los valores que faltan llegan como null
Dentro de extra_prep
- first_registration - mes de primera matriculación: 2023-03
- model_year - año del modelo, como número
- price_base - precio sin el descuento semanal, en wones; cuando no hay descuento, coincide con price
- is_discount - true si el coche tiene descuento semanal
- is_time_deal - true en los coches con oferta por tiempo limitado
- is_reserved - true si un comprador ha reservado el coche
- car_class - clase del vehículo según la clasificación de K Car: "Light car", "Compact", "Mid-size", "SUV" y otras
- seats - número de plazas
- badges - distintivos del anuncio, por ejemplo "One owner", "Low mileage", "Manufacturer warranty"
- views_count, favorites_count - cuántas veces se ha visto el anuncio y cuántas se ha añadido a favoritos
- inspection_date - fecha de la inspección de K Car
- accident_history - grupo asignado por K Car: "No accident", "Minor repair" o "Accident"; body_damage indica qué elementos se han sustituido o reparado
- body_damage - elementos de la carrocería sustituidos y reparados: en frame, los elementos de la estructura; en exterior, los paneles exteriores; el valor replaced significa sustitución y repaired, reparación; los objetos vacíos indican que no hay observaciones, y null llega cuando no hay datos de la inspección de la carrocería
- insurance_history - historial del seguro: fecha del informe (checked_at), número total de siniestros (accidents_count), siniestros e indemnizaciones por daños en este coche (own_damage_count, own_damage_amount), siniestros e importes de los daños a otros vehículos (other_damage_count, other_damage_amount), importes en wones; contadores de siniestro total, inundación, robo, cambios de propietario y cambios de matrícula; indicadores de uso como coche de alquiler, uso comercial y uso oficial; periodos sin seguro
- mileage_history - kilometraje por fechas: fecha, kilómetros y origen de la lectura
GET/change_id
Obtener primer ID de cambio por fecha (para usar en /changes)
Parámetros:
date(requerido) - fecha en formato yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/kcar/change_id?api_key=YOUR_API_KEY&date=2026-09-29Respuesta:
{ "change_id": 283 }Use el valor devuelto como parámetro change_id en /changes
GET/changes
Feed de cambios (añadido/cambiado/eliminado)
Parámetros:
change_id(requerido) - a partir de qué ID de cambio
https://{access_name}.auto-api.com/api/v2/kcar/changes?api_key=YOUR_API_KEY&change_id=283Respuesta:
{
"result": [
{
"id": 283,
"inner_id": "EC61410729",
"change_type": "added", // added: el coche ha salido a la venta
"created_at": "2026-09-29T02:58:42.752+03:00",
"data": { ... } // registro completo, como en /offers
},
{
"id": 284,
"inner_id": "EC61414869",
"change_type": "changed", // changed: precio nuevo en wones
"created_at": "2026-09-29T03:16:53.512+03:00",
"data": { "new_price": 10200000 }
},
{
"id": 285,
"inner_id": "EC60843517",
"change_type": "removed", // removed: el coche se ha retirado de la venta
"created_at": "2026-09-29T03:16:54.711+03:00",
"data": {}
}
],
"meta": { "cur_change_id": 283, "next_change_id": 286, "limit": 20 }
}GET/offer
Listado individual por inner_id
Parámetros:
inner_id(requerido)
https://{access_name}.auto-api.com/api/v2/kcar/offer?api_key=YOUR_API_KEY&inner_id=EC61380785Respuesta: objeto data (igual que en /offers, pero sin envoltorio result)
Retención
Los archivos siguen disponibles al menos 3 días
Disponibilidad
Archivos nuevos cada mañana
Formato CSV
Las columnas del CSV se separan con el carácter pipe (|)
Estructura de la URL:
Parámetros:
access_name- su subdominio personaldate- fecha de la exportación en formato aaaa-mm-dd, p. ej. 2026-10-06file_name- nombre del archivo con extensión
Archivos disponibles:
- 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
Ejemplo de petición 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.csvEjemplo de comando Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'K Car (kcar.com) vende coches usados de su propio stock y sigue siendo el mayor vendedor de este tipo de Corea del Sur. La empresa nació de la división de venta directa de SK Encar y opera con la marca K Car desde 2018. Compra los coches a sus propietarios, los revisa y los vende a través de una red de sucursales por todo el país, también con entrega a domicilio.
En K Car los precios son fijos, sin regateo, y algunos coches tienen descuento semanal. Antes de la venta el coche pasa una inspección, y el anuncio indica en qué grupo ha quedado: sin accidentes, reparación menor o accidentado. Allí mismo figuran los elementos de la carrocería sustituidos y reparados, los siniestros del seguro con los importes de las indemnizaciones y las lecturas de kilometraje por fechas. El VIN se muestra sin enmascarar.
Conviene leer la inspección de K Car junto con el historial del seguro: en un coche del grupo sin accidentes puede haber indemnizaciones del seguro, porque el grupo solo describe la estructura y los paneles exteriores. Para calcular los aranceles e impuestos de importación, el registro incluye el mes de primera matriculación, la cilindrada y la potencia del motor. Si un comprador ya ha reservado el coche, se ve en el indicador is_reserved.
El feed /changes avisa de los anuncios nuevos, de los cambios de precio y de las retiradas de la venta. La reserva y el resto de los datos del coche, en su estado actual, los devuelve /offer.
Expanda su cobertura de datos automotrices en mercados globales con nuestras APIs de plataforma: