Documentation
Documentation EnCarAPI. Découvrez comment accéder aux données automobiles coréennes via des endpoints API directs. Guides d'intégration et exemples de code.
Expérience du secteur
Fournisseur d'API de données automobiles avec des années d'expérience sur le marché coréen.
Support 7 jours
Équipe de support disponible 7 jours sur 7 pour l'aide à l'intégration API.
Service 24h/24
Surveillance permanente pour une livraison de données fiable.
Alertes d'annonces en temps réel
Obtenez un accès API instantané aux nouvelles annonces dès leur publication.
Téléchargements CSV
Téléchargez les listes de marques, modèles et versions au format CSV - mettez-les en cache et évitez les appels de facettes en direct.
Formats d'export flexibles
Obtenez les données en CSV, JSON, Excel et formats personnalisés pour une intégration facile.
URL de base
Toutes les requêtes API sont effectuées vers l'URL de base suivante :
https://api.encarapi.comPar exemple, pour récupérer les offres :
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=trueAuthentification
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_KEYFlux d'intégration
Suivez ces quatre étapes pour vous intégrer à EnCarAPI.
Obtenir les filtres disponibles
Récupérez toutes les valeurs de filtres possibles (marques, modèles, configurations, couleurs, etc.)
GET /filtersObtenir les annonces de véhicules
Récupérez les annonces paginées avec des filtres optionnels pour la marque, le modèle, l'année, le prix, et plus encore.
GET /offers?page=1Suivre les changements
Obtenez un identifiant de changement pour une date, puis interrogez les annonces ajoutées, modifiées et supprimées.
GET /change_id → GET /changesObtenir les détails d'une annonce
Récupérez les détails complets d'une annonce spécifique par son inner_id.
GET /offer?inner_id=...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).
Téléchargez une fois, mettez en cache - Mis à jour quotidiennement
Toutes les marques avec le nombre d'annonces
Toutes les combinaisons de marque et modèle avec les comptages
Toutes les valeurs de marque, modèle et version (y compris Coupé / Berline / Cabriolet) avec les comptages
Ajoutez votre clé API pour télécharger - ajoutez ?api_key=YOUR_KEY à l'URL du fichier. Les fichiers sont protégés par clé, personne ne peut les télécharger sans clé valide.
Fraîcheur des données
Le catalogue (prix, kilométrage, annonces nouvelles et vendues) est actualisé environ toutes les 5 heures, avec une passe plus approfondie une fois par jour. Le détail du véhicule (caractéristiques, photos, état, rapport d'accident) suit son propre cycle, plus lent - généralement dans les 3 semaines suivant un changement, plus vite si le catalogue signale quelque chose de pertinent.
Étendue du catalogue
GET /api/catalog couvre uniquement les annonces de vente standard (type de vente « 일반 » d'Encar). Les reprises de leasing (« 리스 ») et les locations (« 렌트 ») ne sont pas mélangées - elles sont tarifées par mensualité plutôt que par prix d'achat, ce qui fausserait le champ Price. Utilisez plutôt GET /api/catalog/leasing pour ces annonces.
Durée de mise en cache
- Valeurs de filtre, CSV de taxonomie et /api/nav : mettre en cache pendant 24 heures
- Annonces de véhicules (/api/catalog) : mettre en cache pendant 4 à 6 heures
- Détails du véhicule (/api/vehicle/:id) : mettre en cache pendant 24 heures
C'est le modèle du plan Starter : conservez les annonces dans votre propre base de données et actualisez-les à cette fréquence plutôt que d'appeler en direct à chaque clic de l'utilisateur. Ce plan est soumis à une limite quotidienne de volume de catalogue - il est conçu pour des requêtes en direct, pas pour conserver une copie locale intégrale.
Besoin d'une copie locale intégrale à la place ?
Les plans Business et Scale incluent GET /api/catalog/export (un instantané CSV complet généré chaque jour, qui ne compte pas dans la limite quotidienne) ainsi que GET /api/catalog/changes?since=... (annonces ajoutées, mises à jour, réapparues et supprimées depuis votre dernière synchronisation). Initialisez votre base de données à partir de l'export une seule fois, puis interrogez les changements pour la maintenir à jour - fini le retéléchargement de l'intégralité du catalogue. Le plan Scale supprime en plus totalement la limite quotidienne de volume de catalogue.
Annonces en double
Les concessionnaires coréens publient souvent la même voiture deux fois sous des identifiants d'annonce différents, pour plus de visibilité - même prix, même kilométrage, même année-modèle et même modèle/finition. Nous détectons ces cas et signalons les copies supplémentaires avec IsDuplicate: true et DuplicateOf: <ID de l'annonce d'origine> sur l'élément du catalogue ; l'annonce d'origine reste non signalée. Les doublons sont signalés, pas supprimés, à vous de décider comment les traiter - passez exclude_duplicates=true à /api/catalog ou /api/catalog/leasing pour les filtrer côté serveur.
Questions fréquemment posées
Prêt à commencer ?
Contactez-nous sur Telegram pour obtenir vos identifiants API et commencer à accéder aux données automobiles coréennes dès aujourd'hui.