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.
Receive instant alerts for new certified listings.
Daily export of all active certified cars for market tracking.
Access comprehensive used car data: price, specs, inspection reports, certification status, accident history, warranty details from every listing.
A listing comes with prices by shipping port, the Guazi inspection results, version specs and equipment.
Base URL
https://{access_name}.auto-api.com/api/v3/guaziAuthorization: api_key parameter
Workflow
/filtersget available filter valuesInitial load:
/change_id?date=...get starting ID for changes feed/offersfetch all listings page by page/changes?change_id=...get all changes in the database starting from ID/offerget details of a specific listing by inner_idGetting started:
1. Before the first load, take the number from /change_id for today's date and keep it. Then go through /offers page by page to the end: on the last page next_page is null.
2. After that, poll /changes from this number and pass next_change_id from each response. New listings, new prices and removals from sale come this way. If next_change_id is null, there are no events yet: repeat the same request later.
3. To search by your own criteria, request /offers with filters.
Data format
- Types are kept: a number comes as a number, a list as an array, a missing value as null.
- Timestamps are in UTC, for example "2026-10-22T14:25:09Z". Dates look like "2024-07-15", months like "2024-06".
- All amounts are in USD.
- Every listing has the same keys. If a block such as the Guazi inspection has no data, it is null.
GET/filters
Returns all possible values for filtering
https://{access_name}.auto-api.com/api/v3/guazi/filters?api_key=YOUR_API_KEYResponse:
{
"mark": {
"Hima": { "model": ["AITO M5", "AITO M6", "AITO M7", "AITO M8", "AITO M9", ...] },
"Li Auto": { "model": ["i6", "i8", "L6", "L7", "L8", ...] },
"Zeekr": { "model": ["001", "001FR", "007", "007GT", "009", ...] },
...
},
"transmission_type": ["Automatic", "Manual"],
"color": ["Black", "Blue", "Brown", "Champagne", ...],
"body_type": ["Convertible", "Hatchback", "Minivan", "Pickup", ...],
"engine_type": [..., "Hybrid", "Plug-in hybrid (PHEV)", "Range extender (EREV)"],
"drive_type": ["2WD", "4WD", "AWD", ..., "FWD", ..., "RWD"]
}GET/offers
Listings page by page. Filters narrow down the results.
Parameters:
page(required) - page numbermark, model- brand and model exactly as in /filterstransmission_type, color, body_type, engine_type, drive_type- transmission, color, body, fuel and drive, using the values from /filters, case does not matteryear_from, year_to- production year from and tokm_age_from, km_age_to- mileage in km from and toprice_from, price_to- price in US dollars from and to
To pass several values to a filter, repeat the parameter with brackets: mark[]=Li Auto&mark[]=Hima
https://{access_name}.auto-api.com/api/v3/guazi/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/guazi/offers?api_key=YOUR_API_KEY&page=1&mark=Hima&model=AITO M9&year_from=2024https://{access_name}.auto-api.com/api/v3/guazi/offers?api_key=YOUR_API_KEY&page=1&mark[]=Li Auto&mark[]=Hima&engine_type=Range extender (EREV)&price_to=45000Response:
{
"result": [
{
"id": 274913,
"inner_id": "aq3kg9gkg8",
"change_type": "added",
"created_at": "2026-10-22T14:25:09Z",
"data": {
"id": 274913,
"inner_id": "aq3kg9gkg8",
"url": "https://en.guazi.com/products/hima-aito-m9-2024-15l-black-52300km-at-4wd-6-seats-aq3kg9gkg8.html",
"mark": "Hima",
"model": "AITO M9",
"complectation": "Hima AITO M9 2024 Range-Extended Max Edition 42 kWh 6-Seater Version",
"configuration": "Range-Extended Max Edition 42 kWh 6-Seater Version",
"year": 2024,
"model_year": 2024,
"year_month": "2024-06",
"first_registration": "2024-07",
"first_registration_date": "2024-07-15",
"km_age": 52300,
"owners_count": null,
"price": 42313,
"currency": "USD",
"port_prices": {
"Shanghai": 42313,
"Ningbo": 42328,
"Guangzhou": 42276,
"Shenzhen": 42306,
"Horgos": 42178,
"Suifenhe": 41848
},
"engine_type": "Range extender (EREV)",
"transmission_type": "Automatic",
"body_type": "SUV",
"drive_type": "AWD",
"color": "Black",
"doors_count": 5,
"displacement": 1.5,
"displacement_cc": null,
"engine_model": "H15RT",
"power": 496,
"power_ice_hp": 152,
"power_ice_kw": 112,
"power_electro_kw": 365,
"power_electro_rear_kw": 200,
"battery_capacity_kwh": 42,
"battery_type": "Nickel cobalt manganese (NCM)",
"battery_soh_percent": null,
"electric_range_km": 225,
"seat_count": 6,
"section": "Used",
"seller_type": "Private seller",
"is_dealer": false,
"salon_id": null,
"city": "Quanzhou",
"region": "Fujian",
"address": "Quanzhou,China",
"description": null,
"created_at": "2026-10-22T14:25:09Z",
"photos": [
"https://global-image-pub.guazistatic-global.com/qnbdp7206xeeda47ed7325479e90a82d3248206dce1783849682.jpg",
"https://global-image-pub.guazistatic-global.com/qnbdp7206x485fb37f388f4c4184630c17600dcbf31783849695.jpg",
"https://global-image-pub.guazistatic-global.com/qnbdp7206xee9b0a79ac6f422b97f4ba9cec0968941783849708.jpg",
"https://global-image-pub.guazistatic-global.com/qnbdp7206xc60477222d5d44b8a2c4d30793825f351783849724.jpg",
...
],
"photo_details": [
...
{
"type": "Details",
"view": "Engine bay",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7206xe821e4c6eeca4f62b3f868f0ec0dc3d31783849220.jpg"
},
{
"type": "Details",
"view": "Engine bay, left",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x75b5adbe179a4f6d87d9a126bf89578c1783846837.jpg"
},
{
"type": "Details",
"view": "Engine bay, right",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x424e29bdeb3b4ea6bb648211910074931783846835.jpg"
},
{
"type": "Details",
"view": "Underbody, front",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964xaab7b843de664b1fb7a1afaa27bfca2a1783846744.jpg"
},
...
],
"highlights": [..., "Tire pressure monitoring", "Heated mirrors", "Hill start assist", "Rear parking sensors", "Anti-pinch windows"],
"inspection": {
"grade": "A",
"accident_damage": false,
"water_damage": false,
"fire_damage": false,
"checks": {
"Exterior": { "normal": 97, "issues": 15 },
"Interior": { "normal": 43, "issues": 0 },
"Equipment": { "normal": 53, "issues": 0 },
"Structural parts": { "normal": 30, "issues": 0 },
"Reinforcement parts": { "normal": 15, "issues": 0 },
"Cockpit": { "normal": 18, "issues": 0 },
"Electric system": { "normal": 10, "issues": 1 }
},
"condition_videos": [
{
"type": "Engine start",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x806ac68bf22044a18492e05c07b242431783849034.mp4"
},
{
"type": "Engine bay",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x2769a6d3cb6441b0a098f402bc1df6bb1783849052.mp4"
},
{
"type": "Exhaust",
"url": "https://global-image-pub.guazistatic-global.com/qnbdp7964x6591a557d2354588b921940385f204df1783849072.mp4"
}
],
"part_videos": []
},
"original": { // original values from guazi.com
"mark": "Hima",
"model": "AITO M9",
"complectation": "Hima AITO M9 2024 Range-Extended Max Edition 42 kWh 6-Seater Version",
"engine_type": "REEV",
"transmission_type": "AT",
"body_type": "SUV",
"drive_type": "Dual Motor AWD",
"color": "Black",
"city": "Quanzhou"
},
"catalog_ids": {
"mark": "103950",
"model": "163411",
"complectation": "229576"
},
"options": {
"Safety": [..., "Brake force distribution (EBD/CBC)", "Brake assist (EBA/BAS/BA)", "Traction control (ASR/TCS/TRC)", "Stability control (ESC/ESP/DSC)"],
"Driver assistance": [..., "Air suspension", "Auto hold", "Hill start assist", "Traffic sign recognition"],
"Exterior and access": [..., "Central locking", "Remote key", "Keyless start", "Keyless entry"],
"Interior": [..., "Steering wheel memory", "Trip computer display", "Digital instrument cluster", "Over-the-air updates"],
"Seats": [..., "Second row seat sliding", "Seat memory", "Passenger seat adjustment from rear", "Rear cup holders"],
"Multimedia": ["Center console color display", "Smartphone integration", "Connected car services"],
"Lighting": [..., "Automatic high beam", "Automatic headlights", "Cornering lights", "Headlight leveling"],
"Windows and mirrors": [..., "Mirror memory", "Vanity mirror", "Rear wiper", "Rain-sensing wipers"]
},
"specs": {
"Engine": {
...
"Maximum power (hp)": "152.32",
"Maximum power (kW)": "112",
"Maximum torque (N·m)": "205"
},
"Electric motor": {
...
"Battery capacity (kWh)": "42",
"Battery type": "Nickel cobalt manganese (NCM)",
"Slow charging time (h)": "5",
"WLTC combined range (km)": "1210",
"CLTC electric range (km)": "225",
...
},
...
"Multimedia": {
"Center console color display": "Yes",
"Smartphone integration": "Yes",
"Connected car services": "Yes",
"Media ports": "USB+SD+Type-C"
},
...
}
}
}
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Data fields:
Listing
id - internal database ID
inner_id - listing ID on the platform
url - link to the listing
price, currency - Price in US dollars, currency is always USD.
port_prices - Prices in US dollars by shipping port: Shanghai, Ningbo, Guangzhou, Shenzhen, Horgos, Suifenhe. The Shanghai price is the same as the price field. If there are no port prices, port_prices is null.
section - "Used" or "New".
description - Seller's description. Guazi does not publish it, so it is always null.
created_at - Time the listing reached our database.
Car
mark, model - Brand and model.
complectation - Full version name as in the listing.
configuration - Version (brand, model and year are not included).
year - Production year.
model_year - Model year.
year_month - Production month.
first_registration, first_registration_date - First registration: month and exact date.
km_age - mileage in km
owners_count - Number of owners. Guazi does not publish it, so it is always null.
Specifications
engine_type - Engine type.
transmission_type - "Automatic" or "Manual".
body_type - Body type, for example "SUV" or "Minivan".
drive_type - Drive type. Most often "FWD", "RWD" or "AWD".
color - Body color.
doors_count - Number of doors.
displacement, displacement_cc - Engine displacement in liters. Guazi does not publish it in cubic centimeters, so displacement_cc is always null.
engine_model - Engine code.
power - Total power, hp.
power_ice_hp, power_ice_kw - Combustion engine: hp and kW.
power_electro_kw - All electric motors together, kW.
power_electro_rear_kw - Rear electric motor, kW.
battery_capacity_kwh, battery_type - Battery capacity in kWh and its chemistry, for example "Lithium iron phosphate (LFP)".
battery_soh_percent - Remaining battery capacity in percent of the original. Not given for every electric car or hybrid.
electric_range_km - Electric range under the CLTC cycle, km.
seat_count - Number of seats.
Seller
seller_type, is_dealer - "Dealer", "Private seller" or "Guazi". "Guazi" marks cars that Guazi sells on its own behalf. is_dealer is true for a dealer and for Guazi.
salon_id - Dealer ID. Guazi does not publish it, so it is always null.
city, region - Seller's city and province.
address - City and country, for example "Quanzhou,China".
Photos, equipment and reference data
photos - array of image URLs
photo_details - The same photos with labels: the gallery category "Exterior", "Interior" or "Details" (type) and the shooting angle, for example "Front left 45°" (view). If the angle is not labeled, view is null.
highlights - Key equipment highlighted in the listing, for example "Surround view cameras".
options - Equipment by group: "Safety", "Driver assistance", "Exterior and access", "Interior", "Seats", "Multimedia", "Lighting", "Windows and mirrors". The mark "(optional)" means the item is not standard on this version.
specs - Version specs by section: "Engine", "Electric motor", "Body" and the same equipment groups as in the options field. Values are strings. In the equipment groups they are most often "Yes", "No" or "Optional".
original - Original names and values from guazi.com.
catalog_ids - Brand, model and version codes in the guazi.com catalog.
Guazi inspection (inspection)
Results of the inspection done by Guazi. If the car was not inspected, the inspection block is null.
grade - Inspection grade, from S (best) to D.
accident_damage, water_damage, fire_damage - Whether accident, flood or fire damage was found (true/false).
checks - For each category, how many checked items are fine (normal) and how many have issues (issues).
condition_videos - Videos of the car's condition: what was filmed (type), for example "Engine start" or "Exhaust", and the video link (url).
part_videos - Inspection videos of specific body and interior areas: the area (part), the finding (result), for example "Normal" or "Minor scratches", the inspector's comment (note) and the video link (url).
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/v3/guazi/change_id?api_key=YOUR_API_KEY&date=2026-10-22Response:
{
"change_id": 517630
}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/v3/guazi/changes?api_key=YOUR_API_KEY&change_id=517640Response:
{
"result": [
{
"id": 517640,
"inner_id": "xw3guery8m",
"change_type": "changed",
"created_at": "2026-10-22T10:07:21Z",
"data": { // the price changed, the new one in USD
"new_price": 9808
}
},
{
"id": 517647,
"inner_id": "magfq94j7n",
"change_type": "added",
"created_at": "2026-10-22T10:26:48Z",
"data": { ... } // the full listing body
},
{
"id": 517653,
"inner_id": "cdk64uu5z7",
"change_type": "removed",
"created_at": "2026-10-22T10:41:13Z",
"data": {} // removed from sale
}
// ... then the other events, up to 20 per page
],
"meta": {
"cur_change_id": 517640,
"next_change_id": 517660,
"limit": 20
}
}GET/offer
Single listing by inner_id
Parameters:
inner_id(required)
https://{access_name}.auto-api.com/api/v3/guazi/offer?api_key=YOUR_API_KEY&inner_id=aq3kg9gkg8The response holds only the data object, without a result wrapper.
Errors
On an error, the response has an error field with a description: { "error": "parameter page is required" }
401- the api_key was not accepted400- a required parameter is missing or a value has the wrong format404- no listing with this inner_id (/offer)429- the request limit is used up
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:
Request Parameters:
access_name- your assigned subdomain identifierdate- 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://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvWget Download Command
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'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.
Expand your automotive data coverage across global markets with our platform APIs: