API d'annonces automobiles pour Encar, Mobile.de, Che168, Dongchedi et plus

EncarMobile.deAutoScout24Che168GuaziDongchedi+9 autres

Accédez aux annonces automobiles en temps réel et aux agrégations quotidiennes via une seule API fiable. Surveillez en temps réel les nouvelles annonces, les changements de prix, les publications et les retraits sur toutes les plateformes.

Essayer l'APIVoir la documentationAccès accordé sous 2 minutes
100M+
annonces
15+
plateformes
50+
champs de données
Temps de réponse<200ms
Statut de l'API
opérationnel
API Reference

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)

Obtenir l'annonce par URL

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
Exports quotidiens

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'
Fonctionnalités de l'API

Intégration complète des données

Collectez et normalisez les annonces automobiles de plusieurs plateformes mondiales en temps réel.

Traitement en temps réel

Obtenez les derniers prix, la disponibilité et les spécifications automobiles avec des mises à jour en temps réel.

Analyse de marché

Données de marché enrichies permettant des analyses avancées et des études approfondies.

Services pour entreprises

Services évolutifs avec données personnalisées pour votre entreprise.

Couverture mondiale

Accédez aux données automobiles des principaux marchés en Europe, Amérique du Nord et Asie.

Adapté aux développeurs

API REST avec documentation complète et exemples de code.