DocumentationRéférence API
Documentation API Scraper Automobile. Apprenez comment accéder aux données automobiles via des points d'accès API directs. Guides d'intégration et exemples de code.
Nous fournissons des données automobiles propres et structurées directement via API. Cela élimine le besoin de configuration complexe, de gestion d'infrastructure ou de maintenance technique.
Pourquoi Nous Choisir
Expertise Sectorielle
Un fournisseur d'API de données automobiles de confiance avec plus de 8 ans d'expérience depuis 2017.
Support 7 Jours
Notre équipe de support dédiée est disponible 7 jours sur 7 pour vous aider avec votre intégration API.
Fiabilité de Service 24/7
Une surveillance continue 24 heures sur 24 garantit une disponibilité maximale pour une livraison de données fiable.
Capacités API clés | Scrapers et parsers
Alertes d'annonces en temps réel
Obtenez un accès API instantané aux nouvelles annonces automobiles et trouvez les opportunités en premier.
Exports quotidiens de données
Obtenez des exports quotidiens des annonces actives et supprimées pour l'analyse de marché et le suivi des ventes.
Formats d'export flexibles
Obtenez des données aux formats CSV, JSON, Excel et personnalisés pour une intégration facile.
Questions fréquemment posées | API vs scraper et crawler
Comment fonctionne l'API automobile ?
L'API automobile fournit un accès en temps réel aux données des principales places de marché automobiles. Fournit des données structurées via API REST pour une analyse immédiate.
Quels ensembles de données l'API automobile fournit-elle ?
Obtenez des données automobiles complètes incluant spécifications, prix, informations vendeur, emplacement et kilométrage. Accédez à des millions d'annonces depuis les principales plateformes via des appels API.
Y a-t-il des limites d'utilisation pour l'API automobile ?
Aucune limite d'utilisation avec une limitation de débit pour des performances stables. Obtenez toutes les annonces actives dans toutes les régions via l'API en temps réel ou les exports quotidiens. Aucune restriction pour les partenaires entreprise.
Comment puis-je suivre les nouvelles annonces automobiles avec l'API en temps réel ?
Surveillez les annonces en utilisant le paramètre 'change_id'. Commencez avec change_id=0, puis utilisez le dernier ID de changement + 1. Capture les nouvelles annonces, changements de prix, suppressions sur toutes les plateformes.
Quels formats de données supportez-vous ?
Obtenez des données aux formats CSV, JSON, Excel et base de données. Tous les formats contiennent des données complètes de toutes les plateformes.
Pouvez-vous fournir un accès API personnalisé pour une place de marché spécifique ?
Oui, nous construisons des API personnalisées pour n'importe quelle place de marché automobile. Obtenez un accès aux données adapté à vos besoins spécifiques. Contactez-nous pour les exigences.
Mon utilisation des données et mon partenariat sont-ils confidentiels ?
Oui. Nous travaillons sous des accords de confidentialité stricts avec tous les clients. Votre utilisation de nos services de données automobiles reste complètement privée et sécurisée.
Dois-je gérer une infrastructure ou des serveurs ?
Non, c'est entièrement géré. Nous gérons toute l'infrastructure, les serveurs et la collecte de données. Obtenez des données prêtes à l'emploi sans configuration technique.
URL de base
https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}Autorisation : api_key parameter
Flux de travail
/filtersobtenir les valeurs de filtre disponibles/offersobtenir les annonces (avec ou sans filtres) - utiliser pour le chargement initial des donnéesPour les mises à jour (maintenir les données à jour après le chargement initial) :
/change_id?date=...obtenir l'ID de départ pour le flux de changements/changes?change_id=...obtenir tous les changements dans la base de données à partir de l'ID/offerobtenir les détails d'une annonce spécifique par inner_idApproche d'intégration recommandée :
1. D'abord, utilisez /offers pour la récupération initiale des données (parcourez toutes les pages)
2. Ensuite, utilisez /changes pour la récupération périodique de toutes les modifications (ajoutées/modifiées/supprimées) afin de synchroniser votre base de données locale avec la source
3. Pour l'intégration des données sur le site web, vous pouvez utiliser /offers avec des filtres et une pagination (marque, modèle, prix, année, etc.)
GET/filters
Retourne toutes les valeurs possibles pour le filtrage
https://{access_name}.auto-api.com/api/v2/{platform}/filters?api_key=YOUR_API_KEYRéponse :
{
"mark": {
"Hyundai": {
"model": {
"Sonata": {
"configuration": {
"DN8": { "complectation": ["Smart", "Modern", "Premium"] }
}
}
}
},
"Kia": {
"model": {
"K5": {
"configuration": {
"DL3": { "complectation": ["LX", "EX", "SX"] }
}
}
}
}
},
"transmission_type": ["Manual", "Automatic", "Semi-Automatic", "CVT", "Other"],
"color": ["White", "Black", "Silver", "Gray", "Blue", "Red", "Brown", "Beige", "Gold", "Green", "Yellow", "Orange", "Purple", "Pink", "Pearl", "Burgundy", "Turquoise", "Sky Blue", "Other"],
"body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Pickup Truck", "Coupe/Roadster", "Microbus", "RV", "Other"],
"engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid (Gasoline)", "Hybrid (Diesel)", "Hydrogen", "LPG", "CNG", "Gasoline + LPG", "Gasoline + CNG", "LPG + Electric", "Other"]
}GET/offers
Liste des annonces avec pagination et filtres
Paramètres :
page(requis) - numéro de pagemark, model, configuration, complectation- filters (insensible à la casse)transmission_type, color, body_type, engine_type- filters (insensible à la casse)year_from, year_to- filtre de plage d'annéeskm_age_from, km_age_to- filtre de plage de kilométrageprice_from, price_to- filtre de plage de prix (en unités de 10 000 KRW)
https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=blackRéponse :
{
"result": [
{
"id": 3219435,
"inner_id": "40427050",
"change_type": "added",
"created_at": "2025-09-08T12:02:03.000Z",
"data": {
"id": 1454012,
"inner_id": "40427050",
"url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
"mark": "Hyundai",
"model": "Palisade",
"generation": "Diesel 2.2 4WD",
"configuration": "Diesel 2.2 4WD",
"complectation": "Prestige",
"year": 2021,
"color": "Black",
"price": 3190,
"price_won": "31900000",
"km_age": 92842,
"engine_type": "Diesel",
"transmission_type": "Automatic",
"body_type": "SUV",
"address": "Busan Gijang-gun",
"seller_type": "DEALER",
"is_dealer": true,
"images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
"extra": {"diagnosis": {...}, "inspection": {...}, "accidents": [...]}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Champs de données :
- id - ID interne de base de données
- inner_id - ID de l'annonce sur la plateforme
- url - lien vers l'annonce
- mark - marque de voiture
- model - modèle de voiture
- generation - génération
- configuration - configuration
- complectation - finition/version
- year - année de production
- color - couleur
- price - prix (en unités de 10 000 KRW)
- price_won - prix complet en KRW
- km_age - kilométrage en km
- engine_type - type de moteur
- transmission_type - type de transmission
- body_type - type de carrosserie
- address - adresse
- seller_type - type de vendeur
- is_dealer - indicateur concessionnaire (true/false)
- section - section
- seller - vendeur
- salon_id - ID du concessionnaire
- description - description
- displacement - cylindrée du moteur (cc)
- offer_created - date de création de l'annonce
- images - tableau d'URLs d'images
- extra - données supplémentaires (JSON)
- options - liste d'options
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/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15Réponse :
{ "change_id": 1547283 }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/{platform}/changes?api_key=YOUR_API_KEY&change_id=1Réponse :
{
"result": [
{
"id": 456,
"inner_id": "40427050",
"change_type": "added", // added - new listing
"created_at": "2025-01-15T10:30:00Z",
"data": { ... } // full listing data
},
{
"id": 457,
"inner_id": "40427051",
"change_type": "changed", // changed - price update
"created_at": "2025-01-15T10:31:00Z",
"data": { "new_price": 3490 }
},
{
"id": 458,
"inner_id": "40427052",
"change_type": "removed", // removed - listing deleted
"created_at": "2025-01-15T10:32:00Z"
}
],
"meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}GET/offer
Annonce unique par inner_id
Paramètres :
inner_id(requis)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050Réponse : objet data (identique à /offers, mais sans l'enveloppe result)
Récupérer les données complètes de l'annonce en fournissant l'URL d'origine de n'importe quelle plateforme prise en charge. Idéal pour les consultations rapides et la récupération d'une seule annonce.
URL de base
https://{access_name}.auto-api.com/api/v1/offer/infoAutorisation via l'en-tête x-api-key
POST/api/v1/offer/info
Envoyer une requête POST avec l'URL de l'annonce pour obtenir les données complètes
Paramètres :
url(requis) - lien vers l'annonce sur n'importe quelle plateforme prise en charge
Exemple de requête :
curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419" }'Réponse :
{
"inner_id": "39225419",
"url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
"mark": "BMW",
"model": "5-Series",
"generation": "528i",
"year": 2010,
"year_month": "2010-08",
"color": "Silver",
"price": 880,
"price_won": 8800000,
"km_age": 132437,
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "Sedan",
"displacement": "2996",
"power": "230",
"vin": "WBAFR1105AC258998",
"address": "Gwangju Seo-gu",
"seller_type": "DEALER",
"is_dealer": true,
"offer_created": "2025-11-17",
"images": [
"https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
"https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
]
}Champs de données :
- inner_id - ID de l'annonce sur la plateforme
- url - lien vers l'annonce
- mark - marque de voiture
- model - modèle de voiture
- generation - génération
- year - année de production
- year_month - année et mois de production
- color - couleur
- price - prix en unités de 10000 KRW
- km_age - kilométrage en km
- engine_type - type de moteur
- transmission_type - type de transmission
- body_type - type de carrosserie
- displacement - cylindrée du moteur (cc)
- power - puissance en ch
- vin - code VIN
- address - adresse
- seller_type - type de vendeur
- is_dealer - indicateur concessionnaire (true/false)
- offer_created - date de création de l'annonce
- images - tableau d'URLs d'images
Politique de conservation des données
Fichiers stockés pendant au moins 3 jours
Planning de disponibilité de l'API
Fichiers quotidiens frais disponibles au téléchargement
Format de données CSV
Les fichiers CSV utilisent le pipe (|) comme séparateur de colonnes
Structure de l'URL :
Paramètres de requête :
access_name- votre identifiant de sous-domaine attribuédate- date cible au format yyyy-mm-dd (ex : 2025-09-06)file_name- nom du fichier d'export avec extension
Formats 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 API 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.csvCommande de téléchargement Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'