Che168 APIScraper & Parser
Access vehicle data from China auto platform. VIN numbers, inspection reports, service history. Real-time monitoring of listing updates.
Che168 API
Get Chinese car data directly via API. Direct access to vehicle information without building scrapers. Ideal for market research, price analysis, and business intelligence.
Get alerts when new cars appear on Che168. Track listings the moment they go live.
Daily files with all current listings and pricing data.
Get formatted data through the API: Price, Mileage, Year, Make, Model, Technical Specs, Inspection Reports, Service History, and Vehicle Condition.
A listing comes with the version specs, equipment and che168's price assessment.
Base URL
https://{access_name}.auto-api.com/api/v3/che168Authorization: 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-07-23T09:11:56Z". Dates look like "2026-07-23", months like "2022-11".
- All amounts are in CNY.
- Every listing has the same keys. If a block such as the che168 assessment has no data, it is null.
GET/filters
Returns all possible values for filtering
https://{access_name}.auto-api.com/api/v3/che168/filters?api_key=YOUR_API_KEYResponse:
{
"mark": {
"BYD": { "model": ["D1", "Datang", "Destroyer 05", "Dolphin", ...] },
"Geely": { "model": ["Binrui", "Binyue", "Binyue NEV", "Borui", ...] },
...
},
"transmission_type": ["Automatic", "Manual"],
"color": ["Black", "Blue", "Brown", "Champagne", ...],
"body_type": ["Coupe/roadster", "Crossover/SUV", "Hatchback", "Light truck", ...],
"engine_type": ["Diesel", "Diesel and 48V mild hybrid", "Electric", "Gasoline", ...],
"drive_type": ["AWD", "FWD", "RWD"]
}GET/offers
Listings page by page. Filters narrow down the results.
Parameters:
page(required) - page numbermark, model- brand and model names as in /filterstransmission_type, color, body_type, engine_type, drive_type- transmission, color, body, fuel and drive values, case does not matteryear_from, year_to- first registration year from and tokm_age_from, km_age_to- mileage in km from and toprice_from, price_to- price in yuan from and to
To pass several values to a filter, repeat the parameter with brackets: mark[]=Zeekr&mark[]=Li Auto
https://{access_name}.auto-api.com/api/v3/che168/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/che168/offers?api_key=YOUR_API_KEY&page=1&mark=Zeekr&model=001&year_from=2022https://{access_name}.auto-api.com/api/v3/che168/offers?api_key=YOUR_API_KEY&page=1&mark[]=Zeekr&mark[]=Li Auto&color[]=Black&color[]=White&price_to=200000Response:
{
"result": [
{
"id": 386145,
"inner_id": "59128731",
"change_type": "added",
"created_at": "2026-07-23T09:11:56Z",
"data": {
"id": 386145,
"inner_id": "59128731",
"url": "https://www.che168.com/dealer/553333/59128731.html",
"mark": "Zeekr",
"model": "001",
"manufacturer": "Zeekr",
"complectation": "Zeekr 001 2022 Ultra Long Range Dual Motor YOU Edition",
"configuration": "Ultra Long Range Dual Motor YOU Edition",
"year": 2022,
"model_year": 2022,
"first_registration": "2022-11",
"first_registration_date": null,
"notice": null,
"km_age": 40000,
"owners_count": 1,
"price": 147800,
"currency": "CNY",
"engine_type": "Electric",
"transmission_type": "Automatic",
"gearbox_type": "Single-speed transmission",
"gears_count": 1,
"body_type": "Sedan",
"body_style": "Liftback",
"vehicle_class": "Mid-to-large car",
"drive_type": "AWD",
"color": "Black",
"displacement": null,
"displacement_cc": null,
"engine_model": null,
"power": 544,
"power_ice_hp": null,
"power_ice_kw": null,
"power_ice_net_kw": null,
"power_hybrid_hp": null,
"power_hybrid_kw": null,
"power_electro_hp": 544,
"power_electro_kw": 400,
"power_electro_front_kw": 200,
"power_electro_rear_kw": 200,
"battery_capacity_kwh": 100,
"battery_type": "Ternary lithium (NCM)",
"battery_ownership": null,
"electric_range_km": 650,
"seat_count": 5,
"emission_standard": null,
"inspection_valid_until": "2026-11",
"insurance_valid_until": "2026-11",
"vin": "L6T79T2E9NP044514",
"section": "Used",
"seller_type": "Dealer",
"is_dealer": true,
"salon_id": "553333",
"city": "Wenzhou",
"region": "Zhejiang",
"address": "温州, 鹿城",
"description": "买下！22年极氪001 you版 外...",
"offer_created": "2026-07-23",
"created_at": "2026-07-23T09:11:56Z",
"photos": [
"https://2sc2.autoimg.cn/escimg/auto/g34/M01/3B/EA/1024x768_c42_autohomecar__ChxpV2phvoOAGc3tAAkCio7thK8295.jpg.webp",
"https://2sc2.autoimg.cn/escimg/auto/g34/M0A/3B/F4/1024x768_c42_autohomecar__ChxpWGphvoSAWFpXAAjAIgYkTOI530.jpg.webp",
"https://2sc2.autoimg.cn/escimg/auto/g34/M0B/3B/EA/1024x768_c42_autohomecar__ChxpV2phvoWAWYoAAAjG12GxZEE037.jpg.webp",
"https://2sc2.autoimg.cn/escimg/auto/g34/M00/3B/F4/1024x768_c42_autohomecar__ChxpWGphvoWAPqRMAAiq5qqYaGs574.jpg.webp",
...
],
"video_url": "https://2sc.autohome.com.cn/video/m.html?infoid=59128731",
"inspection_report_url": null,
"original": { // original values from che168.com
"mark": "极氪",
"model": "极氪001",
"complectation": "极氪001 2022款 超长续航双电机 YOU版",
"color": "黑色",
"engine_type": "纯电动",
"transmission_type": "自动",
"body_type": "中大型车",
"drive_type": "双电机四驱",
"emission_standard": null,
"city": "温州"
},
"catalog_ids": {
"mark": "456",
"model": "6091",
"complectation": "58175"
},
"options": {
"Safety": ["ISOFIX child seat anchors", "Autonomous emergency braking", "Blind spot monitoring", "Lane keeping assist", ...],
"Driver assistance": ["Auto hold"],
"Exterior and access": ["Keyless start", "Power tailgate", "Hands-free tailgate", "Active grille shutters"],
"Interior": ["Digital instrument cluster", "Head-up display", "Heated steering wheel", "Built-in dashcam"],
"Multimedia and connectivity": ["Bluetooth and hands-free calling", "Connected services", "Over-the-air updates"],
"Climate": ["Rear air vents", "Rear climate control", "PM2.5 cabin filter"],
"Lighting": ["Automatic high beam"]
},
"specs": {
"Basic parameters": {
"Trim name": "Zeekr 001 2022 Ultra Long Range Dual Motor YOU Edition",
"MSRP (CNY)": "386000",
"Manufacturer": "Zeekr",
"Class": "Mid-to-large car",
"Fuel type": "Electric",
"Launch date": "2022-07",
...
},
"Body": {
"Length (mm)": "4970",
"Width (mm)": "1999",
"Height (mm)": "1548",
"Wheelbase (mm)": "3005",
"Front track (mm)": "1713",
...
},
"Electric motor": {
"Motor type": "Permanent magnet synchronous",
"Total electric motor power (kW)": "400",
"Total electric motor torque (N·m)": "768",
"Front motor max power (kW)": "200",
"Front motor max torque (N·m)": "384",
...
},
...
},
"assessment": {
"score": 86,
"score_age": 42,
"score_mileage": 66,
"score_popularity": 62,
"ownership_changes_level": "Very few",
"mileage_level": "Very low",
"age_level": "Average",
"value_retention_3y_percent": 66,
"reference_price_from": 130000,
"reference_price_to": 160000,
"price_verdict": "Reasonable price",
"price_below_average": null,
"price_vs_similar": "In line with average",
"resale_price": 120000,
"resale_after_years": 2,
"resale_discount_percent": 13.5
}
}
}
],
"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 yuan, currency is always CNY.
notice - A warning from che168, for example that the car is being prepared for sale.
section - "Used" or "New".
description - description
offer_created - The day the listing was published.
created_at - Time the listing reached our database.
Car
mark, model - Brand and model.
manufacturer - Manufacturer. It can be a local joint venture such as "BMW Brilliance", or "BMW (imported)" for imported cars.
complectation - Full version name.
configuration - Version (brand, model and year are not included).
year - First registration year.
model_year - Model year.
first_registration, first_registration_date - First registration: month and, for some listings, the exact date.
km_age - mileage in km
owners_count - How many owners there were. 0 if the car was never registered.
vin - 17-character VIN, not given in every listing.
inspection_valid_until, insurance_valid_until - Month the periodic roadworthiness inspection expires and month the compulsory insurance expires.
Specifications
engine_type - Engine type.
transmission_type - "Automatic" or "Manual".
gearbox_type, gears_count - Gearbox design and number of gears.
body_type, body_style - Body type in general terms and more precisely, for example "Crossover/SUV" and "SUV".
vehicle_class - Size class, for example "Mid-to-large SUV".
drive_type - Drive: "FWD", "RWD" or "AWD".
color - Body color.
displacement, displacement_cc - Engine displacement in liters and in cubic centimeters.
engine_model - Engine code.
power - Total power, hp.
power_ice_hp, power_ice_kw - Combustion engine: hp and kW.
power_ice_net_kw - Net combustion engine power, kW.
power_hybrid_hp, power_hybrid_kw - Power of the whole hybrid system: hp and kW.
power_electro_hp, power_electro_kw - All electric motors combined: hp and kW.
power_electro_front_kw, power_electro_rear_kw - Front and rear electric motor separately, kW.
battery_capacity_kwh, battery_type - Battery capacity in kWh and its chemistry, for example "Lithium iron phosphate (LFP)".
battery_ownership - "Owned" or "Leased".
electric_range_km - Range on electricity alone, km.
seat_count - Number of seats.
emission_standard - Emission standard, for example "China VI".
Seller
seller_type, is_dealer - "Dealer" or "Private seller", is_dealer repeats this as true/false.
salon_id - Dealer ID on che168.
city, region - The seller's city and the province it belongs to.
address - The dealer's city and district.
Photos, equipment and reference data
photos - array of image URLs
video_url - Video shot by the seller. Not always present.
inspection_report_url - Inspection report posted by the seller. Not every listing has one.
options - Equipment by group "Safety", "Driver assistance", "Exterior and access", "Interior", "Multimedia and connectivity", "Climate", "Lighting", "Glass".
specs - Version specs by section "Basic parameters", "Body", "Engine", "Electric motor", "Transmission", "Chassis and steering", "Wheels and brakes", values as strings.
original - Original names and values from che168.com.
catalog_ids - Brand, model and version codes in the che168.com catalog.
che168 assessment (assessment)
How che168 rates the car and its price. Not every listing has it. Without a rating, assessment is null.
score - Overall score.
score_age, score_mileage, score_popularity - Parts of the score: age, mileage, model popularity.
ownership_changes_level - How often the owner changed: "Very few", "Few", "Quite a few", "Many".
mileage_level - Mileage label: "Very low" or "Low".
age_level - Age label: "Low", "Average", "High".
value_retention_3y_percent - che168's forecast: what percentage of the price remains after three years.
reference_price_from, reference_price_to - The price range che168 considers normal.
price_verdict - che168's opinion of the price, for example "Reasonable price".
price_below_average - How much the price is below average, if che168 says so.
price_vs_similar - Comparison with similar listings: "In line with average" or "Below average".
resale_price, resale_after_years, resale_discount_percent - che168's resale forecast: expected price, term in years (resale_after_years) and loss in percent.
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/che168/change_id?api_key=YOUR_API_KEY&date=2026-10-22Response:
{
"change_id": 85236
}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/che168/changes?api_key=YOUR_API_KEY&change_id=85240Response:
{
"result": [
{
"id": 85241,
"inner_id": "60271904",
"change_type": "removed",
"created_at": "2026-10-22T06:12:40Z",
"data": {} // removed from sale
},
{
"id": 85247,
"inner_id": "59873316",
"change_type": "changed",
"created_at": "2026-10-22T06:29:03Z",
"data": { // the price changed, the new one in CNY
"new_price": 92800
}
},
{
"id": 85252,
"inner_id": "60288471",
"change_type": "added",
"created_at": "2026-10-22T06:45:58Z",
"data": { ... } // the full listing body
}
// ... then the other events, up to 20 per page
],
"meta": {
"cur_change_id": 85240,
"next_change_id": 85260,
"limit": 20
}
}GET/offer
Single listing by inner_id
Parameters:
inner_id(required)
https://{access_name}.auto-api.com/api/v3/che168/offer?api_key=YOUR_API_KEY&inner_id=59128731The 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
Retrieve complete listing data by providing the che168.com URL
Base URL
https://{access_name}.auto-api.com/api/v1/offer/infoAuthorization: header x-api-key
POST/api/v1/offer/info
Get listing data from che168.com by URL
Parameters:
url(required) - link to the listing on che168.com
Request Example:
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": "https://www.che168.com/dealer/413863/56520004.html" }'Response:
{
"inner_id": "56520004",
"url": "https://www.che168.com/dealer/413863/56520004.html",
"mark": "Ora",
"model": "Black Cat",
"year": 2020,
"color": "White",
"price": 31800,
"km_age": 54000,
"engine_type": "Electric",
"transmission_type": "Automatic",
"body_type": "Mini",
"drive_type": "FWD",
"displacement": "0",
"vin": "LGWECMA47LE008164",
"city": "Shenzhen",
"seller_type": "dealer",
"is_dealer": true,
"offer_created": "2025-12-04",
"images": [
"https://2sc2.autoimg.cn/escimg/auto/g33/M0B/AE/D7/1024x768_c42_autohomecar__ChxpVWj8TteALlI3AAnIctts-w8397.jpg.webp",
"https://2sc2.autoimg.cn/escimg/auto/g34/M0B/A3/C5/1024x768_c42_autohomecar__ChxpWGj8TtiAJ0EJAAq9t0PZjQc486.jpg.webp"
],
"power": 61,
"first_registration": "2020-09"
}Field Descriptions:
- inner_id - listing ID on che168.com
- url - link to the listing
- mark - car brand
- model - car model
- year - production year
- color - vehicle color
- price - price in CNY
- km_age - mileage in kilometers
- engine_type - engine/fuel type
- transmission_type - transmission type
- body_type - body type
- drive_type - drive type (FWD, RWD, AWD)
- displacement - engine displacement
- vin - vehicle identification number
- city - seller city
- seller_type - seller type
- is_dealer - dealer flag
- offer_created - listing creation date
- images - array of image URLs
- power - engine power in horsepower (hp)
- first_registration - first registration date (YYYY-MM)
File Storage
Files stored for 3 days minimum
Update Schedule
Fresh data files generated daily and available for download
File Format
CSV files use pipe symbol (|) to separate columns
URL Structure:
Request Parameters:
access_name- your assigned subdomain identifierdate- target date in yyyy-mm-dd format (e.g., 2025-09-06)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'Che168.com listings feature full vehicle data including specifications, pricing, seller information, and location details. This data reveals market trends, pricing patterns, and buyer behavior across China's automotive market.
Vehicle histories, inspection reports, and financing data from the platform provide valuable insights. Companies use this data for inventory planning, pricing decisions, and market strategy.
Market research teams, automotive app developers, and analysts use this data through our Che168 API. Direct data access means no scraper development or maintenance work.
Che168 API runs continuously, detecting new listings within minutes and monitoring price changes for real-time market data. All automotive information is available through structured API endpoints.
Expand your automotive data coverage across global markets with our platform APIs: