Dongchedi APIScraper & Parser
Dongchedi API: used car listings in China with price, mileage, specifications and photos. REST API and daily exports.
Dongchedi API
Access China's largest car marketplace through our API. Retrieve clean vehicle data from across China for analytics and market research.
Receive instant alerts for new Chinese vehicle listings.
Daily export of all active ads for market analysis.
Access all car data through the API: price, specs, diagnostics, history, modifications from every listing.
A listing already includes the trim specs, equipment, battery data and the result of the Dongchedi inspection.
Base URL
https://{access_name}.auto-api.com/api/v3/dongchediAuthorization: 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_id/imagesfresh photo linksGetting 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. Dongchedi photo links work for no more than 7 days. To show photos on a website, refresh the links through /images.
4. 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-06-02T17:25:48Z". Dates look like "2026-09-02", months like "2024-01".
- All amounts are in CNY.
- Every listing has the same keys. If a block such as Dongchedi inspection has no data, it is null.
GET/filters
Returns all possible values for filtering
https://{access_name}.auto-api.com/api/v3/dongchedi/filters?api_key=YOUR_API_KEYResponse:
{
"mark": {
"BYD": {
"model": {
"Han DM": { "complectation": ["DM 4WD Performance Edition Luxury Version", "DM 4WD Performance Edition Premium Version", "DM-i 121KM Premium Version", "DM-i 121KM Prestige Version", ...] },
...
}
},
"Geely": {
"model": {
"Boyue": { "complectation": ["1.5TD 10th Anniversary Champion Edition", "1.5TD Auto PRO", "1.5TD Auto Smart Connected PRO", "1.5TD Beloved", ...] },
...
}
},
...
},
"transmission_type": ["AMT", "Automatic", "CVT", "DCT", ...],
"color": ["Black", "Blue", "Brown", "Champagne", ...],
"body_type": ["Convertible", "Coupe", "Hatchback", "Liftback", ...],
"engine_type": ["Bi-fuel", "CNG", "Diesel", "Electric", ...],
"drive_type": ["AWD", "FWD", "RWD"]
}GET/offers
Listings page by page. Filters narrow down the results.
Parameters:
page(required) - page numbermark, model, complectation- brand, model and trim names as in /filterstransmission_type, color, body_type, engine_type, drive_type- transmission, color, body, fuel and drive values, case does not matterowners_count- number of ownersfirst_registration_from, first_registration_to- first registration month from and to, yyyy-mm formatyear_from, year_to- model 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[]=Li Auto&mark[]=Zeekr
https://{access_name}.auto-api.com/api/v3/dongchedi/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/dongchedi/offers?api_key=YOUR_API_KEY&page=1&mark=Li Auto&model=L8&first_registration_from=2023-01&owners_count=1https://{access_name}.auto-api.com/api/v3/dongchedi/offers?api_key=YOUR_API_KEY&page=1&mark[]=Li Auto&mark[]=Zeekr&color[]=Silver&color[]=Black&price_to=250000Response:
{
"result": [
{
"id": 241873,
"inner_id": "24015678",
"change_type": "added",
"created_at": "2026-06-02T17:25:48Z",
"data": {
"id": 241873,
"inner_id": "24015678",
"url": "https://www.dongchedi.com/usedcar/24015678",
"mark": "Li Auto",
"model": "L8",
"complectation": "Pro Edition",
"title": "Li Auto L8 2023 Pro Edition",
"year": 2023,
"first_registration": "2024-01",
"km_age": 54300,
"owners_count": 2,
"price": 196800,
"currency": "CNY",
"installment_price": null,
"installment_down_payment": null,
"purchase_costs": {
"items": [
{ "name": "Car price", "price": 199800 },
{ "name": "Registration service", "price": 1000 },
{ "name": "Delivery", "price": 2500 },
{ "name": "Total", "price": 203300 }
],
"deposit": 1500
},
"engine_type": "EREV",
"transmission_type": "Single-speed",
"body_type": "SUV",
"vehicle_class": "Mid-to-large SUV",
"drive_type": "AWD",
"color": "Silver",
"displacement": 1.5,
"displacement_cc": 1496,
"engine_model": "L2E15M",
"power": 449,
"power_ice_hp": 154,
"power_ice_kw": 113,
"power_ice_net_kw": null,
"power_hybrid_kw": 330,
"power_electro_kw": 330,
"power_electro_front_kw": 130,
"power_electro_rear_kw": 200,
"battery_capacity_kwh": 42.8,
"electric_range_km": 175,
"seat_count": 6,
"emission_standard": "China VI b",
"keys_count": null,
"sales_status": "Available",
"presale_note": null,
"section": "Used",
"seller_type": "Dealer",
"is_dealer": true,
"seller": "懂车帝汽车商城•斌哥新能源专营店",
"salon_id": "205449",
"city": "Quanzhou",
"region": "Fujian",
"registration_city": "Guangzhou",
"address": "泉州市南环路922-1号",
"description": null,
"created_at": "2026-06-02T17:25:48Z",
"photos": [
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/ca839b3effdd406981a2a8d0cb29ca23~tplv-f042mdwyw7-original:1000:0.image?...",
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/0785677e64c3472182760c423650c419~tplv-f042mdwyw7-original:1000:0.image?...",
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/31316d47b21f4e6b8ab2de987429fde3~tplv-f042mdwyw7-original:1000:0.image?...",
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/d251ef9e5351442986213b93515eb24e~tplv-f042mdwyw7-original:1000:0.image?...",
...
],
"photo_details": [
{ "type": "Front left", "url": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/ca839b3effdd406981a2a8d0cb29ca23~tplv-f042mdwyw7-original:1000:0.image?..." },
{ "type": "Front", "url": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/0785677e64c3472182760c423650c419~tplv-f042mdwyw7-original:1000:0.image?..." },
{ "type": "Front right", "url": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/31316d47b21f4e6b8ab2de987429fde3~tplv-f042mdwyw7-original:1000:0.image?..." },
{ "type": "Left side", "url": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/d251ef9e5351442986213b93515eb24e~tplv-f042mdwyw7-original:1000:0.image?..." },
...
],
"original": { // original values from dongchedi.com
"mark": "理想汽车",
"model": "理想L8",
"complectation": "Pro版",
"color": "银灰色",
"engine_type": "增程式",
"transmission_type": "电动车单速变速箱",
"drive_type": "双电机四驱",
"body_type": "SUV",
"vehicle_class": "中大型SUV",
"emission_standard": "国VI b",
"city": "泉州",
"title": "理想L8 2023款 Pro版",
"registration_city": "广州"
},
"catalog_ids": {
"mark": "202",
"model": "6095",
"complectation": "76932"
},
"options": {
"Safety and driver assistance": ["Advanced driver assistance system", "Rear collision warning", "Rear cross-traffic alert"],
"Parking and cameras": ["Automatic parking", "Surround view cameras"],
"Comfort": ["Wireless phone charging", "Front seat massage"],
"Lighting": ["Headlight leveling"]
},
"specs": {
"Basic information": {
"Manufacturer's suggested price (CNY)": "359800",
"Manufacturer": "Li Auto",
"Class": "Mid-to-large SUV",
"Fuel type": "EREV",
"Launch date": "2022.09",
"Electric motor": "EREV, 449 hp",
...
},
"Body": {
"Length (mm)": "5080",
"Width (mm)": "1995",
"Height (mm)": "1800",
"Wheelbase (mm)": "3005",
"Front track (mm)": "1725",
...
},
"Engine": {
"Engine model": "L2E15M",
"Displacement (mL)": "1496",
"Displacement (L)": "1.5",
"Aspiration": "Turbocharged",
...
},
"Electric motor": {
"Motor type": "Permanent magnet synchronous",
"Total electric motor power (kW)": "330",
"Total electric motor power (hp)": "449",
"Total electric motor torque (N·m)": "620",
...
},
...
},
"battery": {
"type": "NMC/NCA",
"cell_supplier": "CATL",
"warranty_until": "2032-01",
"warranty_km_limit": 160000,
"consumption_kwh_100km": 24.2,
"fast_charge_hours": 0.5,
"slow_charge_hours": 6.5
},
"inspection": {
"date": "2026-09-02",
"score": 9,
"score_exterior": 6.5,
"score_interior": 9.9,
"score_key_parts": 9.8,
"points_checked": 310,
"issues_exterior": 19,
"issues_interior": 0,
"issues_key_parts": 1,
"is_major_accident": false,
"is_flooded": false,
"is_fire_damaged": false,
"is_odometer_tampered": false,
"summary": "本车登记证已核验，过户1次，外观金属覆盖件有3处钣金喷漆，另...",
"battery_soh_percent": 95,
"battery_capacity_kwh": 40.9,
"battery_resistance_score": 92
},
"repaired_parts": null,
"selected_options": null
}
}
],
"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
title - Listing title in one line: brand, model, year, trim.
price, currency - Price in yuan, currency is always CNY.
installment_price, installment_down_payment - Installment price and down payment, when the seller gives them.
purchase_costs - Dongchedi's calculation: items (cost lines, each with name and price) and deposit.
sales_status - "Available" or "Pre-sale".
presale_note - Dongchedi's comment on the pre-sale.
section - "Used" or "New".
description - description
created_at - Time the listing reached our database.
Car
mark, model, complectation - Brand, model, trim.
year - Model year.
first_registration - Month of first registration.
km_age - mileage in km
owners_count - How many owners the car has had.
keys_count - Number of car keys, not given in every listing.
registration_city - City where the car is registered.
Specifications
engine_type, transmission_type, body_type - Engine, transmission and body.
vehicle_class - Size class, for example "Compact 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_kw - Power of the whole hybrid system, kW.
power_electro_kw - All electric motors combined, kW.
power_electro_front_kw, power_electro_rear_kw - Front and rear electric motor separately, kW.
battery_capacity_kwh - Traction battery capacity, kWh.
electric_range_km - Range on electricity alone, km.
seat_count - Number of seats.
emission_standard - Emission standard, for example "China VI b".
Seller
seller_type, is_dealer - "Dealer" or "Private seller", is_dealer repeats this as true/false.
seller, salon_id - The seller on Dongchedi and their ID there.
city, region - The seller's city and the province it belongs to.
address - The seller's address.
Photos, equipment and reference data
photos - Photo links. Each one lives up to 7 days, take fresh ones from /images.
photo_details - The same shots with the angle type, for example "Front left", and the url. If the angle is unknown, type is null.
options - Equipment by group "Safety and driver assistance", "Parking and cameras", "Comfort", "Multimedia and connectivity", "Lighting", "Driving modes". Items marked "(optional)" may be missing on this particular car.
specs - Trim specs by section, all values as strings. There can be up to 22 sections: "Basic information", "Body", "Engine", "Battery and charging", "Passive safety" and others.
selected_options - Options fitted to this car with their price when bought new: count (total options), total_price (their cost), items (up to five entries, each with name and price).
repaired_parts - Parts marked as repaired in the check: part (which part) and mark (which mark).
original - Original names and values from dongchedi.com.
catalog_ids - Brand, model and trim codes in the dongchedi.com catalog.
Battery (battery)
Traction battery data for electric cars and hybrids. If there is none, battery is null. A key without a value is not returned in the block.
type - Chemistry type, for example "LFP" or "NMC/NCA".
cell_supplier - Who makes the cells, for example "CATL".
ownership - "Owned" or "Leased".
warranty_until, warranty_km_limit - Battery warranty: end month and mileage limit in km.
consumption_kwh_100km - Energy consumption, kWh per 100 km.
fast_charge_hours, slow_charge_hours - How many hours fast and slow charging take.
Dongchedi inspection (inspection)
Result of the inspection Dongchedi carried out itself. If Dongchedi did not inspect the car, inspection is null. A key without a value is not returned in the block.
date - Day of the inspection.
score, score_exterior, score_interior, score_key_parts - Ratings on a ten-point scale: overall, exterior, interior, key parts.
points_checked - How many inspection points were checked.
issues_exterior, issues_interior, issues_key_parts - How many findings on the exterior, in the interior and in key parts.
is_major_accident, is_flooded, is_fire_damaged, is_odometer_tampered - Signs of a major accident, flood, fire and a rolled-back odometer (true/false).
summary - The inspector's conclusion.
battery_soh_percent - Share of its capacity the battery has kept, in percent.
battery_capacity_kwh - Battery capacity per the inspection, kWh.
battery_resistance_score - Battery rating by internal resistance, in Dongchedi's points.
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/dongchedi/change_id?api_key=YOUR_API_KEY&date=2026-10-22Response:
{
"change_id": 63514
}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/dongchedi/changes?api_key=YOUR_API_KEY&change_id=63527Response:
{
"result": [
{
"id": 63528,
"inner_id": "357103842",
"change_type": "added",
"created_at": "2026-10-22T06:48:19Z",
"data": { ... } // the full listing body
},
{
"id": 63533,
"inner_id": "356991207",
"change_type": "changed",
"created_at": "2026-10-22T07:05:52Z",
"data": { // the price changed, the new one in CNY
"new_price": 118800
}
},
{
"id": 63540,
"inner_id": "356884615",
"change_type": "removed",
"created_at": "2026-10-22T07:22:11Z",
"data": {} // removed from sale
}
// ... then the other events, up to 20 per page
],
"meta": {
"cur_change_id": 63527,
"next_change_id": 63547,
"limit": 20
}
}GET/offer
Single listing by inner_id
Parameters:
inner_id(required)
https://{access_name}.auto-api.com/api/v3/dongchedi/offer?api_key=YOUR_API_KEY&inner_id=24015678The response holds only the data object, without a result wrapper.
GET/images
Current photo links. A Dongchedi link lives up to 7 days, so the method returns listings whose links were refreshed in the last 5 days. Not available to a demo key.
Parameters:
page(required) - page numberupdated_from- date yyyy-mm-dd from which to take refreshed links
https://{access_name}.auto-api.com/api/v3/dongchedi/images?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/dongchedi/images?api_key=YOUR_API_KEY&page=1&updated_from=2026-10-22Response:
{
"result": [
{
"id": 30518,
"inner_id": "18420227",
"images": [
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/e236a9deba9948ea8414c2c067d05578~tplv-f042mdwyw7-original:1000:0.image?...",
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/d69b5918081541589c1abdb9e4ac60f9~tplv-f042mdwyw7-original:1000:0.image?...",
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/96a549722df742849267218df1e4568a~tplv-f042mdwyw7-original:1000:0.image?...",
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/02648d3a0f524244b2d9ecf4f1a6cb42~tplv-f042mdwyw7-original:1000:0.image?...",
...
],
"synced_at": "2026-10-20"
}
// ... then the other listings, up to 20 per page
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Data fields:
id, inner_id- record number in our database and listing number on Dongchediimages- array of linkssynced_at- the day the links were refreshed
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 dongchedi.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 dongchedi.com by URL
Parameters:
- url (required) - link to the listing on dongchedi.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.dongchedi.com/usedcar/20804886" }'Response:
{
"car_name": "Mercedes-Benz Mercedes-Benz GL-Class GL 500 4MATIC 2013",
"url": "https://www.dongchedi.com/usedcar/20804886",
"mark": "Mercedes-Benz",
"model": "Mercedes-Benz GL-Class",
"year": 2013,
"color": "black",
"price": 188000,
"km_age": 221000,
"engine_type": "petrol",
"transmission_type": "automatic",
"body_type": "SUV",
"displacement": "4.7",
"seller_type": "dealer",
"is_dealer": true,
"drive_type": "AWD",
"description": "13年奔驰GL550. 全车原版原漆...",
"horse_power": 435,
"complectation": "GL 500 4MATIC",
"city": "北京",
"region": "北京",
"owners_count": 3,
"reg_date": "2013-09-01",
"images": [
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/b5efd10487e84032a2060b0e5c79063a~tplv-f042mdwyw7-auto-webp:640:0.jpg",
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/1f3c9ca089684c97a3e5e57b6f8c6915~tplv-f042mdwyw7-auto-webp:640:0.jpg",
"https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/934853a8fcf84d5ca46448ccb60ae42e~tplv-f042mdwyw7-auto-webp:640:0.jpg"
]
}Field Descriptions:
- car_name - full vehicle name
- 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 type
- transmission_type - transmission type
- body_type - body type
- offer_created - listing creation date
- displacement - engine displacement (liters)
- vin - vehicle identification number
- seller_type - seller type
- is_dealer - dealer flag
- drive_type - drive type
- description - listing description
- horse_power - engine power (hp)
- complectation - trim level
- city - city
- region - region/province
- owners_count - number of previous owners
- reg_date - registration date
- images - array of image URLs
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-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'Dongchedi is a leading car platform in China. Millions of people use it to buy, sell, and research vehicles. Dealers and private sellers post new and used cars, motorcycles, and commercial vehicles across major cities.
Each listing includes clear specs, high‑quality photos, price history, and seller checks. You can filter by brand, model, year, price, and location to quickly find the right car.
Beyond listings, Dongchedi offers news, reviews, side‑by‑side comparisons, and market insights to help buyers decide with confidence. Strong ties with verified sellers and official dealers keep quality high.
The API provides organized data from the Dongchedi marketplace through reliable endpoints. Use it in your apps for pricing, inventory tracking, and market analysis.
Our real-time API operates 24/7, detecting new listings within minutes and tracking removals to reflect actual market movements. No custom parsers or crawlers required.
Expand your automotive data coverage across global markets with our platform APIs: