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

1
/filtersobtenir les valeurs de filtre disponibles
2
/offersobtenir les annonces (avec ou sans filtres) - utiliser pour le chargement initial des données
3

Pour 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
4
/offerobtenir les détails d'une annonce spécifique par inner_id

Approche 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_KEY

Ré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 page
  • mark, 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ées
  • km_age_from, km_age_to - filtre de plage de kilométrage
  • price_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=black

Ré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-15

Ré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=1

Ré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=40427050

Ré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/info

Autorisation 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 :

https://{access_name}.auto-api.com/{date}/{file_name}

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.csv

Commande de téléchargement Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'