
Dongchedi New Cars APIScraper & Parser
Dongchedi New Cars API: new cars on sale in China right now, trim by trim. Dealer price and discount, the full spec sheet, equipment and photos.
Dongchedi New Cars API
The Dongchedi New Cars API shows which new cars are on sale in China right now, and at what price. You can filter trims by model and budget, and each one comes with specs, equipment, photos and the dealer price next to the manufacturer's price. You don't have to write a Dongchedi parser or scraper of your own for this: changes arrive through an event feed.
The change feed shows every new Dongchedi trim, every price change, and when a trim is taken off sale.
Once a day we prepare a file with every Dongchedi trim currently on sale.
22 groups of specs and equipment, prices for options, three kinds of photos and the dealer price with the discount off the manufacturer's price.
What Goes Into a Car Page
The equipment field is one sheet with both technical specs and equipment; photos and prices come as separate fields.
Technical Specifications
Basic information: class, manufacturer, market launch date; fuel or energy consumption, top speed, acceleration time and torque
Body: dimensions, wheelbase and track, weight, number of doors and seats, fuel tank and trunk
Engine: model and displacement, power, forced induction, cylinders and valves, emission standard
Transmission: transmission type and number of gears
Chassis and steering: drivetrain, front and rear suspension, power steering
Wheels and brakes: tires, brakes, parking brake, spare wheel
Electric motor: number and type of motors, power and torque per axle
Battery and charging: capacity in kWh, battery type and cell manufacturer, charging ports
Equipment
Safety: ABS, airbags, automatic braking, blind spot monitoring
Driver assistance: cameras, radars, cruise control, automatic parking
Comfort: seats, climate control, screens and audio, lighting
Options: standard or at extra cost, with the option price
Total: 14 groups, close to 200 items in well-equipped trims
Photos
360-degree view: 36 frames for each body color
Gallery: exterior, dashboard, cabin, up to 30 photos per category
Interior panorama: a spherical shot from the driver's seat and from the rear row
Model and Prices
Model: make and model, trim name, class, model year
Prices: what the manufacturer asks, what a Beijing dealer asks, the size of the discount
Warranty: factory warranty on the car and a separate one on the battery
Base URL
https://{access_name}.auto-api.com/api/v2/dongchedi_newAuthorization: api_key parameter
Workflow
/filtersreference data: makes, models and filtersInitial load:
/change_id?date=...get the starting event ID/offersload the trims on sale, all of them or by filter/changes?change_id=...new trims, price changes, trims taken off sale/offerthe record of a specific trimWhere to start:
1. First, call /change_id with today's date in China time and store the ID you get. A zero in the response means there have been no events for that date yet: call the method again a little later. After that, load /offers in full, paging through until next_page equals null.
2. Handle /changes responses by event type: added adds a record to your catalog, changed updates the prices, removed drops a trim that has been taken off sale. Make the first call with the ID stored before the load, and every following call with next_change_id from the response. When next_change_id is null, there are no more events: repeat the call later with the last ID.
3. To narrow the list down to your task, set the filters you need in /offers, for example make, model and a price ceiling.
GET/filters
Makes, their models and the allowed values of the other /offers filters. Updated once a day.
https://{access_name}.auto-api.com/api/v2/dongchedi_new/filters?api_key=YOUR_API_KEYResponse:
{
"mark": {
"Voyah": {
"model": ["Voyah Dreamer EV", "Voyah Dreamer PHEV", "Voyah FREE", "Voyah Taishan", "Voyah Zhiyin", // ...]
},
"Tank": {
"model": ["Tank 300", "Tank 400", "Tank 400 Hi4-T", "Tank 400 Hi4-Z", "Tank 500", // ...]
},
"Xiaomi": {
"model": ["Xiaomi SU7", "Xiaomi SU7 Ultra", "Xiaomi YU7"]
},
"...": { ... }
},
"engine_type": ["EREV", "PHEV", "diesel", "electric", "hybrid", "petrol", // ...],
"transmission_type": ["AMT", "CVT", "DHT", "E-CVT", "automatic", "dry DCT", "manual", "single-speed", "unknown", "wet DCT", // ...],
"drive_type": ["AWD", "FWD", "RWD"],
"body_type": ["SUV", "hatchback", "liftback", "minivan", "pickup", "sedan", "wagon", // ...]
}GET/offers
The list of trims on sale: pages of 20 records, filters optional.
Parameters:
page(required) - page numbermark, model- make and model, written as they appear in /filtersengine_type, transmission_type, drive_type, body_type- fuel, transmission, drivetrain, body type; case does not matteryear_from, year_to- model year boundsprice_from, price_to- price in CNY, compared against the price field
https://{access_name}.auto-api.com/api/v2/dongchedi_new/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/dongchedi_new/offers?api_key=YOUR_API_KEY&page=1&mark=Voyah&model=Voyah%20FREE&year_from=2025Response:
{
"result": [
{
"id": 10383,
"inner_id": "101727",
"change_type": "added",
"created_at": "2026-04-20T17:40:41.692+03:00",
"data": {
"id": "10383",
"inner_id": "101727",
"url": "https://www.dongchedi.com/auto/series/4760/model-101727",
"mark": "Voyah",
"model": "Voyah FREE",
"complectation": "318 4WD Explorer Edition",
"year": "2025",
"price": "246900",
"official_price": "266900",
"cut_price": "20000",
"engine_type": "EREV",
"transmission_type": "single-speed",
"drive_type": "AWD",
"body_type": "SUV",
"displacement": "1.5",
"doors_count": "5",
"horse_power": "490",
"ice_power_ps": "150",
"ice_power_kw": "110",
"electric_power_ps": "490",
"electric_power_kw": "360",
"hybrid_power_ps": "",
"hybrid_power_kw": "",
"equipment": {
"Basic information": { "Manufacturer": "VOYAH", "Class": "full-size suv", "Launch date": "2024.06", "CLTC electric range (km)": "259", "0-100 km/h acceleration, official (s)": "4.5", "Vehicle warranty": "5 years or 100,000 km", // ... },
"Body": { "Length (mm)": "4905", "Width (mm)": "1950", "Height (mm)": "1645", "Wheelbase (mm)": "2960", "Curb weight (kg)": "2260", "Trunk volume (L)": "560-1320", // ... },
"Engine": { "Engine model": "DAM15NTDE", "Displacement (mL)": "1499", "Aspiration": "Turbocharged", "Max power (hp)": "150", "Emission standard": "China VI b", // ... },
"Electric motor": { "Number of drive motors": "Dual motor", "Total electric motor power (kW)": "360", "Total electric motor torque (N·m)": "720", // ... },
"Battery/charging": { "Battery capacity (kWh)": "43", "Battery type": "NCM lithium-ion", "Battery cell brand": "CATL", "Vehicle-to-load power (V2L)": "●", // ... },
"Transmission": { "Number of gears": "1", "Transmission type": "Fixed-ratio transmission" },
"Chassis/steering": { "Drive type": "awd (dual-motor)", "Front suspension type": "double wishbone independent", "Rear suspension type": "multi-link independent", // ... },
"Wheels/brakes": { "Front Brake Type": "Ventilated disc", "Front tire size": "255/45 R20", "Parking brake type": "Electronic", // ... },
"Active safety": { "Anti-lock brakes (ABS)": "●", "Automatic emergency braking": "●", "Blind Spot Monitoring": "●", "Lane Keep Assist": "●", // ... },
"Driver assistance and handling": { "Parking sensors": "Front, Rear", "Driver assistance level": "Level 2", "Automatic parking": "●", "Air suspension": "●", // ... },
"Exterior": { "Sunroof type": "Opening panoramic sunroof, Fixed panoramic roof ○ 12999 CNY", "Roof rails": "●", // ... },
"Seats": { "Seat material": "Leather/suede", "Front seat functions": "Heating, Ventilation, Massage, Memory (driver)", "Rear seat folding ratio": "40:60", // ... },
"Air conditioning/refrigerator": { "Climate control zones": "2 zones", "PM2.5 Air Filter": "●", "Refrigerator": "○", // ... },
"...": { ... } // 22 groups and 252 items in this trim in total
},
"images": "[\"http://p3-dcd.byteimg.com/tos-cn-i-dcdx/131c546b47344d22a7cbc915b7186838~tplv-f042mdwyw7-original:640:0.png?psm=motor.pc_car.api\"]",
"images_360": [
{
"inner_id": "101727",
"color": "Cyan",
"color_hex": "#B4C1BE",
"frames": ["https://p9-dcd.byteimg.com/img/tos-cn-i-dcdx/71de1a477ff346e88cec9c287bc53686~tplv-resize:1200:0.webp", "https://p1-dcd.byteimg.com/img/tos-cn-i-dcdx/4d3abdd38939475e97ef1a712f739076~tplv-resize:1200:0.webp", // ...] // 36 frames, a full circle
},
// ... 5 sets in total, one per body color
],
"images_gallery": [
{ "category": "exterior", "inner_id": "101727", "images": ["https://p9-dcd.byteimg.com/motor-mis-img/78ed84c72cb3f6849a27f14cff7b9a7d~tplv-f042mdwyw7-original:1200:0.jpg", // ...] }, // 30 photos in this category
{ "category": "interior", "inner_id": "101727", "images": [ ... ] },
{ "category": "space", "inner_id": "101727", "images": [ ... ] }
],
"panorama_interior": [
{
"inner_id": "101727",
"color": "Black",
"color_hex": "#000000",
"front": "https://p9-dcd.byteimg.com/img/motor-mis-img/95b71a3d3888109b5525c92a573a73eb~tplv-resize:4000:0.image",
"rear": "https://p9-dcd.byteimg.com/img/motor-mis-img/cf8bb50227ebe3c9f2ae63e46a95a5ff~tplv-resize:4000:0.image"
}
],
"section": "new",
"series_id": "4760",
"brand_id": "395"
}
},
// ... then the rest of the page's records, up to 20
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Record fields
- id - sequential record ID; use inner_id to identify the trim
- inner_id - trim ID on dongchedi.com; it does not change
- url - address of the trim page on dongchedi.com
- mark, model - make and model, e.g. Voyah and Voyah FREE
- complectation - trim name; the model and year are not part of it
- year - model year
- price - price in CNY. Usually the lowest Beijing dealer price. Without dealer offers, the manufacturer's price; without either, 0
- official_price - what the manufacturer asks, CNY
- cut_price - the amount in CNY by which Beijing dealers undercut the manufacturer's price; the value is taken from Dongchedi
- engine_type - fuel; the allowed values come from /filters
- transmission_type - transmission; the list is in /filters
- drive_type - drivetrain; the list is in /filters
- body_type - body type; the list is in /filters
- displacement - engine displacement, liters; left empty for EVs
- doors_count - number of doors
- horse_power - power in hp; the first known value is taken: hybrid_power_ps, then electric_power_ps, then ice_power_ps
- ice_power_ps, ice_power_kw - combustion engine power in hp and kW
- electric_power_ps, electric_power_kw - hp and kW of all electric motors combined
- hybrid_power_ps, hybrid_power_kw - total power of the hybrid system, hp and kW
- section - section, always new
- series_id, brand_id - model ID and make ID on Dongchedi
- equipment - an object with groups of specs and equipment; the group names are below. A group holds only the items this trim has. What the values mean:
- ● - included in the trim at no extra cost
- ○ - equipment the buyer can choose; an entry like "○ 499 CNY" shows what it costs to add
- text or number - a size, material or type, e.g. "2960" or "Leather/suede". A comma separates one variant from another, a ○ mark after a name applies to that name, and the amount after the mark is the extra cost
- When the trim has no sheet, an empty string stands in place of the object
- images - a string with a JSON array inside: a link to the model's photo; an empty string when there is no photo
- images_360 - 360-degree view of the body: an array of sets, one per color. A set holds the inner_id of the trim that was photographed, color, color_hex and frames: 36 frames, a full circle around the car; a two-tone body also gets sub_color_hex. The main color comes first in the array
- images_gallery - gallery: an array by photo category. An element has category, the inner_id of the trim that was photographed, and images, up to 30 links. Categories: exterior is the body, interior is the dashboard with the screens and steering wheel, space is the seats, doors and trunk
- panorama_interior - interior panorama. front, rear and third hold the URLs of 2:1 spherical images: the view from the driver's seat, from the second row and from the third row; not every car has third. The interior color is set by color and color_hex, with the second shade of a two-tone interior in sub_color_hex. The array has one set per color, and a set has an inner_id
inner_id inside a photo set shows which trim was photographed. It may differ from the record's own inner_id (the ID of its trim): that means the photos are of another version of the same model. This is how images_360, images_gallery and panorama_interior work. If the whole model has no photos, the arrays are empty. All photo links point to Dongchedi's servers.
Group names in equipment
equipment - Basic information, Body, Engine, Electric motor, Battery/charging, Transmission, Chassis/steering, Wheels/brakes, Active safety, Passive safety, Driver assistance and handling, Exterior, Interior, Comfort and anti-theft, Seats, Smart connectivity, Infotainment, Lighting, Glass/mirrors, Air conditioning/refrigerator, Intelligent features, Option packages.
GET/change_id
The first event ID from the given date onwards; days are counted in China time. A response of 0 means there have been no events since that date yet.
Parameters:
date(required) - date in yyyy-mm-dd format
https://{access_name}.auto-api.com/api/v2/dongchedi_new/change_id?api_key=YOUR_API_KEY&date=2026-10-03Response:
{ "change_id": 14615 }A response of 0: no events yet, call the method again later. Any other number works as the change_id parameter.
GET/changes
Catalog events: added for a new trim, changed for a price or discount change, removed for a trim taken off sale.
Parameters:
change_id(required) - starting from which change ID
https://{access_name}.auto-api.com/api/v2/dongchedi_new/changes?api_key=YOUR_API_KEY&change_id=14615Response:
{
"result": [
{
"id": 14615,
"inner_id": "244341",
"change_type": "added",
"created_at": "2026-10-03T09:02:11.648+03:00",
"data": { ... } // all trim data, as in /offers
},
{
"id": 14616,
"inner_id": "101727",
"change_type": "changed",
"created_at": "2026-10-03T09:31:54.072+03:00",
"data": { "new_price": 246900, "official_price": 266900, "cut_price": 20000 } // new price, manufacturer's price and discount
},
{
"id": 14617,
"inner_id": "101728",
"change_type": "removed",
"created_at": "2026-10-03T10:20:37.513+03:00",
"data": {} // hypothetical example: the trim was taken off sale
}
],
"meta": {
"cur_change_id": 14615,
"next_change_id": 14618,
"limit": 20
}
}Make the next call with next_change_id from the response. A null value means you have read the feed to the end: repeat the same call after a while.
GET/offer
The full data of a trim by its inner_id.
Parameters:
inner_id(required)
https://{access_name}.auto-api.com/api/v2/dongchedi_new/offer?api_key=YOUR_API_KEY&inner_id=101727The response is the record itself, without the result and data wrappers.
Retention
Files stay available for at least 3 days
Availability
Fresh files every morning
CSV Format
CSV columns are separated by the pipe character (|)
URL structure:
Parameters:
access_name- your personal subdomaindate- export date in yyyy-mm-dd format, e.g. 2026-10-05file_name- file name with extension
Available files:
- 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 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 command example
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'On Dongchedi (dongchedi.com), one model is represented by several trims with different equipment and prices. The API returns each of them as a separate record.
The API returns only what is on sale right now. When a trim goes off sale, it disappears from the catalog and a removed event appears in the feed.
The prices are the main thing in this data: alongside the manufacturer's price come the lowest Beijing dealer price and the size of the discount. They show which trims dealers sell below the manufacturer's price, and by how much.
Each trim's specs, equipment and photos are suitable for the catalog on your website. You don't need a Dongchedi scraper for this.
Expand your automotive data coverage across global markets with our platform APIs: