Dongchedi API

China's used-car market, with the inspection report attached

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.

endpoints
5
credit per call
1

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

POST/dongchedi/v1/search200
  1. 北京越野BJ90 2021款 4.0T 尊驾版137,800
    brand
    北京越野
    series
    北京越野BJ90
  2. 微蓝6 PHEV 2022款 互联智享型52,800
    brand
    别克
    series
    微蓝6 PHEV
  3. 捷豹XFL 2022款 2.0T P250 两驱尊享豪华版145,800
    brand
    捷豹
    series
    捷豹XFL
Real result, captured Nov 10, 20263 of 20
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Dongchedi API

3 of 5 endpoints, ready to run

View docs ↗

Live listings with the price in yuan and in 万元, the new-car guide price, mileage in kilometres, the registration year, the city the car is in and the city it is registered in, the transfer count and the dealer id. Nineteen filter parameters and six sort orders, each one checked against what came back. Eight filters the site shows but its API ignores are simply not offered.

1 credit0 required · 6 optional
POST/dongchedi/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Dongchedi endpoints does ReefAPI ship?

5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

5 endpoints

search

1 cr

Search Dongchedi's live used-car inventory (懂车帝二手车).

required
—
optional
city, brand_id, series_id, min_price, max_price, min_year, max_year, min_mileage_km, max_mileage_km, fuel, gearbox, vehicle_type, size_class, displacement, drivetrain, emission_standard, origin, with_inspection_report, dongchedi_operated, sort, page, limit

car_detail

1 cr

Everything Dongchedi publishes about one used car.

required
listing_id
optional
include_report

brands

1 cr

Every car brand Dongchedi knows, with the brand_id that search and series take, its Chinese n…

required
—
optional
letter

series

1 cr

The model series of one brand that have used cars on Dongchedi, with the series_id that searc…

required
brand_id
optional
city

cities

1 cr

All cities Dongchedi's used-car search accepts (Chinese names, the value search's city takes)…

required
—
optional
—

Every parameter, every allowed value →

Missing a Dongchedi endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Dongchedi API works

Dongchedi is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 632 engines.

02
Call
POST /dongchedi/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 credit per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

Price one model across Chinese cities

Ids first, then the filtered search, then the detail only for the cars you shortlist.

01series
POST/dongchedi/v1/series
{"brand_id": 2}

Audi's series with used stock: 奥迪A6L is 99.

02search
POST/dongchedi/v1/search
{"city": "北京", "series_id": 99, "min_year": 2020, "limit": 80}

Up to 80 rows a page with price, mileage, registration year and the source's own total.

03car_detail
POST/dongchedi/v1/car_detail
{"listing_id": "<id from a row>"}

The inspection report and the price-versus-similar-cars block are where this source is stronger than the others.

A priced, mileage-stamped slice of one model in one city, with a condition report for the cars you care about.

request
curl -X POST https://api.reefapi.com/dongchedi/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"limit":20}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "dongchedi",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Coverage

What the source gives, what it hides, and what we checked

Measured on 2026-11-10 across 11 cities plus nationwide, 18 search bodies and 12 listings.

Against us: no VIN

Dongchedi does not publish a VIN or chassis number. vin is null with vin_published false. Join by brand, series, trim id, registration month and mileage.

Every detail call checks its own price

Each car_detail response compares the price we return with the plain integer price the same source response carries. It matched on every listing we measured, and the search price agreed with the detail price on 12 of 12 listings. If the two ever disagree, the call fails instead of returning a wrong number.

Two prices, two units

price_cny is yuan; price_wan_cny is the 万元 figure the market quotes (6.88 means 68,800 yuan). The new-car guide price comes the same way; where the source says 暂无报价 (no guide price) the number is null and the text is in new_car_price_display.

Against us: the total stops at 10,000

Dongchedi's total saturates at 10,000 and paging stops at 10,000 rows per filter (total_capped tells you). Narrow by city, brand or series to see everything.

Against us: no keyword search

The used-car API has no free-text search. Use brands and series to get ids.

The car's city is not always where it is registered

city is where the car is; registration_city is where it is plated. They differ: one measured car was registered in Shanghai and on sale in Guangzhou.

Inspection reports are common here

13 of 16 detail calls carried the full third-party report: accident, flood and fire checks, core driving, exterior and interior, each defect with its location and photo. The other 3 answered report_published false.

Chinese text, as published

Titles, colours, spec labels and inspection findings are in Chinese, not machine-translated.

Use cases

What people build with Dongchedi

The jobs this data is most often used for.

5

endpoints

1

credit per call

01

Price-intelligence teams use Dongchedi to search Dongchedi's live used-car inventory (懂车帝二手车).

02

Classifieds aggregators use Dongchedi to get everything Dongchedi publishes about one used car.

03

Resale and arbitrage tools use Dongchedi to get every car brand Dongchedi knows, with the `brand_id` that `search` and `series` take, its Chi….

04

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….

Pricing

What Dongchedi data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 632 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/dongchedi/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"limit":20}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Dongchedi.

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.

Same key

116 Classifieds & Second-hand APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Dongchedi, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 631 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-10.