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.

Guazi API
Car Scraper & Parser

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

Trusted used car data with comprehensive export options.

Guazi Used Car Platform 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.

Live API

Get instant alerts for new certified used car listings.

Advantage: Catch fresh inventory as it becomes available.

Data Parser

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

Daily Exports

Active Listings: Daily export of all active certified cars for market tracking.

Sold Vehicles: Daily report of sold cars with final transaction prices.

Get API Access

* Access provided within 2 minutes

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, detecting new certified listings within minutes and tracking sold vehicles to reveal actual transaction prices. Access complete inspection and certification data without building custom scrapers.

Data We Collect

inner_id: 152471636
mark: Haval
model: H2
year: 2016
color: Black
body_type: SUV
price: 5011 (USD)

km_age: 112700
section: used
displacement: 1.5
transmission_type: AT
engine_type: Gasoline
rudder: Left
doors_count: 5

city: Binzhou
region: China
address: Binzhou,China
equipment: Array
images: Array

Daily Exports for Guazi.com

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://{personal_name}.auto-api.com/{date}/{file_name}

Request Parameters:

personal_name - your assigned subdomain identifier
date - target date in yyyy-mm-dd format (e.g., 2025-09-22)
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://{personal_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://{personal_name}.auto-api.com/yyyy-mm-dd/all_active.csv'

Real-Time API

Request Parameters

api_key - your personal API key

from_id - start from this change ID. Use 0 for first request, then last ID + 1

Response Parameters

inner_id - listing ID on guazi.com

change_type - event type: "added", "changed" or "removed"

created_at - event timestamp

data - vehicle information with all Guazi fields including certification data

Response Body

{
  "result": [
    {
      "id": 3847521,
      "inner_id": "152471636",
      "change_type": "added",
      "created_at": "2025-10-28T14:28:35.620",
      "data": {
        "id": 5269,
        "inner_id": "152471636",
        "mark": "Haval",
        "model": "H2",
        "year": 2016,
        "price": 5011,
        "km_age": 112700,
        "color": "Black",
        "body_type": "SUV",
        "section": "used",
        "displacement": "1.5",
        "transmission_type": "AT",
        "engine_type": "Gasoline",
        "rudder": "Left",
        "doors_count": 5,
        "address": "Binzhou,China",
        "city": "Binzhou",
        "region": "China",
        "equipment": [
          "Heated Seats",
          "Keyless Entry",
          "Rain-Sensing Wipers",
          "Backup Camera",
          "Automatic Headlights"
        ],
        "images": [
          "https://global-image-pub.guazistatic.com/qnbdp7206xd5e3263e0eec4abcacba415304a91f491747902556.jpg",
          "https://global-image-pub.guazistatic.com/qnbdp7206x44aecf51376a4a55a0a5a911c368ee0c1747902573.jpg"
        ]
      }
    },
    {
      "id": 3865294,
      "inner_id": "152471637",
      "change_type": "changed",
      "created_at": "2025-10-28T09:42:18.125",
      "data": {
        "new_price": 4850
      }
    },
    {
      "id": 3865295,
      "inner_id": "152471638",
      "change_type": "removed",
      "created_at": "2025-10-28T09:42:23.891"
    }
  ],
  "meta": {
    "cur_from_id": "3847519",
    "limit": 10
  }
}