AUTO-API.COM
Dongchedi logo

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.

Official SDK Libraries

Our SDKs include the API methods as ready-made functions, and the library code is open source on GitHub.

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.

API

The change feed shows every new Dongchedi trim, every price change, and when a trim is taken off sale.

Daily Exports

Once a day we prepare a file with every Dongchedi trim currently on sale.

Complete Data

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.

Get API AccessAccess provided within 2 minutes

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_new

Authorization: api_key parameter

Workflow

1
/filtersreference data: makes, models and filters
2

Initial load:

/change_id?date=...get the starting event ID
/offersload the trims on sale, all of them or by filter
3
/changes?change_id=...new trims, price changes, trims taken off sale
4
/offerthe record of a specific trim

Where 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_KEY

Response:

{
  "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 number
  • mark, model - make and model, written as they appear in /filters
  • engine_type, transmission_type, drive_type, body_type - fuel, transmission, drivetrain, body type; case does not matter
  • year_from, year_to - model year bounds
  • price_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=2025

Response:

{
  "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-03

Response:

{ "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=14615

Response:

{
  "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=101727

The 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:

https://{access_name}.auto-api.com/{date}/{file_name}

Parameters:

  • access_name - your personal subdomain
  • date - export date in yyyy-mm-dd format, e.g. 2026-10-05
  • file_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.csv

Wget command example

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
Dongchedi

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.

Reply in 2 min