AUTO-API.COM
Logótipo KB Chachacha

KB Chachacha APIScraper e parser

KB Chachacha API: anúncios de concessionários coreanos com preço em wons, estimativa do preço de mercado, sinistros, hipoteca e penhora, equipamento e fotos.

Bibliotecas SDK oficiais

Os nossos SDKs trazem os métodos da API como funções prontas a usar, e o código das bibliotecas é aberto e está no GitHub.

KB Chachacha API

Na KB Chachacha API, ao lado do preço do vendedor vem a estimativa do preço de mercado feita pelo próprio KB Chachacha: limite inferior, média e limite superior. Com estes valores é fácil comparar ofertas do mesmo modelo, e os sinistros e as indicações de hipoteca e de penhora servem para escolher os anúncios a verificar depois. Não vai precisar de um parser nem de um scraper próprio para kbchachacha.com: os nomes já estão traduzidos para inglês, o equipamento vem numa lista, e os contactos do stand e as fotos fazem parte da resposta.

API

Os novos anúncios do KB Chachacha, as alterações de preço e as retiradas de venda chegam como eventos através de /changes.

Exportações diárias

Um ficheiro diário com os anúncios do KB Chachacha ativos na manhã desse dia.

Dados completos

Marca, modelo, geração e nível de equipamento, ano-modelo e mês de matrícula, quilometragem, combustível, caixa, segmento, preço do vendedor e estimativa do preço de mercado do KB Chachacha, sinistros, mudanças de proprietário, hipoteca e penhora, equipamento, vendedor com morada e telefone, fotos.

Obter acesso à APIAcesso fornecido em 2 minutos

URL Base

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

Autorização: api_key parâmetro

Fluxo de Trabalho

1
/filterso que se pode passar nos filtros: marcas, modelos, valores
2

Carregamento inicial dos anúncios:

/change_id?date=...obter o ID de alteração do primeiro evento do dia
/offersdescarregar os anúncios página a página
3
/changes?change_id=...novos anúncios, alterações de preço, retiradas de venda
4
/offerum anúncio pelo seu inner_id

Por onde começar:

1. Comece por experimentar a seleção de que precisa através de /offers: indique a marca, o modelo e os limites de preço ou de quilometragem. Consulte em /filters a grafia das marcas e os valores dos restantes filtros.

2. Para manter do seu lado a base completa de anúncios, precisa da posição inicial do feed. Obtenha-a com o método /change_id para a data atual à hora da Coreia; se a resposta for 0, repita o pedido mais tarde. Depois de guardar o ID, carregue as páginas de /offers uma a seguir à outra: a última é aquela em que next_page é null.

3. Depois do carregamento, aplique os eventos de /changes a partir do ID guardado. Peça o lote seguinte com o next_change_id da resposta. Quando não há eventos, result vem como array vazio e next_change_id é null: na consulta seguinte, passe o mesmo change_id.

GET/filters

Retorna todos os valores possíveis para filtragem

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

Resposta:

{
  "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"]
    }
    // ... e outras 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 listagens com paginação e filtros

Parâmetros:

  • page (obrigatório) - número da página
  • mark, model - marca e modelo, escritos como em /filters
  • transmission_type, color, body_type, engine_type, drive_type, region - caixa, cor, segmento do carro, combustível, tração e região, tal como /filters os devolve; sem distinção de maiúsculas
  • year_from, year_to - limites para o campo year
  • km_age_from, km_age_to - intervalo de quilometragem, em km
  • price_from, price_to - intervalo de preço, em wons
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

Resposta:

{
  "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 carro tem 53 extras ao todo
        "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 ao todo
        "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": "마스터즈 그래비티"
          }
        }
      }
    }
    // ... os anúncios seguintes, até 20 por página ao todo
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Campos do registo

  • id - número do registo do nosso lado; a ligação ao anúncio no KB Chachacha faz-se por inner_id
  • inner_id - número do anúncio no KB Chachacha; no URL do anúncio é o parâmetro carSeq: 28740959
  • url - ligação para o anúncio em kbchachacha.com
  • mark, model - marca e modelo em inglês: Kia, Mohave
  • generation - geração, por exemplo Mohave The Master
  • configuration - versão com motor e tração: 3.0 Diesel 4WD
  • complectation - nível de equipamento: Masters Gravity; nem todos os anúncios o têm preenchido
  • year - ano-modelo ou, se o KB Chachacha não o indicar, ano da primeira matrícula; o mês de matrícula vem em registration_month
  • color - cor da carroçaria, da lista de /filters; vazio se o KB Chachacha não indicar a cor
  • body_type - segmento do veículo, tal como o KB Chachacha o define: "Small car", "Mid-size car", "Full-size car", "SUV", "Minivan", "Truck"; todos os valores estão em /filters
  • engine_type - tipo de combustível, valores de /filters
  • displacement - cilindrada do motor, em cm³; vazio nos elétricos
  • transmission_type - caixa: "Automatic", "Manual", "CVT" ou "Other"
  • drive_type - 2WD, 4WD ou AWD, quando a tração está indicada no nome da versão; caso contrário, vazio
  • price - preço em wons sul-coreanos; -1 se não houver preço: preço sob consulta ou cessão de leasing
  • km_age - quilometragem, em km
  • no_accidents - true apenas quando não há sinistro nenhum, incluindo os de danos causados a outros veículos
  • equipment - lista de extras: array JSON dentro de uma cadeia; se os extras não estiverem indicados, vem uma cadeia vazia
  • description - texto do vendedor, em coreano
  • seller - nome do stand indicado no anúncio
  • seller_type - quem publicou o anúncio: "Dealer", "Dealership manager", "Dealership owner" ou "Private seller"
  • is_dealer - false nos vendedores particulares, true nos restantes
  • salon_id - número do stand no KB Chachacha
  • phone - telefone indicado no anúncio
  • region - região da Coreia, valores de /filters
  • address - morada do stand, em coreano
  • latitude, longitude - coordenadas do stand, se o KB Chachacha as indicar
  • images - ligações das fotos: array JSON dentro de uma cadeia; nos anúncios sem fotos, vem uma cadeia vazia
  • offer_created - data da primeira publicação do anúncio
  • extra_prep - dados adicionais do anúncio, descritos abaixo; quando falta um valor, vem null

