K Car APIScraper et parser
K Car API : voitures de kcar.com, VIN, prix fixe en wons, réparations de carrosserie, historique d'assurance, photos. Flux de changements, fichiers quotidiens.
K Car API
L'API K Car vous aide à étudier une voiture avant de contacter l'agence. Dans la fiche, vous pouvez confronter l'inspection de la carrosserie à l'historique d'assurance et aux relevés de kilométrage, consulter les photos et le prix actuel, et vérifier la voiture auprès d'autres sources grâce au VIN. Nous nous chargeons de collecter les données de kcar.com : aucun parser ni scraper de votre côté n'est nécessaire.
Le flux de changements montre quand une voiture K Car est mise en vente, quand son prix change et quand elle est retirée de la vente.
L'export quotidien K Car regroupe toutes les voitures qui restent en vente.
VIN, année-modèle et mois de première immatriculation, kilométrage avec son historique, puissance, carburant, boîte et transmission, résultat de l'inspection et liste des éléments de carrosserie remplacés et réparés, historique d'assurance, équipements, agence avec coordonnées GPS, photos.
URL de base
https://{access_name}.auto-api.com/api/v2/kcarAutorisation : api_key paramètre
Flux de travail
/filtersmarques, modèles et valeurs des filtresPremier chargement du stock :
/change_id?date=...conserver l'ID de changement à partir duquel lire le flux/offerstélécharger les voitures en vente, toutes ou selon des filtres/changes?change_id=...mises en vente, nouveaux prix et retraits à partir de cet ID/offerune voiture par inner_idPar où commencer :
1. Conservez la position de départ du flux avant de charger les voitures : appelez /change_id avec la date du jour à l'heure de Séoul. Si la réponse vaut 0, il n'y a pas encore eu d'événement ce jour-là : relancez l'appel plus tard avec la même date.
2. Téléchargez le stock via /offers, en passant à la page indiquée dans next_page jusqu'à ce qu'il vaille null. Traitez ensuite /changes à partir de la position conservée : pendant le chargement, une partie des voitures a pu voir son prix baisser ou augmenter, ou être retirée de la vente.
3. Ensuite, après chaque lot d'événements, conservez next_change_id et interrogez /changes avec cette valeur. Quand il vaut null, gardez la même position et réessayez plus tard. Pour une commande précise, choisissez les voitures via /offers avec des filtres.
GET/filters
Retourne toutes les valeurs possibles pour le filtrage
https://{access_name}.auto-api.com/api/v2/kcar/filters?api_key=YOUR_API_KEYRéponse :
{
"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"]
}
// ... les autres marques
},
"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
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, type de carrosserie, carburant, transmission et région : valeurs de /filters, sans distinction de casseyear_from, year_to- plage sur le champ yearkm_age_from, km_age_to- plage de kilométrage, en kmprice_from, price_to- plage de prix, en wons coréens
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=GasolineRéponse :
{
"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 options dans la réponse complète
"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 photos dans la réponse complète
"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
}
}
}
// ... les autres voitures, jusqu'à 20 par page
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Champs de la fiche
- id - notre numéro interne de la fiche ; l'annonce sur K Car s'identifie par inner_id
- inner_id - code de l'annonce sur K Car, le même que dans le lien : EC61380785
- url - lien vers l'annonce sur kcar.com
- title - nom complet de la voiture sur une seule ligne
- mark, model - marque et modèle en caractères latins, par exemple Hyundai et Palisade
- generation - génération du modèle : The New Palisade, Grandeur (GN7)
- body_configuration - code châssis constructeur, quand K Car l'indique entre parenthèses dans le nom de la génération : GN7, RG3 ; vide sinon
- configuration - version : moteur et transmission, par exemple Gasoline 3.8 2WD
- complectation - finition : Exclusive, Calligraphy ; peut être vide
- year - année-modèle ; si elle n'est pas indiquée ou est encore à venir, année de première immatriculation
- vin - VIN complet, 17 caractères
- color - couleur de carrosserie, valeurs de /filters
- body_type - type de carrosserie, valeurs de /filters
- doors_count - nombre de portes ; vide pour une partie des voitures
- engine_type - type de carburant, valeurs de /filters
- displacement - cylindrée du moteur en cm³ ; vide pour les voitures électriques et à hydrogène
- horse_power - puissance en ch
- transmission_type - boîte de vitesses, valeurs de /filters
- drive_type - transmission : FWD, RWD ou AWD
- price - prix actuel en wons coréens ; la remise hebdomadaire est déjà déduite
- km_age - kilométrage en kilomètres
- no_accidents - true si, d'après l'inspection K Car, aucun élément de structure ni panneau extérieur n'a été remplacé ni réparé ; des sinistres restent possibles, ils figurent dans insurance_history
- equipment - équipements : noms des options sous forme de tableau JSON dans une chaîne
- description - description de la voiture par K Car, en coréen
- seller - agence K Car où se trouve la voiture : K Car Gimpo
- salon_id - code de l'agence
- region - région de l'agence, valeurs de /filters
- address - adresse de l'agence en coréen
- latitude, longitude - coordonnées GPS de l'agence
- images - liens des photos : tableau JSON dans une chaîne ; en général plusieurs dizaines de clichés
- offer_created - date de publication de l'annonce, à l'heure de Corée
- extra_prep - objet avec des données supplémentaires, dont les champs sont décrits ci-dessous ; les valeurs absentes arrivent en null
Contenu de extra_prep
- first_registration - mois de première immatriculation : 2023-03
- model_year - année-modèle sous forme de nombre
- price_base - prix hors remise hebdomadaire, en wons ; identique à price quand il n'y a pas de remise
- is_discount - true si une remise hebdomadaire s'applique à la voiture
- is_time_deal - true pour les voitures en offre à durée limitée
- is_reserved - true si un acheteur a réservé la voiture
- car_class - catégorie de véhicule selon la classification K Car : "Light car", "Compact", "Mid-size", "SUV" et autres
- seats - nombre de places
- badges - badges de l'annonce, par exemple "One owner", "Low mileage", "Manufacturer warranty"
- views_count, favorites_count - nombre de vues de l'annonce et d'ajouts aux favoris
- inspection_date - date de l'inspection K Car
- accident_history - groupe attribué par K Car : "No accident", "Minor repair" ou "Accident" ; body_damage indique quels éléments ont été remplacés ou réparés
- body_damage - éléments de carrosserie remplacés et réparés : frame contient les éléments de structure, exterior les panneaux extérieurs ; la valeur replaced indique un remplacement, repaired une réparation ; des objets vides signifient qu'il n'y a pas de remarque, et null arrive quand il n'y a pas de données d'inspection de la carrosserie
- insurance_history - historique d'assurance : date du rapport (checked_at), nombre total de sinistres (accidents_count), sinistres et indemnisations pour cette voiture (own_damage_count, own_damage_amount), sinistres et montants des dommages causés à d'autres véhicules (other_damage_count, other_damage_amount), montants en wons ; compteurs de pertes totales, d'inondations, de vols, de changements de propriétaire et de changements de numéro d'immatriculation ; indicateurs d'usage en location, d'usage commercial et d'usage par l'administration ; périodes sans assurance
- mileage_history - kilométrage par date : date, kilomètres et source du relevé
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/kcar/change_id?api_key=YOUR_API_KEY&date=2026-09-29Réponse :
{ "change_id": 283 }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/kcar/changes?api_key=YOUR_API_KEY&change_id=283Réponse :
{
"result": [
{
"id": 283,
"inner_id": "EC61410729",
"change_type": "added", // added : la voiture est mise en vente
"created_at": "2026-09-29T02:58:42.752+03:00",
"data": { ... } // fiche complète, comme dans /offers
},
{
"id": 284,
"inner_id": "EC61414869",
"change_type": "changed", // changed : nouveau prix en wons
"created_at": "2026-09-29T03:16:53.512+03:00",
"data": { "new_price": 10200000 }
},
{
"id": 285,
"inner_id": "EC60843517",
"change_type": "removed", // removed : la voiture est retirée de la vente
"created_at": "2026-09-29T03:16:54.711+03:00",
"data": {}
}
],
"meta": { "cur_change_id": 283, "next_change_id": 286, "limit": 20 }
}GET/offer
Annonce unique par inner_id
Paramètres :
inner_id(requis)
https://{access_name}.auto-api.com/api/v2/kcar/offer?api_key=YOUR_API_KEY&inner_id=EC61380785Ré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-06file_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'K Car (kcar.com) vend des voitures d'occasion de son propre stock et reste le plus grand vendeur de ce type en Corée du Sud. L'entreprise est issue de la division de vente directe de SK Encar et opère sous la marque K Car depuis 2018. Elle rachète les voitures à leurs propriétaires, les inspecte et les vend à travers un réseau d'agences dans tout le pays, y compris avec livraison à domicile.
Chez K Car, les prix sont fixes, sans négociation, et une partie des voitures bénéficie de remises hebdomadaires. Avant la vente, la voiture passe une inspection, et l'annonce indique dans quel groupe elle a été classée : sans accident, réparation mineure ou accidentée. L'annonce énumère aussi les éléments de carrosserie remplacés et réparés, les sinistres avec les montants indemnisés et les relevés de kilométrage par date. Le VIN est affiché en clair.
Mieux vaut lire l'inspection K Car en regard de l'historique d'assurance : une voiture classée sans accident peut avoir donné lieu à des indemnisations d'assurance, car le groupe ne décrit que la structure et les panneaux extérieurs. Pour calculer les droits de douane et taxes à l'importation, la fiche contient le mois de première immatriculation, la cylindrée et la puissance du moteur. Si un acheteur a déjà réservé la voiture, l'indicateur is_reserved le montre.
Le flux /changes signale les nouvelles annonces, les changements de prix et les retraits de la vente. La méthode /offer renvoie le statut de réservation et les autres données de la voiture dans leur état actuel.
Étendez votre accès aux données automobiles sur les marchés mondiaux avec nos API de plateforme complètes :