What is Guazi API and how does it work?

Connect to China's largest used car marketplace through our API. Get organized car data via REST endpoints. Track certified used cars, pricing changes, and sold vehicles in real time.

What Guazi data does the API provide?

Complete vehicle details: make, model, price, mileage, certification status, inspection reports, accident history, and professional photos from all Guazi listings.

How often is Guazi data updated?

Continuous data flow. New used car listings detected within minutes. Daily files include all active certified vehicles and recently sold cars.

What formats does Guazi API support?

Multiple formats: REST API for real-time updates, JSON for structured data, CSV for analysis, and Excel for business reports. All formats include complete inspection and certification details.

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

Access certified used car data from China's largest platform via API. Includes 259-point inspection reports, accident history, and real-time inventory-no scrapers needed.

Guazi API

Access China's leading certified used car marketplace through our API. Retrieve clean data from Shanghai, Beijing, and major Chinese cities for market analysis and inventory management.

API

Receive instant alerts for new certified listings.

Daily Exports

Daily export of all active certified cars for market tracking.

Complete Data

Access comprehensive used car data: price, specs, inspection reports, certification status, accident history, warranty details from every listing.

Get API AccessAccess provided within 2 minutes

API

Base URL

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

Authorization: api_key parameter

Workflow

/filtersget available filter values

/offersget listings (with or without filters) - use for initial data load

For updates (to keep data up-to-date after initial load):

/change_id?date=...get starting ID for changes feed

/changes?change_id=...get all changes in the database starting from ID

/offerget details of a specific listing by inner_id

How to integrate effectively:

1. First, use /offers to retrieve the entire dataset (paginate through all results)

2. Then, periodically query /changes to get all updates (new/updated/removed records) to sync your local database with the source

3. For front-end integration, use /offers with specific filters and pagination (brand, model, price range, year, etc.)

GET/filters

Returns all possible values for filtering

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

Response:

{
  "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

List of listings with pagination and filters

Parameters:

page (required) - page number
mark, model, transmission_type, color, rudder, body_type, engine_type, drive_type - filters (case-insensitive)
year_from, year_to - year range filter
km_age_from, km_age_to - mileage range filter
price_from, price_to - price range filter (in 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

Response:

{
  "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 }
}

Data fields:

id - internal database ID
inner_id - listing ID on the platform
url - link to the listing
title - listing title
mark - car brand
model - car model
full_model - full model name
transmission_type - transmission type (AT/MT)
year - production year
km_age - mileage in km
price - price in CNY
color - color
displacement - engine displacement

doors_count - number of doors
region - region
city - city
address - address
section - section
rudder - steering wheel position (left/right)
body_type - body type
engine_type - engine type
equipment - equipment list
images - array of image URLs
drive_type - drive type (FWD/RWD/AWD)
productionYearMonth - production date (year-month)
licenseDate - registration date

GET/change_id

Get first change ID by date (for use in /changes)

Parameters:

date (required) - date in yyyy-mm-dd format

https://{access_name}.auto-api.com/api/v2/guazi/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Response:

{ "change_id": 6718293 }

Use the returned value as the change_id parameter in /changes

GET/changes

Changes feed (added/changed/removed)

Parameters:

change_id (required) - starting from which change ID

https://{access_name}.auto-api.com/api/v2/guazi/changes?api_key=YOUR_API_KEY&change_id=1

Response:

{
  "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

Single listing by inner_id

Parameters:

inner_id (required)

https://{access_name}.auto-api.com/api/v2/guazi/offer?api_key=YOUR_API_KEY&inner_id=152471636

Response: data object (same as in /offers, but without result wrapper)

Daily Exports

Data Storage Protocol

Files are stored for 3+ days.

API Delivery Schedule

Daily files are ready for download.

CSV File Configuration

CSV files use pipe (|) as column separator.

URL Structure:

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

Request Parameters:

access_name - access_name - your assigned subdomain identifier
date - date - target date in yyyy-mm-dd format (e.g., 2025-09-22)
file_name - file_name - export file name with extension

Available Formats:

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

cURL API Request Example

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

Wget Download Command

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

Guazi.com

Guazi is China's largest certified used car platform. Founded to bring transparency to the used car market, it connects buyers with quality pre-owned vehicles across major cities. Each car undergoes a 259-point professional inspection before listing.

Every listing features detailed inspection reports, complete accident history, professional photography, and transparent pricing. Guazi's certification process ensures buyers get accurate vehicle information, including hidden issues and repair history.

The platform offers financing options, extended warranties, and after-sales support. Advanced search filters help buyers find cars by brand, model, year, price range, mileage, and certification level. Real-time inventory updates keep listings current.

Our API delivers structured data from Guazi's marketplace through stable endpoints. Integrate certified used car inventory into your applications for pricing analysis, market research, and automated inventory management.

The real-time API operates 24/7. It detects new listings within minutes and tracks sold vehicles to reveal actual transaction prices. Access complete inspection and certification data without building custom scrapers.

Other Automotive Data

Expand your automotive data coverage across global markets with our platform APIs:

🇰🇷

Encar API

Korea car market data API

🇨🇳

Che168 API

China automotive data API

🇨🇳

Dongchedi API

China automotive data API

🇦🇪