Qu'est-ce que l'API Guazi et comment fonctionne-t-elle ?

Connectez-vous au plus grand marketplace chinois de voitures d'occasion via notre API. Récupérez des données automobiles structurées via des endpoints REST. Suivez les véhicules certifiés, les variations de prix et les ventes en temps réel.

Quelles données Guazi l'API fournit-elle ?

Informations complètes sur les véhicules : marque, modèle, prix, kilométrage, statut de certification, rapports d'inspection, historique des accidents et photos professionnelles de toutes les annonces Guazi.

À quelle fréquence les données Guazi sont-elles actualisées ?

Flux de données continu. Nouvelles annonces de voitures d'occasion détectées en quelques minutes. Fichiers quotidiens incluant tous les véhicules certifiés actifs et récemment vendus.

Quels formats l'API Guazi prend-elle en charge ?

Plusieurs formats : API REST pour mises à jour en temps réel, JSON pour données structurées, CSV pour analyses et Excel pour rapports professionnels. Tous les formats incluent les détails complets d'inspection et de certification.

What is the 259-point inspection included in the data?

Each Guazi listing includes results from their comprehensive 259-point professional inspection. The API provides inspection status, detailed reports, and certification levels for every vehicle.

How often are daily exports updated?

New files are generated every morning. They contain a complete snapshot of active listings and a list of vehicles removed the previous day.

Can I access complete accident history through the API?

Yes, all listings include full accident history reports. The data shows previous damages, repair records, and certification status based on Guazi's verification process.

Guazi APIScraper & Parser

Accédez aux données certifiées de voitures d'occasion via l'API de la plus grande plateforme chinoise. Rapports d'inspection en 259 points, historique des accidents, inventaire en temps réel sans scrapers.

API plateforme de voitures d'occasion Guazi

Accédez au principal marketplace chinois de voitures d'occasion certifiées via notre API. Récupérez des données de qualité depuis Shanghai, Pékin et les grandes villes chinoises pour analyses de marché et gestion d'inventaire.

API en temps réel

Recevez des alertes instantanées pour les nouvelles annonces de voitures d'occasion certifiées.

Exports Quotidiens

Export quotidien de toutes les voitures certifiées actives pour suivi du marché.

Parser de données

Accédez aux données complètes de voitures d'occasion : prix, spécifications, rapports d'inspection, statut de certification, historique des accidents, détails de garantie pour chaque annonce.

Obtenir l'accès APIAccès accordé sous 2 minutes

API

URL de base

https://{access_name}.auto-api.com/api/v2/guazi

Autorisation : api_key paramètre

Flux de travail

/filtersobtenir les valeurs de filtre disponibles

/offersobtenir les annonces (avec ou sans filtres) - utiliser pour le chargement initial des données

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

/offerobtenir les détails d'une annonce spécifique par inner_id

Comment intégrer efficacement :

1. D'abord, utilisez /offers pour récupérer l'ensemble des données (parcourez tous les résultats)

2. Ensuite, interrogez périodiquement /changes pour obtenir toutes les mises à jour (enregistrements nouveaux/mis à jour/supprimés) pour synchroniser votre base de données locale avec la source

3. Pour l'intégration front-end, utilisez /offers avec des filtres spécifiques et une pagination (marque, modèle, fourchette de prix, année, etc.)

GET/filters

Retourne toutes les valeurs possibles pour le filtrage

https://{access_name}.auto-api.com/api/v2/guazi/filters?api_key=YOUR_API_KEY

Réponse :

{
  "mark": {
    "BMW": { "model": ["X5", "X3"] },
    "Audi": { "model": ["A4", "Q7"] }
  },
  "transmission_type": ["MT", "AT"],
  "color": ["Green", "Purple", "Red", "White", "Champagne", "Silver", "Black", "Gray", "Blue", "Yellow"],
  "rudder": ["Left"],
  "body_type": ["Sedan", "Station Wagon", "SUV", "Convertible", "Bus", "Sports Car", "Hatchback", "Pick Up", "Crossover", "Truck"],
  "engine_type": ["Diesel", "PHEV", "HEV", "Gasoline", "BEV", "REEV"],
  "drive_type": ["4WD", "2WD"]
}

GET/offers

Liste des annonces avec pagination et filtres

Paramètres :

page (requis) - numéro de page
mark, model, transmission_type, color, rudder, body_type, engine_type, drive_type - filtres (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 CNY)

https://{access_name}.auto-api.com/api/v2/guazi/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/guazi/offers?api_key=YOUR_API_KEY&page=1&mark=BMW&color=black

Réponse :

