Dongchedi APIScraper & Parser
Access Dongchedi data directly via API, eliminating the need for scrapers. Extract structured vehicle data from China’s leading automotive platform.
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.
Base URL
https://{access_name}.auto-api.com/api/v2/dongchediAuthorization: api_key parameter
Workflow
/filtersget available filter options/offersretrieve listings (with or without filters) - optimal for initial data loadTo keep data synchronized after initial load:
/change_id?date=...get starting ID for changes feed/changes?change_id=...get all updates from the database starting from ID/offerget full details of a specific listing by inner_idRecommended integration workflow:
1. Start with /offers for full data extraction (iterate through all pages)
2. Periodically call /changes to retrieve all updates (additions/modifications/removals) and keep your database in sync
3. For frontend integration, use /offers with filters and pagination (brand, model, price, year, etc.)
GET/filters
Returns all available filters and possible values
https://{access_name}.auto-api.com/api/v2/dongchedi/filters?api_key=YOUR_API_KEYResponse:
{
"mark": {
"BMW": {
"model": {
"X5": { "complectation": ["xDrive40i", "xDrive50i"] },
"X3": { "complectation": ["xDrive30i"] }
}
},
"Audi": {
"model": {
"A4": { "complectation": ["40 TFSI", "45 TFSI"] }
}
}
},
"transmission_type": ["Manual", "Automatic", "CVT", "DCT", "Wet DCT", "Dry DCT", "AMT", "E-CVT", "DHT", "Sequential", "Single-Speed"],
"color": ["White", "Black", "Silver", "Dark Gray", "Blue", "Red", "Brown", "Orange", "Yellow", "Green", "Purple", "Champagne", "Other"],
"body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Wagon", "Coupe", "Convertible", "Pickup", "Liftback", "Microvan", "Sports Car", "Mini Truck", "Light Commercial", "Motorhome"],
"engine_type": ["Petrol", "Diesel", "Electric", "Hybrid", "PHEV", "EREV", "Bi-Fuel", "CNG"],
"drive_type": ["FWD", "RWD", "AWD"]
}GET/offers
Listings endpoint with pagination and filtering
Parameters:
page(required) - page numbermark, model, complectation- filters (case-insensitive)transmission_type, color, body_type, engine_type, drive_type- filters (case-insensitive)year_from, year_to- year range filterkm_age_from, km_age_to- mileage range filterprice_from, price_to- price range filter (in CNY)
https://{access_name}.auto-api.com/api/v2/dongchedi/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/dongchedi/offers?api_key=YOUR_API_KEY&page=1&mark=BMW&color=blackResponse:
{
"result": [
{
"id": 2648717,
"inner_id": "40307747",
"change_type": "added",
"created_at": "2025-08-14T19:39:18.380Z",
"data": {
"id": 1380988,
"inner_id": "40307747",
"url": "https://www.dongchedi.com/auto/pu-40307747",
"mark": "BYD",
"model": "Tang DM",
"complectation": "2.0T Hybrid AWD Premium",
"year": 2022,
"color": "Pearl White",
"price": 268000,
"km_age": 18500,
"body_type": "SUV",
"engine_type": "Hybrid",
"transmission_type": "Automatic",
"address": "Beijing, Chaoyang District",
"is_dealer": true,
"displacement": 2.0,
"city": "Beijing",
"title": "BYD Tang DM 2022 Premium",
"owners_count": 1,
"drive_type": "all-wheel",
"equipment": ["Heated Seats", "360 Camera", "Autopilot"],
"horse_power": 321,
"reg_date": "2022-06-15",
"section": "Used",
"seller": "BYD 4S Store",
"seller_type": "DEALER",
"salon_id": "20230918001",
"region": "Beijing",
"description": "Excellent condition, no accidents, first owner...",
"images": ["https://p3.dcarstatic.com/img/msb-pic/40307747_001.jpg"],
"extra_prep": {"inspection": {...}, "warranty": "1 year"}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Data fields:
- id - internal database ID
- inner_id - listing ID on the platform
- url - link to the listing
- mark - car brand
- model - car model
- complectation - complectation/trim
- year - production year
- color - color
- price - price in CNY
- km_age - mileage in km
- body_type - body type
- engine_type - engine type
- transmission_type - transmission type
- address - address
- is_dealer - dealer flag (true/false)
- displacement - engine displacement
- city - city
- title - listing title
- owners_count - number of owners
- drive_type - drive type
- equipment - equipment list
- horse_power - power in hp
- reg_date - registration date
- section - section
- seller - seller
- seller_type - seller type
- salon_id - dealer ID
- region - region
- description - description
- images - array of image URLs
- extra_prep - additional data (JSON)
GET/change_id
Get initial change ID by date (for use in /changes)
Parameters:
date(required) - date in yyyy-mm-dd format
https://{access_name}.auto-api.com/api/v2/dongchedi/change_id?api_key=YOUR_API_KEY&date=2025-01-15Response:
{ "change_id": 2859364 }Use the returned value as the change_id parameter in /changes
GET/changes
Changes feed (added/changed/removed listings)
Parameters:
change_id(required) - starting from which change ID
https://{access_name}.auto-api.com/api/v2/dongchedi/changes?api_key=YOUR_API_KEY&change_id=1Response:
{
"result": [
{
"id": 456,
"inner_id": "40307747",
"change_type": "added", // added - new listing
"created_at": "2025-01-15T10:30:00Z",
"data": { ... } // full listing data
},
{
"id": 457,
"inner_id": "40307748",
"change_type": "changed", // changed - price update
"created_at": "2025-01-15T10:31:00Z",
"data": { "new_price": 258000 }
},
{
"id": 458,
"inner_id": "40307749",
"change_type": "removed", // removed - listing deleted
"created_at": "2025-01-15T10:32:00Z"
}
],
"meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}GET/offer
Details for a single listing by inner_id
Parameters:
inner_id(required)
https://{access_name}.auto-api.com/api/v2/dongchedi/offer?api_key=YOUR_API_KEY&inner_id=40307747Response: data object (same structure as /offers items, without result wrapper)
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- access_name - your assigned subdomain identifierdate- date - target date in yyyy-mm-dd format (e.g., 2025-09-06)file_name- 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: