AUTO-API.COM
Logotipo de KB Chachacha

KB Chachacha APIScraper y parser

KB Chachacha API: anuncios de concesionarios coreanos con precio en wones, estimación del precio de mercado, siniestros, prenda y embargo, equipamiento y fotos.

Bibliotecas SDK oficiales

Nuestros SDK incluyen los métodos de la API como funciones listas para usar. Las bibliotecas son de código abierto y están en GitHub.

KB Chachacha API

En la KB Chachacha API, junto al precio del vendedor llega la estimación del precio de mercado de la propia KB Chachacha: límite inferior, media y límite superior. Con esos valores es fácil comparar ofertas de un mismo modelo, y con los siniestros del seguro y los indicadores de prenda y embargo, seleccionar los anuncios para una revisión posterior. No necesitará un parser ni un scraper propios para kbchachacha.com: los nombres ya están traducidos al inglés, el equipamiento viene en forma de lista y los datos de contacto del concesionario y las fotos van en la respuesta.

API

Los anuncios nuevos de KB Chachacha, los cambios de precio y las retiradas de la venta llegan como eventos a través de /changes.

Exportaciones diarias

Un archivo diario con los anuncios de KB Chachacha activos en la mañana de ese día.

Datos completos

Marca, modelo, generación y acabado, año del modelo y mes de matriculación, kilometraje, combustible, caja de cambios, clase del vehículo, precio del vendedor y estimación del precio de mercado de KB Chachacha, siniestros del seguro, cambios de propietario, prenda y embargo, equipamiento, vendedor con dirección y teléfono, y fotos.

Obtener acceso a la APIAcceso proporcionado en 2 minutos

URL base

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

Autorización: api_key parámetro

Flujo de trabajo

1
/filtersqué se puede pasar a los filtros: marcas, modelos y valores
2

Carga inicial de anuncios:

/change_id?date=...obtener el ID de cambio del primer evento del día
/offersdescargar los anuncios página a página
3
/changes?change_id=...anuncios nuevos, cambios de precio, retiradas de la venta
4
/offerun anuncio por su inner_id

Por dónde empezar:

1. Para empezar, pruebe la selección que necesita con /offers: indique la marca, el modelo y los límites de precio o de kilometraje. Tome de /filters la grafía de las marcas y los valores de los demás filtros.

2. Para mantener en su sistema toda la base de anuncios, hace falta la posición inicial del feed. Obténgala con el método /change_id para la fecha actual en hora de Corea; si la respuesta es 0, repita la petición más tarde. Una vez guardado el ID de cambio, cargue las páginas de /offers una tras otra: la última es aquella en la que next_page es null.

3. Tras la carga, aplique los eventos de /changes a partir del ID de cambio guardado. Pida el siguiente lote con el next_change_id de la respuesta. Cuando no hay eventos, result llega como un array vacío y next_change_id es null: en la siguiente consulta pase el mismo change_id de antes.

GET/filters

Devuelve todos los valores posibles para filtrado

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

Respuesta:

{
  "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"]
    }
    // ... y otras marcas
  },
  "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 de listados con paginación y filtros

Parámetros:

  • page (requerido) - número de página
  • mark, model - marca y modelo tal como se escriben en /filters
  • transmission_type, color, body_type, engine_type, drive_type, region - caja, color, clase del vehículo, combustible, tracción y región tal como los devuelve /filters; no se distinguen mayúsculas de minúsculas
  • year_from, year_to - límites para el campo year
  • km_age_from, km_age_to - rango de kilometraje, en km
  • price_from, price_to - rango de precio, en wones
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

Respuesta:

{
  "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\"]",  // este coche tiene 53 opciones en total
        "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\"]",  // 31 fotos en total
        "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": "마스터즈 그래비티"
          }
        }
      }
    }
    // ... los anuncios siguientes, hasta 20 por página en total
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Campos del registro

  • id - número del registro en nuestro sistema; inner_id lo vincula con el anuncio de KB Chachacha
  • inner_id - número del anuncio en KB Chachacha; en el enlace es el parámetro carSeq: 28740959
  • url - enlace al anuncio en kbchachacha.com
  • mark, model - marca y modelo en inglés: Kia, Mohave
  • generation - generación, por ejemplo Mohave The Master
  • configuration - versión con motor y tracción: 3.0 Diesel 4WD
  • complectation - acabado: Masters Gravity; no todos los anuncios lo indican
  • year - año del modelo o, si KB Chachacha no lo indica, año de primera matriculación; el mes de matriculación llega en registration_month
  • color - color de la carrocería, de la lista de /filters; vacío si KB Chachacha no indica el color
  • body_type - clase del vehículo tal como la define KB Chachacha: "Small car", "Mid-size car", "Full-size car", "SUV", "Minivan", "Truck"; todos los valores están en /filters
  • engine_type - tipo de combustible, valores de /filters
  • displacement - cilindrada del motor, en cm³; vacío en los eléctricos
  • transmission_type - caja de cambios: "Automatic", "Manual", "CVT" u "Other"
  • drive_type - 2WD, 4WD o AWD cuando la tracción figura en el nombre de la versión; si no, vacío
  • price - precio en wones coreanos; -1 si no hay precio: precio a consultar o cesión de leasing
  • km_age - kilometraje, en km
  • no_accidents - true solo si no hay ningún siniestro del seguro, incluidos los de daños a otros vehículos
  • equipment - lista de opciones: array JSON dentro de una cadena; si no se indican opciones, llega una cadena vacía
  • description - texto del vendedor, en coreano
  • seller - nombre del concesionario que figura en el anuncio
  • seller_type - quién publicó el anuncio: "Dealer", "Dealership manager", "Dealership owner" o "Private seller"
  • is_dealer - false en los vendedores particulares, true en los demás
  • salon_id - número del concesionario en KB Chachacha
  • phone - teléfono que figura en el anuncio
  • region - región de Corea, valores de /filters
  • address - dirección del concesionario, en coreano
  • latitude, longitude - coordenadas del concesionario, si KB Chachacha las indica
  • images - enlaces de las fotos: array JSON dentro de una cadena; en los anuncios sin fotos llega una cadena vacía
  • offer_created - fecha de la primera publicación del anuncio
  • extra_prep - datos adicionales del anuncio, su contenido se detalla más abajo; si falta un valor, llega null

Dentro de extra_prep

  • registration_month - mes de primera matriculación: 2022-07
  • car_number - matrícula coreana
  • seats - número de plazas
  • seat_color - color de los asientos
  • is_price_on_request - true si el vendedor no ha indicado el precio y pide que se le consulte
  • is_lease_takeover - true en los anuncios de cesión de leasing
  • lease_monthly_payment - cuota mensual del leasing, en wones; solo se rellena en las cesiones
  • market_price_min, market_price_avg, market_price_max - estimación del precio de mercado de KB Chachacha, en wones: límite inferior, media, límite superior
  • views - número de visualizaciones del anuncio
  • original_names - marca, modelo, generación, versión y acabado en coreano, como en KB Chachacha
  • insurance_accidents - número de siniestros del seguro con daños en este coche
  • insurance_accidents_total - número total de siniestros del seguro, incluidos aquellos con daños causados a otros vehículos
  • total_loss, flood - si hubo siniestro total, si hubo inundación
  • owner_changes - cuántas veces ha cambiado de propietario
  • seizure, mortgage - si el coche está embargado, si está sujeto a prenda
  • rental_history - true si el coche ha sido de alquiler o de leasing
  • kb_diagnosis - true si el coche ha pasado la inspección KB
  • kb_warranty - true si el coche está cubierto por la garantía KB
  • manufacturer_certified, partner_certified, kb_certified - tres indicadores: certificación del fabricante, de un socio de KB Chachacha, de la propia KB

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

Respuesta:

{ "change_id": 34419 }

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

Respuesta:

{
  "result": [
    {
      "id": 34419,
      "inner_id": "26487093",
      "change_type": "added",    // added: anuncio nuevo
      "created_at": "2026-09-29T03:46:49.147+03:00",
      "data": { ... }            // todos los campos del anuncio, como en /offers
    },
    {
      "id": 34420,
      "inner_id": "26502575",
      "change_type": "changed",  // changed: el precio ha cambiado, valor en wones
      "created_at": "2026-09-29T03:46:49.388+03:00",
      "data": { "new_price": 23000000 }
    },
    {
      "id": 34421,
      "inner_id": "28797429",
      "change_type": "removed",  // removed: anuncio retirado
      "created_at": "2026-09-29T08:48:00.262+03:00",
      "data": {}
    }
  ],
  "meta": { "cur_change_id": 34419, "next_change_id": 34422, "limit": 20 }
}

GET/offer

Listado individual por inner_id

Parámetros:

  • inner_id (requerido)
https://{access_name}.auto-api.com/api/v2/kbchachacha/offer?api_key=YOUR_API_KEY&inner_id=28740959

Respuesta: 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:

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

Parámetros:

  • access_name - su subdominio personal
  • date - fecha de la exportación en formato aaaa-mm-dd, p. ej. 2026-10-07
  • file_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.csv

Ejemplo de comando 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) pertenece a KB Capital, una entidad financiera del grupo KB Financial. KB Chachacha y Encar son las dos mayores plataformas de anuncios de coches usados de Corea. Los anuncios los publican sobre todo concesionarios de los complejos de venta de coches usados de todo el país, de Seúl a Jeju. Se venden tanto marcas coreanas como coches de importación: Mercedes-Benz, BMW, Audi.

KB Chachacha estima por su cuenta el precio de mercado del coche y muestra el rango junto al precio del vendedor. En el anuncio se ven el número de siniestros del seguro y de cambios de propietario, y los indicadores de siniestro total, inundación, embargo y prenda. Parte de los coches ha pasado la inspección KB o se vende con garantía KB, y algunos tienen certificación del fabricante. También hay anuncios de cesión de leasing, en los que en lugar del precio figura la cuota mensual.

Para un importador, el anuncio tiene todo lo necesario para llegar al vendedor: nombre del concesionario, dirección con coordenadas y teléfono. La cesión de leasing y el precio a consultar llevan indicadores propios, así que es fácil dejar esos anuncios fuera de la comparación de precios. Los métodos de la API son los mismos que los de Encar y K Car, y las tres fuentes coreanas se pueden gestionar en un mismo sistema.

Los nombres de marcas, modelos y acabados llegan en inglés, y los originales en coreano se conservan en original_names.

Respuesta en 2 min