Dentro de extra_prep

  • registration_month - mês da primeira matrícula: 2022-07
  • car_number - matrícula coreana
  • seats - número de lugares
  • seat_color - cor dos bancos
  • is_price_on_request - true se o vendedor não indicou o preço e pede que o consultem para o saber
  • is_lease_takeover - true nos anúncios de cessão de leasing
  • lease_monthly_payment - renda mensal do leasing, em wons; preenchido apenas nas cessões de leasing
  • market_price_min, market_price_avg, market_price_max - estimativa do preço de mercado do KB Chachacha, em wons: limite inferior, média, limite superior
  • views - número de visualizações do anúncio
  • original_names - marca, modelo, geração, versão e nível de equipamento em coreano, tal como estão no KB Chachacha
  • insurance_accidents - número de sinistros com danos neste carro
  • insurance_accidents_total - número total de sinistros, incluindo aqueles em que os danos foram causados a outros veículos
  • total_loss, flood - se houve perda total, se houve inundação
  • owner_changes - quantas vezes o carro mudou de proprietário
  • seizure, mortgage - se o carro está penhorado, se tem hipoteca
  • rental_history - true se o carro foi usado em aluguer ou em leasing
  • kb_diagnosis - true se o carro passou pela inspeção KB
  • kb_warranty - true se o carro está coberto pela garantia KB
  • manufacturer_certified, partner_certified, kb_certified - três indicadores: certificação pelo fabricante, por um parceiro do KB Chachacha, pela própria KB

GET/change_id

Obter primeiro ID de alteração por data (para usar em /changes)

Parâmetros:

  • date (obrigatório) - data no formato yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/kbchachacha/change_id?api_key=YOUR_API_KEY&date=2026-09-29

Resposta:

{ "change_id": 34419 }

Use o valor retornado como parâmetro change_id em /changes

GET/changes

Feed de alterações (adicionado/alterado/removido)

Parâmetros:

  • change_id (obrigatório) - a partir de qual ID de alteração
https://{access_name}.auto-api.com/api/v2/kbchachacha/changes?api_key=YOUR_API_KEY&change_id=34419

Resposta:

{
  "result": [
    {
      "id": 34419,
      "inner_id": "26487093",
      "change_type": "added",    // added: novo anúncio
      "created_at": "2026-09-29T03:46:49.147+03:00",
      "data": { ... }            // todos os campos do anúncio, como em /offers
    },
    {
      "id": 34420,
      "inner_id": "26502575",
      "change_type": "changed",  // changed: o preço mudou, valor em wons
      "created_at": "2026-09-29T03:46:49.388+03:00",
      "data": { "new_price": 23000000 }
    },
    {
      "id": 34421,
      "inner_id": "28797429",
      "change_type": "removed",  // removed: o anúncio foi 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

Listagem única por inner_id

Parâmetros:

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

Resposta: objeto data (igual a /offers, mas sem o wrapper result)

Retenção

Os ficheiros ficam disponíveis pelo menos 3 dias

Disponibilidade

Ficheiros novos todas as manhãs

Formato CSV

As colunas do CSV são separadas pelo caráter pipe (|)

Estrutura do URL:

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

Parâmetros:

  • access_name - o seu subdomínio pessoal
  • date - data da exportação no formato aaaa-mm-dd, por ex. 2026-10-07
  • file_name - nome do ficheiro com extensão

Ficheiros disponíveis:

  • 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

Exemplo de pedido 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

Exemplo de comando Wget

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

O KB Chachacha (kbchachacha.com) pertence à KB Capital, empresa financeira do grupo KB Financial. Juntamente com o Encar, é uma das duas maiores plataformas de anúncios de carros usados da Coreia. Os anúncios são publicados sobretudo por concessionários instalados em complexos de venda de usados por todo o país, de Seul a Jeju. Vendem-se tanto marcas coreanas como importadas: Mercedes-Benz, BMW, Audi.

O KB Chachacha faz a sua própria estimativa do preço de mercado do carro e mostra o respetivo intervalo ao lado do preço do vendedor. No anúncio veem-se o número de sinistros e de mudanças de proprietário e as indicações de perda total, inundação, penhora e hipoteca. Alguns carros passaram pela inspeção KB ou são vendidos com garantia KB, e alguns têm certificação do fabricante. Há também anúncios de cessão de leasing, em que, em vez do preço, é indicada a renda mensal.

Para um importador, o anúncio tem tudo o que é preciso para chegar ao vendedor: nome do stand, morada com coordenadas e telefone. A cessão de leasing e o preço sob consulta estão assinalados com indicadores próprios, por isso é fácil excluir esses anúncios da comparação de preços. Os métodos da API são os mesmos do Encar e da K Car, e as três fontes coreanas podem ser geridas num só sistema.

Os nomes das marcas, dos modelos e dos níveis de equipamento chegam em inglês, e os originais coreanos ficam guardados em original_names.

Resposta em 2 min