
KB Chachacha APIScraper et parser
KB Chachacha API : annonces de concessionnaires coréens avec prix en wons, estimation du prix de marché, sinistres, gage et saisie, équipements et photos.
KB Chachacha API
Dans l'API KB Chachacha, le prix du vendeur s'accompagne de l'estimation du prix de marché établie par KB Chachacha lui-même : borne basse, moyenne et borne haute. Ces valeurs facilitent la comparaison des offres d'un même modèle, tandis que les sinistres et les mentions de gage et de saisie aident à retenir les annonces à examiner de plus près. Vous n'aurez besoin ni d'un parser ni d'un scraper de kbchachacha.com : les noms sont déjà traduits en anglais, les équipements sont regroupés dans une liste, les coordonnées de la concession et les photos font partie de la réponse.
Les nouvelles annonces KB Chachacha, les changements de prix et les retraits de la vente arrivent sous forme d'événements via /changes.
Un fichier quotidien avec les annonces KB Chachacha actives au matin du jour concerné.
Marque, modèle, génération et finition, année-modèle et mois d'immatriculation, kilométrage, carburant, boîte, catégorie de véhicule, prix du vendeur et estimation du prix de marché par KB Chachacha, sinistres, changements de propriétaire, gage et saisie, équipements, vendeur avec adresse et téléphone, photos.
URL de base
https://{access_name}.auto-api.com/api/v2/kbchachachaAutorisation : api_key paramètre
Flux de travail
/filtersce que les filtres acceptent : marques, modèles, valeursChargement initial des annonces :
/change_id?date=...obtenir l'ID de changement du premier événement du jour/offersrécupérer les annonces page par page/changes?change_id=...nouvelles annonces, changements de prix, retraits de la vente/offerune annonce par son inner_idPar où commencer :
1. Commencez par tester la sélection qui vous intéresse via /offers : indiquez la marque, le modèle et des limites de prix ou de kilométrage. Reprenez l'orthographe des marques et les valeurs des autres filtres dans /filters.
2. Pour maintenir chez vous toute la base d'annonces, il vous faut la position de départ du flux. Obtenez-la avec la méthode /change_id pour la date du jour à l'heure de Corée ; si la réponse vaut 0, relancez la requête plus tard. Une fois l'ID conservé, chargez les pages de /offers l'une après l'autre : la dernière est celle où next_page vaut null.
3. Après le chargement, appliquez les événements de /changes à partir de l'ID conservé. Demandez le lot suivant avec le next_change_id de la réponse. Quand il n'y a pas d'événement, result arrive sous forme de tableau vide et next_change_id vaut null : à l'interrogation suivante, transmettez le même change_id.
GET/filters
Retourne toutes les valeurs possibles pour le filtrage
https://{access_name}.auto-api.com/api/v2/kbchachacha/filters?api_key=YOUR_API_KEYRéponse :
{
"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"]
}
// ... et d'autres marques
},
"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
Liste des annonces avec pagination et filtres
Paramètres :
page(requis) - numéro de pagemark, model- marque et modèle, orthographiés comme dans /filterstransmission_type, color, body_type, engine_type, drive_type, region- boîte, couleur, catégorie de véhicule, carburant, transmission et région, tels que /filters les renvoie ; la casse n'est pas prise en compteyear_from, year_to- bornes pour le champ yearkm_age_from, km_age_to- plage de kilométrage, en kmprice_from, price_to- plage de prix, en 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=DieselRéponse :
{
"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\"]", // 53 options au total pour cette voiture
"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 photos au 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": "마스터즈 그래비티"
}
}
}
}
// ... les annonces suivantes, 20 au plus par page
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Champs de la fiche
- id - numéro de la fiche chez nous ; c'est inner_id qui relie la fiche à l'annonce sur KB Chachacha
- inner_id - numéro de l'annonce sur KB Chachacha, soit le paramètre carSeq du lien : 28740959
- url - lien vers l'annonce sur kbchachacha.com
- mark, model - marque et modèle en anglais : Kia, Mohave
- generation - génération, par exemple Mohave The Master
- configuration - version avec le moteur et la transmission : 3.0 Diesel 4WD
- complectation - finition : Masters Gravity ; n'est pas renseignée dans toutes les annonces
- year - année-modèle ou, si KB Chachacha ne l'indique pas, année de première immatriculation ; le mois d'immatriculation arrive dans registration_month
- color - couleur de carrosserie issue de la liste de /filters ; vide si KB Chachacha n'indique pas la couleur
- body_type - catégorie de véhicule telle que KB Chachacha la définit : "Small car", "Mid-size car", "Full-size car", "SUV", "Minivan", "Truck" ; toutes les valeurs sont dans /filters
- engine_type - type de carburant, valeurs de /filters
- displacement - cylindrée du moteur, en cm³ ; vide pour les voitures électriques
- transmission_type - boîte : "Automatic", "Manual", "CVT" ou "Other"
- drive_type - 2WD, 4WD ou AWD quand la transmission figure dans le nom de la version ; vide sinon
- price - prix en wons coréens ; -1 s'il n'y a pas de prix : prix sur demande ou reprise de leasing
- km_age - kilométrage, en km
- no_accidents - true uniquement s'il n'y a aucun sinistre, y compris pour des dommages causés à d'autres véhicules
- equipment - liste des options : tableau JSON dans une chaîne ; chaîne vide si les options ne sont pas indiquées
- description - texte du vendeur, en coréen
- seller - nom de la concession indiqué dans l'annonce
- seller_type - qui a publié l'annonce : "Dealer", "Dealership manager", "Dealership owner" ou "Private seller"
- is_dealer - false pour les particuliers, true pour les autres vendeurs
- salon_id - numéro de la concession sur KB Chachacha
- phone - numéro de téléphone de l'annonce
- region - région de Corée, valeurs de /filters
- address - adresse de la concession, en coréen
- latitude, longitude - coordonnées GPS de la concession, si KB Chachacha les indique
- images - liens des photos : tableau JSON dans une chaîne ; chaîne vide pour les annonces sans photo
- offer_created - date de première publication de l'annonce
- extra_prep - données supplémentaires de l'annonce, détaillées ci-dessous ; null quand une valeur est absente
Contenu de extra_prep
- registration_month - mois de première immatriculation : 2022-07
- car_number - numéro d'immatriculation coréen
- seats - nombre de places
- seat_color - couleur des sièges
- is_price_on_request - true si le vendeur n'a pas indiqué de prix et invite à le lui demander
- is_lease_takeover - true pour les annonces de reprise de leasing
- lease_monthly_payment - mensualité du leasing, en wons ; renseignée uniquement pour une reprise de leasing
- market_price_min, market_price_avg, market_price_max - estimation du prix de marché par KB Chachacha, en wons : borne basse, moyenne, borne haute
- views - nombre de vues de l'annonce
- original_names - marque, modèle, génération, version et finition en coréen, comme sur KB Chachacha
- insurance_accidents - nombre de sinistres avec dommages à cette voiture
- insurance_accidents_total - nombre total de sinistres, y compris ceux où les dommages ont été causés à d'autres véhicules
- total_loss, flood - perte totale ou non, inondation ou non
- owner_changes - nombre de changements de propriétaire
- seizure, mortgage - saisie ou non, gage ou non
- rental_history - true si la voiture a servi de véhicule de location ou de leasing
- kb_diagnosis - true si la voiture a passé l'inspection KB
- kb_warranty - true si la voiture est couverte par la garantie KB
- manufacturer_certified, partner_certified, kb_certified - trois indicateurs : certification par le constructeur, par un partenaire de KB Chachacha, par KB lui-même
GET/change_id
Obtenir le premier ID de changement par date (pour utiliser dans /changes)
Paramètres :
date(requis) - date au format yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/kbchachacha/change_id?api_key=YOUR_API_KEY&date=2026-09-29Réponse :
{ "change_id": 34419 }Utilisez la valeur retournée comme paramètre change_id dans /changes
GET/changes
Flux de changements (ajouté/modifié/supprimé)
Paramètres :
change_id(requis) - à partir de quel ID de changement
https://{access_name}.auto-api.com/api/v2/kbchachacha/changes?api_key=YOUR_API_KEY&change_id=34419Réponse :
{
"result": [
{
"id": 34419,
"inner_id": "26487093",
"change_type": "added", // added : nouvelle annonce
"created_at": "2026-09-29T03:46:49.147+03:00",
"data": { ... } // tous les champs de l'annonce, comme dans /offers
},
{
"id": 34420,
"inner_id": "26502575",
"change_type": "changed", // changed : le prix a changé, valeur en wons
"created_at": "2026-09-29T03:46:49.388+03:00",
"data": { "new_price": 23000000 }
},
{
"id": 34421,
"inner_id": "28797429",
"change_type": "removed", // removed : l'annonce est retirée
"created_at": "2026-09-29T08:48:00.262+03:00",
"data": {}
}
],
"meta": { "cur_change_id": 34419, "next_change_id": 34422, "limit": 20 }
}GET/offer
Annonce unique par inner_id
Paramètres :
inner_id(requis)
https://{access_name}.auto-api.com/api/v2/kbchachacha/offer?api_key=YOUR_API_KEY&inner_id=28740959Réponse : objet data (identique à /offers, mais sans l'enveloppe result)
Conservation
Les fichiers restent disponibles au moins 3 jours
Disponibilité
De nouveaux fichiers chaque matin
Format CSV
Les colonnes CSV sont séparées par le caractère pipe (|)
Structure de l'URL :
Paramètres :
access_name- votre sous-domaine personneldate- date de l'export au format aaaa-mm-jj, par ex. 2026-10-07file_name- nom du fichier avec extension
Fichiers 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
Exemple de requête 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.csvExemple de commande Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'KB Chachacha (kbchachacha.com) appartient à KB Capital, société financière du groupe KB Financial. Avec Encar, ce sont les deux plus grands sites d'annonces de voitures d'occasion de Corée. Les annonces sont publiées pour l'essentiel par des concessionnaires installés dans des complexes de vente automobile de tout le pays, de Séoul à Jeju. On y trouve aussi bien des marques coréennes que des voitures importées : Mercedes-Benz, BMW, Audi.
KB Chachacha estime lui-même le prix de marché de la voiture et en affiche la fourchette à côté du prix du vendeur. L'annonce montre le nombre de sinistres et de changements de propriétaire, ainsi que les mentions de perte totale, d'inondation, de saisie et de gage. Une partie des voitures a passé l'inspection KB ou est vendue avec la garantie KB, et certaines ont une certification constructeur. On trouve aussi des annonces de reprise de leasing, où une mensualité est indiquée à la place du prix.
Pour un importateur, l'annonce contient tout ce qu'il faut pour joindre le vendeur : le nom de la concession, son adresse avec les coordonnées GPS et son téléphone. La reprise de leasing et le prix sur demande sont signalés par des indicateurs distincts, si bien que ces annonces sont faciles à écarter d'une comparaison de prix. Les méthodes de l'API sont les mêmes que pour Encar et K Car, et les trois sources coréennes peuvent être gérées dans un même système.
Les noms des marques, des modèles et des finitions arrivent en anglais, et les originaux coréens sont conservés dans original_names.
Étendez votre accès aux données automobiles sur les marchés mondiaux avec nos API de plateforme complètes :