Documentation

URL de base

Toutes les requêtes API sont effectuées vers l'URL de base suivante :

https://api.encarapi.com

Par exemple, pour récupérer les offres :

GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true

Authentification

Authentifiez vos requêtes à l'aide d'une clé API. Transmettez-la en paramètre de requête ou via l'en-tête Authorization.

# Send your API key in the x-api-key header (recommended):
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true"

# The api_key query parameter also works:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true&api_key=YOUR_API_KEY

Essai de 5 jours

Testez l'API pendant 5 jours avec les trois places de marché (Encar, KB Chachacha, K Car), y compris la synchronisation des changements (7 derniers jours), les requêtes groupées (1 000 ids par jour) et un aperçu de l'archive (100 annonces supprimées par jour). 100 000 lignes de catalogue et 2 000 consultations de détail au total (max. 1 000 par jour). Les téléchargements de référence (CSV) font partie des offres payantes. L'export complet du catalogue commence avec Business. Ensuite, votre abonnement continue avec l'offre Starter à 149 €/mois - résiliable à tout moment avant le 5e jour.

Valeurs en russe (lang=ru)

Chaque endpoint qui accepte lang=en accepte aussi lang=ru : les valeurs affichées arrivent en russe, tout le reste est identique (ids, codes, prix, nombres, noms de champs). Une valeur sans libellé russe revient à l'anglais. Les libellés russes peuvent être affinés avec le temps : reliez vos données par ids et codes, pas par libellés.

• Traduits : carburant, boîte de vitesses, transmission, couleur extérieure et intérieure, catégorie de carrosserie, type de vente, noms de régions et de villes, noms d'options et mots génériques des finitions (Diesel -> дизель, 7-Seater -> 7 мест). Générations de modèles : Carnival 4 Gen -> Carnival 4 поколение. Les noms de marques, modèles et finitions restent en alphabet latin, comme sur les sites automobiles russes.
• Les filtres acceptent aussi les valeurs russes : fuel=дизель, color=белый, region=Сеул, city=Сувон, drivetrain=полный, sell_type=лизинг. Les valeurs anglaises continuent de fonctionner.
• /api/enums?lang=ru ajoute nameRu à chaque valeur et liste les valeurs drivetrain et sell_type. /api/nav?lang=ru renvoie un DisplayValue en russe ; Value reste le code anglais pour filtrer. Avec lang=ru, les CSV de référence reçoivent le nom russe dans une colonne supplémentaire après la dernière.
• /api/vehicle/{id}?lang=ru et l'endpoint bulk renvoient en russe les valeurs spec d'Encar, les noms category et les noms optionsDecoded, et les annonces KB Chachacha comme dans le catalogue.
• /api/catalog/export?lang=ru est le même fichier avec les colonnes de libellés en russe ; l'ordre des colonnes et toutes les autres colonnes sont inchangés.
• Non traduits : rapports d'inspection, historiques d'assurance, diagnostics Encar, historiques de véhicule Encar, données détaillées K Car, packs d'options Encar (texte libre de l'annonce) et les endpoints camions et pelleteuses (ils répondent en anglais avec lang=ru).

# Russian values, filtered with Russian values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?fuel=дизель&city=Сувон&lang=ru&count=true"

# Filter values with their Russian labels (nameRu)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/enums?lang=ru"

Valeurs en allemand (lang=de)

lang=de fonctionne comme lang=ru : les valeurs affichées arrivent en allemand, tout le reste est identique (ids, codes, prix, nombres, noms de champs). Une valeur sans libellé allemand revient à l'anglais.

• Traduits : carburant, boîte de vitesses, transmission, couleurs, catégorie de carrosserie, type de vente, noms d'options, ainsi que les noms de modèles et de finitions de nos tables allemandes (C-Class -> C-Klasse, 5-Series -> 5er, Carnival 4 Gen -> Carnival 4. Generation, 7-Seater -> 7-Sitzer, Sedan -> Limousine). Les régions gardent leur nom anglais, les villes restent en anglais.
• Les filtres acceptent aussi les valeurs allemandes : fuel=Benzin, color=Weiß, transmission=Automatik, drivetrain=Allrad, sell_type=Leasingübernahme, model_group=C-Klasse. Les noms de modèles allemands peuvent regrouper les restylages : Carnival 4. Generation couvre Carnival 4 Gen et The New Carnival 4 Gen.
• Listes, détail, bulk et export fonctionnent comme avec lang=ru : nameDe dans /api/enums et /api/taxonomy/option-packages, un DisplayValue allemand dans /api/nav, des colonnes *_de dans les CSV de référence, catalog_export_de.csv pour l'export. Non traduit : comme pour lang=ru.

