
Dongchedi APIScraper & Parser
Dongchedi API: обяви за употребявани автомобили в Китай с цена, пробег, технически характеристики и снимки. REST API и ежедневни експорти.
Dongchedi API
Получете достъп до най-големия онлайн пазар за автомобили в Китай чрез нашето API. Извличайте изчистени данни за автомобили от цял Китай за анализи и проучване на пазара.
Получавайте незабавни известия за нови автомобилни обяви от Китай.
Ежедневен експорт на всички активни обяви за анализ на пазара.
Получете достъп до всички данни за автомобилите чрез API: цена, характеристики, диагностика, история, модификации от всяка обява.
Обявата вече съдържа характеристиките на нивото на оборудване, оборудването, данните за батерията и резултата от проверката от Dongchedi.
Базов URL
https://{access_name}.auto-api.com/api/v3/dongchediОторизация: api_key параметър
Ред на работа
/filtersполучаване на наличните стойности на филтритеПървоначално зареждане:
/change_id?date=...получаване на началното ID за потока от промени/offersполучаване на всички обяви страница по страница/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID/offerполучаване на данни за конкретна обява по inner_id/imagesобновени връзки към снимкитеОткъде да започнете:
1. Преди първото зареждане вземете номера от /change_id за днешната дата и го запазете. След това преминете през /offers страница по страница до края: на последната страница next_page е null.
2. После извиквайте /changes, като започнете от този номер, и подавайте next_change_id от всеки отговор. Така пристигат новите обяви, новите цени и свалените от продажба автомобили. Ако next_change_id е null, все още няма събития: повторете същата заявка по-късно.
3. Връзките към снимките от Dongchedi работят най-много 7 дни. За да показвате снимките на сайта си, обновявайте връзките чрез /images.
4. За да търсите по собствени критерии, извиквайте /offers с филтри.
Формат на данните
- Типовете се запазват: числото идва като число, списъкът като масив, а липсващата стойност като null.
- Датата и часът се дават в UTC, например "2026-06-02T17:25:48Z". Датите имат вида "2026-09-02", а месеците вида "2024-01".
- Всички суми са в CNY.
- Всички обяви имат едни и същи ключове. Ако за даден блок, например проверката от Dongchedi, няма данни, блокът е null.
GET/filters
Връща всички възможни стойности за филтриране
https://{access_name}.auto-api.com/api/v3/dongchedi/filters?api_key=YOUR_API_KEYОтговор:
{
"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
Обяви страница по страница. Филтрите стесняват резултатите.
Параметри:
page(задължително) - номер на страницатаmark, model, complectation- имена на марката, модела и нивото на оборудване, изписани както във /filterstransmission_type, color, body_type, engine_type, drive_type- стойности за скоростна кутия, цвят, каросерия, гориво и задвижване, без разлика между главни и малки буквиowners_count- брой собственициfirst_registration_from, first_registration_to- месец на първа регистрация от и до, във формат yyyy-mmyear_from, year_to- моделна година от и доkm_age_from, km_age_to- пробег в км от и доprice_from, price_to- цена в юани от и до
За да подадете няколко стойности на един филтър, повторете параметъра със скоби: 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=250000Отговор:
{
"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": { // оригинални стойности от 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
}
}Полета с данни:
Обява
id - вътрешно ID в базата данни
inner_id - ID на обявата в платформата
url - връзка към обявата
title - Заглавие на обявата на един ред: марка, модел, година, ниво на оборудване.
price, currency - Цена в юани, currency винаги е CNY.
installment_price, installment_down_payment - Цена на изплащане и първоначална вноска, когато продавачът ги посочва.
purchase_costs - Изчисление на Dongchedi: items (разходни пера, всяко с name и price) и deposit (капаро).
sales_status - "Available" или "Pre-sale".
presale_note - Коментар на Dongchedi за предварителната продажба.
section - "Used" или "New".
description - описание
created_at - Дата и час, когато обявата е постъпила в нашата база данни.
Автомобил
mark, model, complectation - Марка, модел, ниво на оборудване.
year - Моделна година.
first_registration - Месец на първа регистрация.
km_age - пробег в км
owners_count - Колко собственици е имал автомобилът.
keys_count - Брой ключове за автомобила, не е посочен във всяка обява.
registration_city - Град, в който е регистриран автомобилът.
Характеристики
engine_type, transmission_type, body_type - Двигател, скоростна кутия и каросерия.
vehicle_class - Клас по размер, например "Compact SUV".
drive_type - Задвижване: "FWD", "RWD" или "AWD".
color - Цвят на каросерията.
displacement, displacement_cc - Обем на двигателя в литри и в кубически сантиметри.
engine_model - Код на двигателя.
power - Обща мощност, к.с.
power_ice_hp, power_ice_kw - Двигател с вътрешно горене: к.с. и kW.
power_ice_net_kw - Нетна мощност на двигателя с вътрешно горене, kW.
power_hybrid_kw - Мощност на цялата хибридна система, kW.
power_electro_kw - Всички електромотори заедно, kW.
power_electro_front_kw, power_electro_rear_kw - Предният и задният електромотор поотделно, kW.
battery_capacity_kwh - Капацитет на тяговата батерия, kWh.
electric_range_km - Пробег само на електрическа тяга, км.
seat_count - Брой места.
emission_standard - Екологичен стандарт, например "China VI b".
Продавач
seller_type, is_dealer - "Dealer" или "Private seller", is_dealer повтаря това като true/false.
seller, salon_id - Продавачът в Dongchedi и неговото ID там.
city, region - Град на продавача и провинцията, към която спада.
address - Адрес на продавача.
Снимки, оборудване и справочни данни
photos - Връзки към снимките. Всяка е валидна до 7 дни, обновените вземайте от /images.
photo_details - Същите снимки с ъгъла на снимане в type, например "Front left", и връзката в url. Ако ъгълът е неизвестен, type е null.
options - Оборудване по групи "Safety and driver assistance", "Parking and cameras", "Comfort", "Multimedia and connectivity", "Lighting", "Driving modes". Позициите с означение "(optional)" може да липсват на този конкретен автомобил.
specs - Характеристики на нивото на оборудване по раздели, всички стойности като низове. Разделите може да са до 22: "Basic information", "Body", "Engine", "Battery and charging", "Passive safety" и други.
selected_options - Опции, монтирани на този автомобил, с цената им при покупка като нови: count (общ брой опции), total_price (тяхната стойност), items (до пет позиции, всяка с name и price).
repaired_parts - Детайли от каросерията, отбелязани като ремонтирани при проверката: part (кой детайл) и mark (какво означение).
original - Оригинални имена и стойности от dongchedi.com.
catalog_ids - Кодове на марката, модела и нивото на оборудване в каталога на dongchedi.com.
Батерия (battery)
Данни за тяговата батерия на електромобилите и хибридите. Ако няма такива данни, battery е null. Ключ без стойност не се връща в блока.
type - Химичен тип, например "LFP" или "NMC/NCA".
cell_supplier - Кой произвежда клетките, например "CATL".
ownership - "Owned" или "Leased".
warranty_until, warranty_km_limit - Гаранция на батерията: месец на изтичане и ограничение на пробега в км.
consumption_kwh_100km - Разход на енергия, kWh на 100 км.
fast_charge_hours, slow_charge_hours - Колко часа отнема бързото и бавното зареждане.
Проверка от Dongchedi (inspection)
Резултат от проверката, която Dongchedi е извършила сама. Ако Dongchedi не е проверявала автомобила, inspection е null. Ключ без стойност не се връща в блока.
date - Ден на проверката.
score, score_exterior, score_interior, score_key_parts - Оценки по десетобална скала: обща, екстериор, интериор, ключови възли.
points_checked - Колко контролни точки са проверени.
issues_exterior, issues_interior, issues_key_parts - Колко забележки има по екстериора, в интериора и в ключовите възли.
is_major_accident, is_flooded, is_fire_damaged, is_odometer_tampered - Признаци на сериозно произшествие, наводнение, пожар и манипулиран одометър (true/false).
summary - Заключение на инспектора.
battery_soh_percent - Каква част от капацитета си е запазила батерията, в проценти.
battery_capacity_kwh - Капацитет на батерията според проверката, kWh.
battery_resistance_score - Оценка на батерията по вътрешното съпротивление, в точки на Dongchedi.
GET/change_id
Получаване на първото ID на промяна по дата (за използване в /changes)
Параметри:
date(задължително) - дата във формат yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/dongchedi/change_id?api_key=YOUR_API_KEY&date=2026-10-22Отговор:
{
"change_id": 63514
}Използвайте върнатата стойност като параметър change_id в /changes
GET/changes
Поток от промени (добавени/променени/премахнати)
Параметри:
change_id(задължително) - от кое ID на промяна да се започне
https://{access_name}.auto-api.com/api/v3/dongchedi/changes?api_key=YOUR_API_KEY&change_id=63527Отговор:
{
"result": [
{
"id": 63528,
"inner_id": "357103842",
"change_type": "added",
"created_at": "2026-10-22T06:48:19Z",
"data": { ... } // цялото тяло на обявата
},
{
"id": 63533,
"inner_id": "356991207",
"change_type": "changed",
"created_at": "2026-10-22T07:05:52Z",
"data": { // цената е променена, новата е в CNY
"new_price": 118800
}
},
{
"id": 63540,
"inner_id": "356884615",
"change_type": "removed",
"created_at": "2026-10-22T07:22:11Z",
"data": {} // свален от продажба
}
// ... следват останалите събития, до 20 на страница
],
"meta": {
"cur_change_id": 63527,
"next_change_id": 63547,
"limit": 20
}
}GET/offer
Една обява по inner_id
Параметри:
inner_id(задължително)
https://{access_name}.auto-api.com/api/v3/dongchedi/offer?api_key=YOUR_API_KEY&inner_id=24015678Отговорът съдържа само обекта data, без обвивката result.
GET/images
Актуални връзки към снимките. Връзката от Dongchedi е валидна до 7 дни, затова методът връща обявите, чиито връзки са обновени през последните 5 дни. Не е достъпен за демо ключ.
Параметри:
page(задължително) - номер на страницатаupdated_from- дата yyyy-mm-dd, от която да се вземат обновените връзки
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-22Отговор:
{
"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"
}
// ... следват останалите обяви, до 20 на страница
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Полета с данни:
id, inner_id- номер на записа в нашата база данни и номер на обявата в Dongchediimages- масив от връзкиsynced_at- ден на обновяване на връзките
Грешки
При грешка отговорът съдържа поле error с описание: { "error": "parameter page is required" }
401- ключът api_key не е приет400- липсва задължителен параметър или някоя стойност е в неправилен формат404- няма обява с такъв inner_id (/offer)429- лимитът на заявките е изчерпан
API-то връща данните на обява в dongchedi.com по връзка към нея: полетата както в /offer и блок meta с оставащия лимит.
Базов URL
https://{access_name}.auto-api.com/api/v2/offer/infoОторизация: хедър x-api-key
POST/api/v2/offer/info
Една обява по връзката към нея
Параметри:
url(задължително) - URL адрес на страницата на обявата в dongchedi.com
Примерна заявка:
curl -L 'https://{access_name}.auto-api.com/api/v2/offer/info' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "url": "https://www.dongchedi.com/usedcar/24015678" }'Отговор:
{
"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,
// ... останалите полета на обявата, както в /offer на API v3
"meta": {
"requests_made": 48,
"requests_left": 1952,
"requests_limit": 2000,
"period_start": "2026-11",
"platform": "dongchedi"
}
}Полетата на обявата са същите, които връща /offer в API v3. Блокът meta идва последен.
Какво има в meta:
requests_made- колко успешни заявки са направени през текущия месецrequests_left- колко още заявки можете да направитеrequests_limit- месечният лимитperiod_start- месецът на броячаplatform- от коя платформа е обявата: encar, che168, dongchedi, guazi или mobilede
Към месечния лимит се отчитат само отговорите с обява, а грешките не го изразходват.
Грешки
При грешка отговорът съдържа поле error с описание: { "error": "Failed to get info" }
401- ключът x-api-key не е приет400- липсва връзка или тя не е разпозната, или платформата не е включена за ключа422- данните от обявата не могат да бъдат получени429- лимитът на заявките е изчерпан
Правила за съхранение на данните
Файловете се съхраняват поне 3 дни.
График на доставка чрез API
Ежедневните файлове са готови за изтегляне.
Настройки на CSV файла
CSV файловете използват вертикална черта (|) като разделител на колоните.
Структура на URL адреса:
Параметри на заявката:
access_name- предоставеният ви идентификатор на поддомейнаdate- желаната дата във формат yyyy-mm-dd (напр. 2025-09-06)file_name- име на експортния файл с разширението
Налични формати:
- 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
Примерна API заявка с cURL
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
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Dongchedi е водеща платформа за автомобили в Китай. Милиони хора я използват, за да купуват, продават и проучват автомобили. Дилъри и частни лица публикуват обяви за нови и употребявани автомобили, мотоциклети и товарни автомобили в големите градове.
Всяка обява включва ясни характеристики, висококачествени снимки, история на цените и проверки на продавача. Можете да филтрирате по марка, модел, година, цена и местоположение, за да намерите бързо подходящия автомобил.
Освен обяви Dongchedi предлага новини, отзиви, паралелни сравнения и информация за пазара, за да помогне на купувачите да вземат решение с увереност. Тесните връзки с проверени продавачи и официални дилъри поддържат качеството високо.
API-то предоставя подредени данни от платформата Dongchedi чрез надеждни крайни точки. Използвайте го в приложенията си за ценообразуване, следене на наличностите и анализ на пазара.
Нашето API в реално време работи 24/7, като открива нови обяви в рамките на минути и следи премахнатите обяви, за да отразява реалните движения на пазара. Не са нужни собствени парсъри или кроулъри.
Разширете покритието на автомобилните си данни по световните пазари с нашите API за отделните платформи: