Dongchedi API & Scraper
Dongchedi API returns live Dongchedi data as clean JSON for dongchedi The primary endpoint, search, returns matching records including listing id, spu id, title, brand and brand id.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Dongchedi scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, car_detail, brands, series. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/dongchedi/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"limit": 20
}
}{
"ok": true,
"meta": {
"api": "dongchedi",
"endpoint": "search",
"mode": "live",
"latency_ms": 1184.7,
"record_count": 20,
"bytes": 24955,
"cache_hit": false,
"upstream_requests": 1,
"total_results": 10000,
"charged_credits": 1,
"version": "1.0.0",
"request_id": "a7f39c7827bc4c3d",
"queue_ms": 1.2,
"fetched_at": "2026-11-10T11:25:14.878Z"
},
"data": {
"results": [
{
"listing_id": 357001789,
"spu_id": 357001484,
"url": "https://www.dongchedi.com/usedcar/357001789",
"title": "北京越野BJ90 2021款 4.0T 尊驾版",
"brand": "北京越野",
"brand_id": 52,
"series": "北京越野BJ90",
"series_id": 1647,
"spec_id": 55225,
"trim_name": "4.0T 尊驾版",
"model_year": 2021,
"price_cny": 137800,
"price_wan_cny": 13.78,
"new_car_price_cny": 1288000,
"new_car_price_wan_cny": 128.8,
"new_car_price_display": null,
"mileage_km": 28000,
"mileage_wan_km": 2.8,
"first_registration": "2023",
"year": 2023,
"is_registered": true,
"subtitle": "2023年 | 2.80万公里",
"city": "青岛",
"registration_city": "青岛",
"seller_type": "dealer",
"seller_type_raw": "自营",
"certification": "非官方认证",
"transfer_count": 0,
"dealer_id": 35483,
"image": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/75e7e94a035e4fc88fa574ef20535f42~tplv-f042mdwyw7-auto-webp:480:0.jpg?rk3s=4892dee6&x-expires=1795519514&x-signature=uBojAhgZQM%2Bq67tyP%2BSjdnGw68Y%3D&psm=motor.sh.pack",
"has_video": false,
"tags": [
"检测报告",
"透明一口价"
],
"is_self_trade": false
},
{
"listing_id": 357463590,
"spu_id": 357463126,
"url": "https://www.dongchedi.com/usedcar/357463590",
"title": "微蓝6 PHEV 2022款 互联智享型",
"brand": "别克",
"brand_id": 12,
"series": "微蓝6 PHEV",
"series_id": 2823,
"spec_id": 71444,
"trim_name": "互联智享型",
"model_year": 2022,
"price_cny": 52800,
"price_wan_cny": 5.28,
"new_car_price_cny": 176600,
"new_car_price_wan_cny": 17.66,
"new_car_price_display": null,
"mileage_km": 27000,
"mileage_wan_km": 2.7,
"first_registration": "2023",
"year": 2023,
"is_registered": true,
"subtitle": "2023年 | 2.70万公里",
"city": "沧州",
"registration_city": "郑州",
"seller_type": "dealer",
"seller_type_raw": "自营",
"certification": "非官方认证",
"transfer_count": 1,
"dealer_id": 59429,
"image": "https://p3-dcd.byteimg.com/motor.sh.image/external_138866206_head_image_list/165956c62fa741973047506dc5ef8247~tplv-f042mdwyw7-auto-webp:480:0.jpg?psm=motor.sh.pack",
"has_video": false,
"tags": [
"检测报告",
"透明一口价"
],
"is_self_trade": false
},
{
"listing_id": 356931388,
"spu_id": null,
"url": "https://www.dongchedi.com/usedcar/356931388",
"title": "捷豹XFL 2022款 2.0T P250 两驱尊享豪华版",
"brand": "捷豹",
"brand_id": 31,
"series": "捷豹XFL",
"series_id": 798,
"spec_id": 75717,
"trim_name": "2.0T P250 两驱尊享豪华版",
"model_year": 2022,
"price_cny": 145800,
"price_wan_cny": 14.58,
"new_car_price_cny": 456800,
"new_car_price_wan_cny": 45.68,
"new_car_price_display": null,
"mileage_km": 34000,
"mileage_wan_km": 3.4,
"first_registration": "2022",
"year": 2022,
"is_registered": true,
"subtitle": "2022年 | 3.40万公里",
"city": "长沙",
"registration_city": "长沙",
"seller_type": "dealer",
"seller_type_raw": "自营",
"certification": "非官方认证",
"transfer_count": 0,
"dealer_id": 6204,
"image": "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/d8a96f9e0b094697998092ec7335874a~tplv-f042mdwyw7-auto-webp:480:0.jpg?rk3s=4892dee6&x-expires=1795519514&x-signature=bNLF%2FrZJvUWDoT4BRiKWokb2gtM%3D&psm=motor.sh.pack",
"has_video": false,
"tags": [
"透明一口价"
],
"is_self_trade": false
}
],
"pagination": {
"page": 1,
"per_page": 20,
"total": 10000,
"total_capped": true,
"has_more": true
},
"filters_applied": {
"city": "全国",
"sort": "default"
}
}
}What the Dongchedi API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Dongchedi's live used-car inventory (懂车帝二手车). Filter by city, brand, series, price band, registration year, mileage, fuel, gearbox, vehicle type, size class, displacement, drivetrain, emission standard, origin, inspection report, then sort and page. Each row has price in CNY (and 万), new-car price, mileage in km, first-registration year, the car's city, transfer count, dealer id, photo and tags. Dongchedi's own `total` stops counting at 10 000 (`total_capped: true`), and paging stops at page × limit = 10 000 — narrow the filter to go deeper. There is no free-text keyword search on Dongchedi's used-car API: use `brand_id`/`series_id` (from `brands`/`series`). | Price-intelligence teams call search to search Dongchedi's live used-car inventory (懂车帝二手车). | city, brand_id, series_id, min_price, max_price, ... |
| car_detail | Everything Dongchedi publishes about one used car: price in CNY (and 万), new-car guide price incl. and excl. purchase tax, mileage in km, registration month, car age, transfer count, emission standard, displacement, gearbox, colours, maintenance record type, the car's city and its registration city, dealer (name, address, hours, licence image), power/drivetrain/suspension/dimensions, every photo, the seller's description, Dongchedi's price-vs-market analysis (average/min/max of similar cars) and the full third-party inspection report (accident, flood, fire, core-driving and exterior checks with every defect and its photo). The VIN is not published — `vin` is always null. | Classifieds aggregators call car_detail to get everything Dongchedi publishes about one used car. | listing_id, include_report |
| brands | Every car brand Dongchedi knows, with the `brand_id` that `search` and `series` take, its Chinese name, pinyin initial and logo. | Resale and arbitrage tools call brands to get every car brand Dongchedi knows, with the `brand_id` that `search` and `series` take, its Chi…. | letter |
| series | The model series of one brand that have used cars on Dongchedi, with the `series_id` that `search` takes. | Lead-generation teams call series to get the model series of one brand that have used cars on Dongchedi, with the `series_id` that `se…. | brand_id, city |
| cities | All cities Dongchedi's used-car search accepts (Chinese names, the value `search`'s `city` takes) with their pinyin initial. | Price-intelligence teams call cities to get all cities Dongchedi's used-car search accepts (Chinese names, the value `search`'s `city` ta…. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/dongchedi/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"limit":20}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/dongchedi/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"limit": 20
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/dongchedi/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"limit": 20
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.dongchedi.search with {"limit":20}.Who uses this API and why
- Price-intelligence teams use Dongchedi to search Dongchedi's live used-car inventory (懂车帝二手车).
- Classifieds aggregators use Dongchedi to get everything Dongchedi publishes about one used car.
- Resale and arbitrage tools use Dongchedi to get every car brand Dongchedi knows, with the `brand_id` that `search` and `series` take, its Chi….
- Lead-generation teams use Dongchedi to get the model series of one brand that have used cars on Dongchedi, with the `series_id` that `se….
- Price-intelligence teams use Dongchedi to get all cities Dongchedi's used-car search accepts (Chinese names, the value `search`'s `city` ta….
Questions developers ask before integrating
What is the Dongchedi API?
Dongchedi API is a ReefAPI endpoint group for dongchedi It returns live JSON through POST requests under /dongchedi/v1.
Is the Dongchedi API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Dongchedi calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Dongchedi login or account?
No login to Dongchedi is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Dongchedi data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Dongchedi API use?
Dongchedi actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Dongchedi from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call dongchedi actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Dongchedi API a Dongchedi scraper?
It is the managed alternative to a DIY Dongchedi scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same dongchedi back as clean JSON.
Why does my Dongchedi scraper keep getting blocked?
Most Dongchedi scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.