# German values, filtered with German values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=Mercedes-Benz&model_group=C-Klasse&fuel=Benzin&lang=de&count=true"

Trois places de marché, une seule API

L'API fournit les annonces en direct des trois principales places de marché coréennes de véhicules d'occasion. Chaque endpoint renvoie Encar par défaut, de sorte que les intégrations existantes continuent de fonctionner sans modification. Les deux autres s'activent via le paramètre source.

Sélection des sources

source est accepté par /api/catalog, /api/nav, /api/enums, /api/model-search, /api/catalog/export, /api/catalog/changes et les CSV de taxonomie.

# All three marketplaces, English values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=all&manufacturer=bmw&fuel=diesel&lang=en&count=true"

# K Car only
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=kcar&manufacturer=hyundai&lang=en"

# One KB Chachacha vehicle
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/vehicle/kbc:12345678?lang=en"

Lorsque source est défini, chaque élément comporte un champ Source. Les identifiants Encar restent de simples nombres. Les identifiants KB Chachacha et K Car portent un préfixe (kbc:..., kcar:...) - transmettez-les tels quels à /api/vehicle/{id}. Avec lang=en, les noms de modèle et de finition des trois places de marché sont renvoyés en anglais.

Les concessionnaires publient souvent la même voiture sur Encar et KB Chachacha. Une annonce KB Chachacha est rapprochée d'une annonce Encar active par la plaque d'immatriculation coréenne ou, lorsque KB Chachacha ne publie pas de plaque, par le mois de première immatriculation, le kilométrage et le prix ; ce rapprochement est recalculé plusieurs fois par jour, après chaque passage des catalogues Encar et KB Chachacha. Les annonces KB Chachacha rapprochées ne sont renvoyées ni par /api/catalog, ni par /api/catalog/export, ni par les autres endpoints du catalogue, avec ou sans source (y compris avec source=kbc seul) : la même voiture n'apparaît donc jamais deux fois - lorsque Encar est inclus, elle est renvoyée en tant qu'annonce Encar.

Dans /api/catalog/changes?source=kbc et /api/vehicle/kbc:{id}, ces annonces portent IsDuplicate: true et DuplicateOf (l'identifiant de l'annonce Encar, sous forme de chaîne numérique) ; comme pour les éléments Encar, les deux champs ne sont présents que lorsqu'ils valent true. Lorsque le marqueur est posé ou retiré, le flux de changements enregistre un événement updated dont changedFields contient duplicate. Pour garder une copie locale cohérente avec /api/catalog, supprimez les éléments KB Chachacha qui arrivent avec IsDuplicate: true et rajoutez-les lorsqu'une mise à jour arrive sans ce champ.

Le flux de changements accepte une source par appel (encar, kbc ou kcar) et conserve un curseur distinct pour chacune.

Couverture par place de marché

Toutes les places de marché ne publient pas tous les champs.

• KB Chachacha publie le nombre de sièges pour une partie de ses annonces.
• Détail KB Chachacha = l'élément du catalogue plus le bloc d'historique public (indicateur d'accident, perte totale, inondation, usage commercial, gages, diagnostic du châssis et des panneaux). Chaque élément KB Chachacha comporte aussi InsuranceClaims : le nombre de sinistres d'assurance affiché sur la page de l'annonce. Le détail comporte aussi InspectionReportUrl et InspectionReportType : la fiche d'inspection que KB Chachacha affiche pour la voiture (link = fiche sur le site de l'organisme d'inspection, scan = images scannées uniquement sur la page de l'annonce, null = pas encore connue). Lorsque InspectionAvailable vaut true, GET /api/inspection/kbc:{id} renvoie cette fiche sous forme de données structurées, dans le même format qu'un rapport d'inspection Encar (master, outers, inners, images), plus un bloc source - c'est le cas pour environ deux annonces KB Chachacha sur cinq parmi celles qui comportent un lien vers une fiche.
• K Car n'a pas de documents de rapport séparés ; le nombre d'accidents, les indemnités d'assurance et les changements de propriétaire font partie du détail du véhicule.

Filtrer sur un champ qu'une place de marché ne fournit pas exclut ses véhicules des résultats. Exemple : frame_clean=true avec source=all renvoie uniquement les annonces Encar et K Car.

Endpoints API

Tous les endpoints disponibles pour accéder aux données automobiles coréennes.

Données des menus déroulants (CSV)

Téléchargez les listes de marques, modèles et versions au format CSV, mettez-les en cache et construisez vos menus déroulants à partir de celles-ci - sans appels de facettes à chaque clic ni mapping hors ligne. Chaque fichier comprend une colonne de comptage, et le fichier des versions porte la répartition par carrosserie (Coupé / Berline / Cabriolet).

Questions fréquemment posées