{
  "result": [
    {
      "id": 3847521,
      "inner_id": "152471636",
      "change_type": "added",
      "created_at": "2025-10-28T14:28:35.620Z",
      "data": {
        "id": 5269,
        "inner_id": "152471636",
        "url": "https://www.guazi.com/binzhou/auto/152471636.htm",
        "title": "Haval H2 2016 1.5T AT",
        "mark": "Haval",
        "model": "H2",
        "full_model": "H2 1.5T Automatic Elite",
        "transmission_type": "AT",
        "year": 2016,
        "km_age": 112700,
        "price": 5011,
        "color": "Black",
        "displacement": 1.5,
        "doors_count": 5,
        "region": "China",
        "city": "Binzhou",
        "address": "Binzhou, Shandong",
        "section": "used",
        "rudder": "Left",
        "body_type": "SUV",
        "engine_type": "Gasoline",
        "equipment": ["Heated Seats", "Keyless Entry", "Backup Camera"],
        "images": ["https://global-image-pub.guazistatic.com/qnbdp7206x..."],
        "extra": {"inspection_score": 85},
        "drive_type": "2WD",
        "productionYearMonth": "2016-03",
        "licenseDate": "2016-05-20"
      }
    }
  ],
  "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
title - titre de l'annonce
mark - marque de voiture
model - modèle de voiture
full_model - nom complet du modèle
transmission_type - type de transmission (AT/MT)
year - année de production
km_age - kilométrage en km
price - prix en CNY
color - couleur
displacement - cylindrée du moteur

doors_count - nombre de portes
region - région
city - ville
address - adresse
section - section
rudder - position du volant (gauche/droite)
body_type - type de carrosserie
engine_type - type de moteur
equipment - liste d'équipements
images - tableau d'URLs d'images
drive_type - type de traction (FWD/RWD/AWD)
productionYearMonth - date de production (année-mois)
licenseDate - date d'immatriculation

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/guazi/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Réponse :

{ "change_id": 6718293 }

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/guazi/changes?api_key=YOUR_API_KEY&change_id=1

Réponse :

{
  "result": [
    {
      "id": 456,
      "inner_id": "152471636",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "152471637",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 4800 }
    },
    {
      "id": 458,
      "inner_id": "152471638",
      "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/guazi/offer?api_key=YOUR_API_KEY&inner_id=152471636

Réponse : objet data (identique à /offers, mais sans l'enveloppe result)

Exports quotidiens de données

Politique de conservation des données

Les fichiers sont conservés pendant plus de 3 jours.

Planning de disponibilité de l'API

Les fichiers quotidiens sont prêts à télécharger.

Format de données CSV

Les fichiers CSV utilisent la barre verticale (|) comme séparateur de colonnes.

Structure URL :

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

Paramètres de requête :

access_name - access_name - votre identifiant de sous-domaine attribué
date - date - date cible au format aaaa-mm-jj (ex. 2025-09-22)
file_name - 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'

Guazi.com

Guazi est la plus grande plateforme chinoise de voitures d'occasion certifiées. Fondée pour apporter de la transparence au marché de l'occasion, elle met en relation acheteurs et véhicules de qualité dans les grandes villes. Chaque voiture subit une inspection professionnelle en 259 points avant mise en ligne.

Chaque annonce présente des rapports d'inspection détaillés, l'historique complet des accidents, une photographie professionnelle et une tarification transparente. Le processus de certification Guazi garantit aux acheteurs des informations véhicule précises, incluant les problèmes cachés et l'historique des réparations.

La plateforme propose des options de financement, des garanties étendues et un service après-vente. Des filtres de recherche avancés aident les acheteurs à trouver des voitures par marque, modèle, année, gamme de prix, kilométrage et niveau de certification. Les mises à jour d'inventaire en temps réel maintiennent les annonces à jour.

Notre API fournit des données structurées du marketplace Guazi via des endpoints stables. Intégrez l'inventaire de voitures d'occasion certifiées dans vos applications pour analyses tarifaires, études de marché et gestion automatisée des stocks.

L'API temps réel fonctionne 24h/24 et 7j/7, détectant les nouvelles annonces certifiées en quelques minutes et suivant les véhicules vendus pour révéler les prix de transaction réels. Accédez aux données complètes d'inspection et de certification sans créer de scrapers personnalisés.

Autres données automobiles

Étendez votre accès aux données automobiles sur les marchés mondiaux avec nos API de plateforme complètes :

🇰🇷

Encar API

Korea données du marché automobile API

🇨🇳

Che168 API

China données automobiles API

🇨🇳

Dongchedi API

China données automobiles API

🇦🇪