# Dongchedi Scraper (`maximedupre/dongchedi`) Actor

Collect public Dongchedi used-car listings, homepage car selections, brands, news, and videos. Get prices, vehicle facts, authors, and source media links when available for car and content research.

- **URL**: https://apify.com/maximedupre/dongchedi.md
- **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community)
- **Categories:** E-commerce, Videos, News
- **Stats:** 4 total users, 2 monthly users, 88.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.25 / 1,000 used-car listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### 🚗 Dongchedi car and video data for research

Car researchers, dealers, and content teams can collect public Dongchedi data in a structured dataset. Get used-car facts, homepage car selections, brands, news headlines, or video details. Use the saved fields to compare listings, review launches, and study car content.

- Review the homepage selection with [**Dongchedi Hot Cars**](https://apify.com/maximedupre/dongchedi/examples/dongchedi-hot-cars).
- Collect launch prices and details with [**Dongchedi New Car Launches**](https://apify.com/maximedupre/dongchedi/examples/dongchedi-new-car-launches).
- Build a list from the homepage directory with [**Dongchedi Car Brands**](https://apify.com/maximedupre/dongchedi/examples/dongchedi-car-brands).
- Read the homepage feed with [**Dongchedi News Headlines**](https://apify.com/maximedupre/dongchedi/examples/dongchedi-news-headlines).
- Find videos for a topic with [**Dongchedi Video Search**](https://apify.com/maximedupre/dongchedi/examples/dongchedi-video-search).

#### 📋 Car facts, headlines, and video details

Choose one result type for each run:

- **Used cars:** Listing IDs, names, prices in Chinese yuan (CNY), mileage, registration, vehicle specs, public seller details, and photo links when available.
- **Hot cars:** Car names, series IDs, categories, and images from the homepage selection.
- **New car launches:** Names, brands, launch prices in CNY, status, dates, images, and linked article details when available.
- **Car brands:** IDs, names, and logos from the homepage brand directory.
- **News headlines:** Article IDs, titles, and source editorial labels.
- **Videos:** Titles, dates, length, authors, counts, related cars, and source playback links when available.

The Actor saves the first eligible occurrence of each source item as it finds it. Later matches for the same item are ignored. A saved row reflects the first match; it does not gather details from later matching URLs or keywords. Missing optional source details stay absent.

Homepage selections cover the cars and content shown there. They do not cover the full vehicle catalog or login-gated new-car spec pages.

#### ▶️ Run a Dongchedi collection

1. Choose a result type in the Input tab.
2. For Used cars, add public listing or detail URLs. Listing URLs keep their car and location filters.
3. For Videos, add video or discovery URLs, keywords, or categories. Leave all three empty to use the homepage selection.
4. Add any filters that apply to your result type.
5. Set Maximum results, or leave it empty to return all available results until the source is exhausted.
6. Start the run and open Results to read or export the dataset.

#### ⚙️ Input

Only fields for the chosen result type apply. All submitted values share that run's settings. Use a separate run for a different result type or setup.

**Input fields**

| Field | Type | What it does |
|---|---|---|
| resultType | string | Required. Choose usedCars, hotCars, newCars, brands, news, or videos. The form starts with hotCars. |
| usedCarUrls | array of objects | Required for Used cars. Public Dongchedi listing or detail URLs. Listing URLs keep their car and location filters. Each entry has a url string. |
| minPrice | number | Keeps New car launches with a source price at or above this amount in CNY. Must be zero or more. |
| maxPrice | number | Keeps New car launches with a source price at or below this amount in CNY. Must be zero or more and at least minPrice when both are set. |
| videoUrls | array of objects | Public video, profile, category, group, or search URLs. Video URLs fetch those videos; other URLs find videos. Each entry has a url string. |
| videoKeywords | array of strings | Finds videos for each keyword. Can be used with video and discovery URLs. |
| videoCategories | array of strings | Finds videos in the named Dongchedi categories. Use category names shown on Dongchedi. |
| profileVideoType | string | Chooses all, long, or short videos from profile URLs. Leaving it out collects long and short videos. |
| vehicleCategories | array of strings | Filters Hot cars and New car launches by source vehicle category names. Leave empty to keep all categories. |
| brands | array of strings | Filters Hot cars, New car launches, and Car brands by brand name. Leave empty to keep all brands. |
| nameKeyword | string | Keeps Hot cars, New car launches, Car brands, News headlines, or homepage Videos whose name or title contains this text. A model name searches within the homepage car selections. |
| maxItems | integer | Stops after this many results across the run. Must be at least 1 when set. Leave empty to return all available results until the source is exhausted. The form starts with 10. |

**Example input**

This input is copied from a successful run with the default form values.

```json
{
  "resultType": "hotCars",
  "maxItems": 10
}
```

#### 🧾 Output

The Output panel links to the default dataset. Each row uses the shape for the selected result type. The tables below cover all fields; optional fields may be absent. The examples are complete rows saved by the Actor.

**Output panel**

| Field | Type | What it does |
|---|---|---|
| results | string | Opens the saved rows in the default dataset overview. |

**Used-car row**

| Field | Type | What it does |
|---|---|---|
| resultType | string | usedCars for this shape. |
| id | string | Source listing ID. |
| name | string | Vehicle name shown in the listing. |
| brand | object | Vehicle brand. |
| brand.id | string | Source brand ID. |
| brand.name | string | Brand name. |
| series | object | Vehicle series. |
| series.id | string | Source car series ID. |
| series.name | string | Car series name. |
| prices | object | Source prices in CNY. |
| prices.asking | number | Seller asking price in CNY. |
| prices.reference | number | Source reference price in CNY. |
| prices.taxInclusive | number | Source price with tax in CNY. |
| description | string | Listing description. |
| labels | array of strings | Labels shown on the listing. |
| mileageKm | number | Distance driven in kilometers. |
| modelYear | integer | Vehicle model year. |
| registration | object | Source registration facts. |
| registration.date | string | First registration date as shown by the source. |
| registration.location | string | Registration location. |
| ownershipHistory | array of strings | Past ownership facts shown by the source. |
| maintenanceInformation | array of strings | Maintenance facts shown by the source. |
| location | string | Vehicle location. |
| specifications | object | Vehicle specs shown by Dongchedi. |
| specifications.powertrain | string | Engine or motor details. |
| specifications.transmission | string | Transmission details. |
| specifications.drivetrain | string | Drive layout. |
| specifications.frontSuspension | string | Front suspension type. |
| specifications.rearSuspension | string | Rear suspension type. |
| specifications.dimensions | string | Vehicle dimensions with source units. |
| specifications.emissions | string | Emissions standard. |
| specifications.color | string | Vehicle color. |
| imageUrls | array of strings | Source vehicle photo URLs. |
| seller | object | Public seller details shown in the listing. |
| seller.id | string | Source seller ID. |
| seller.name | string | Seller name. |
| seller.address | string | Seller address. |
| seller.businessInformation | string | Public business details. |
| seller.phoneNumbers | array of strings | Public seller phone numbers. |
| seller.location | string | Seller location. |

```json
{
  "resultType": "usedCars",
  "id": "21892931",
  "name": "揽胜极光 2017款 2.0T SE 智耀版",
  "prices": {
    "asking": 53800,
    "reference": 458000,
    "taxInclusive": 499900
  },
  "description": "2017年路虎 揽胜极光2.0T SE 智耀版，查博士S级，最美白外黑内，精品一手车，全车原版，2.0T四驱原厂241匹马力，妥妥小钢炮，9AT变速箱，输出平顺动力强劲，全车配置：无匙进入，一键启动，多功能方向盘，换挡拨片，方向盘加热，氛围灯，定速巡航，大灯清洗，19寸大轮毂，中控大屏导航，启停功能，后桥限滑差速器，全景大天窗，真皮电动座椅，座椅加热，全车雷达，倒车影像，电动尾门，自动大灯，LED行车灯等等，支持分期付款0首付开回家",
  "labels": [
    "懂车帝认证｜3星",
    "含过户费"
  ],
  "mileageKm": 93000,
  "modelYear": 2017,
  "registration": {
    "date": "2017年10月",
    "location": "东莞"
  },
  "ownershipHistory": [
    "过户次数：0次"
  ],
  "maintenanceInformation": [
    "保养方式：无保养"
  ],
  "location": "东莞",
  "specifications": {
    "powertrain": "2.0T 汽油 241马力",
    "transmission": "9挡手自一体",
    "drivetrain": "前置四驱",
    "frontSuspension": "麦弗逊式独立悬挂",
    "rearSuspension": "多连杆式独立悬挂",
    "dimensions": "4370×1900×1635 mm",
    "emissions": "国V",
    "color": "白色"
  },
  "imageUrls": [
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/028b268fdc214ad682bd269bc8c81974~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=F7zzLUmPWiYmQNsPJCBUPyLyCSY%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/3d2c019dba2c4b2781c0d13e367a2185~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=xPGCsufVAkzbIpddH2k7Tv355P4%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/db5e3e9a065f400db5e21338a60dc48b~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=W8jnJvfVGFoNn%2F7an1Y5tnyfu%2B8%3D&psm=motor.sh.item",
    "https://p9-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/a2f46a36eb2a44ae900bf164dbf139b8~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=SQFV8QXb6D0SmkVWAlM4nRE5HSY%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/3eb76abdbdec497fab34d05889d78d8a~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=lvv9tPMCP0xILjO4kD64Qb57QOw%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/41f0eaeb949a4b7599a9a7db7991f166~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=A3tpf3ZRutWJboBVO7D%2BAssqJwI%3D&psm=motor.sh.item",
    "https://p9-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/7960afc2b0724c9ca346c1f97408dd22~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=Fd1eAKBahvd3s8XiV3CDovZLzEI%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/6ead6d8f1bf34d7fb0aa7fa9730dedf0~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=SSK0Mntdn6io4oS9qwXvxUEX3eI%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/933ac3f8075d4983952d724a27081cf2~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=edPRt8EFPBye7yEjMdGakDWsAhY%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/b4277fd6e94949e0bb0518dface230e8~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=1m%2Fo%2FspMTLMicw6mDArTeVOR5GA%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/3899a370784344e08c2e1abafed7a744~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=xPBfLp%2BjlUYRTYwwnQYYQedA2c4%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/627a647ce7bf4b81b5c0dfa5eba9cb4f~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=WGNBvMQFJA2EgrQBTe8Y3Bna5CM%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/da2c27317a8443e091b137ba5bada3b3~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=lm3tWFNU6xkhSq3jUc1Ic2tWeV8%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/87e8fd1d37c84f9f8911da908466a6d1~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=B%2FX80XVbTjHhvJP8FlNJyUoWbp4%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/e2d319b85dda4f2a9dc86e7f907cffd2~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=%2BD1DVhUOMXxaWwAiMsgxqQamNoE%3D&psm=motor.sh.item",
    "https://p9-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/aeb404de606e470686e09f29ea18b7cc~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=mfGI1dKiHLZKBVDTvvRCUrd04D4%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/53e628ef664f4771b5010feb7394882b~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=A4sh6gXzcXNet%2Fz0bRMIr%2BRYf7c%3D&psm=motor.sh.item",
    "https://p9-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/f66ddee862954819bc4dfc852a69996e~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=onEFBH%2B7b243vd8QqhKC%2BibmwDw%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/5c3f63733b9140799a8486d025893d9d~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=K%2Bg7Js9bPuddqY0UcuuU1X%2Fzy5s%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/09c00871a6784854b3b4ac28dd283da9~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=vZu65vdTnMPS%2BO3G81nnOmy8AYQ%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/bcfd1bc1e07e4ed3a271bb370c23a4ef~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=0eOdswwaX16PXCY0nRmXBdEP%2FbE%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/e6b430374cf04edab1c0d6f681d55d5a~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=Wy4aMblXJJ8XZhjTZYEyqWBT%2BA4%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/6d60d99735c346fc9b8b1054aba875d9~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=VwZuusU5G5cC0PGa72kwj9bYW6g%3D&psm=motor.sh.item",
    "https://p9-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/15c68a7e244740c7883e5e36073ed286~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=LeKGQRGnHfLjaAmdFE9mln7I2dE%3D&psm=motor.sh.item",
    "https://p3-dcd-sign.byteimg.com/tos-cn-i-f042mdwyw7/a177bb28660e4c3293fe803c165cbb52~tplv-f042mdwyw7-original:1536:0.jpg?lk3s=6c99a4fc&x-expires=1793866855&x-signature=Z%2FXX853jY6kJYbIEAgsAc5NgaIM%3D&psm=motor.sh.item"
  ],
  "seller": {
    "id": "61260",
    "name": "东莞市竣兴汽车销售有限公司",
    "address": "广东省东莞市塘厦镇塘厦大道北406号101房",
    "businessInformation": "00:00-23:59；售全国",
    "location": "东莞",
    "phoneNumbers": [
      "15696433925"
    ]
  },
  "brand": {
    "id": "19",
    "name": "路虎"
  },
  "series": {
    "id": "993",
    "name": "揽胜极光"
  }
}
```

**Hot-car row**

| Field | Type | What it does |
|---|---|---|
| resultType | string | hotCars for this shape. |
| id | string | Source car series ID. |
| name | string | Vehicle name. |
| category | string | Homepage hot-car category. |
| brand | object | Vehicle brand. |
| brand.id | string | Source brand ID. |
| brand.name | string | Brand name shown by Dongchedi. |
| brand.imageUrl | string | Source brand image URL. |
| imageUrl | string | Source vehicle image URL. |

```json
{
  "resultType": "hotCars",
  "id": "99",
  "name": "奥迪A6L",
  "category": "轿车",
  "brand": {
    "id": "2",
    "name": "奥迪",
    "imageUrl": "https://p1-dcd.byteimg.com/img/motor-mis-img/62946ba030f3589e083d8d3e98a595eb~tplv-resize:100:100.image"
  },
  "imageUrl": "http://p3-dcd.byteimg.com/tos-cn-i-dcdx/91eaac8446114757841144c12ddb8d37~tplv-f042mdwyw7-original:640:0.png?psm=motor.pc_car.api"
}
```

**New-car launch row**

| Field | Type | What it does |
|---|---|---|
| resultType | string | newCars for this shape. |
| id | string | Source car series ID. |
| name | string | Vehicle name. |
| category | string | Vehicle category shown by the source. |
| brand | object | Vehicle brand. |
| brand.id | string | Source brand ID. |
| brand.name | string | Brand name shown by Dongchedi. |
| brand.imageUrl | string | Source brand image URL. |
| prices | object | Launch prices in CNY. |
| prices.minimum | number | Lowest source launch price in CNY. |
| prices.maximum | number | Highest source launch price in CNY. |
| launchStatus | string | Source launch status. |
| releaseClassification | string | Source release label. |
| releaseDate | string | Release date supplied by the source. |
| energyType | string | Source energy type. |
| imageUrls | array of strings | Source vehicle image URLs. |
| article | object | Article linked to the launch. |
| article.id | string | Source article ID. |
| article.title | string | Article headline. |
| article.url | string | Article URL supplied by the source. |

```json
{
  "resultType": "newCars",
  "id": "3762",
  "name": "Model 3",
  "category": "轿车",
  "brand": {
    "id": "63",
    "name": "特斯拉",
    "imageUrl": "https://p1-dcd.byteimg.com/img/motor-mis-img/222f2748c0d6e9c69c00a304f2ac8da1~tplv-resize:100:100.image"
  },
  "prices": {
    "minimum": 235500,
    "maximum": 339500
  },
  "launchStatus": "预售价",
  "releaseClassification": "小改款",
  "releaseDate": "2026-09-30T16:00:00.000Z",
  "energyType": "1",
  "imageUrls": [
    "http://p3-dcd.byteimg.com/tos-cn-i-dcdx/f1cb1d06a54f44e0a4b8c7eefd1791cd~tplv-f042mdwyw7-original:640:0.png?psm=motor.pc_car.api"
  ],
  "article": {
    "id": "7577201990271582744",
    "title": "特斯拉Model 3配置升级",
    "url": "https://www.dongchedi.com/article/7577201990271582744"
  }
}
```

**Car-brand row**

| Field | Type | What it does |
|---|---|---|
| resultType | string | brands for this shape. |
| id | string | Source brand ID. |
| name | string | Brand name. |
| logoUrl | string | Source brand logo URL. |

```json
{
  "resultType": "brands",
  "id": "2",
  "name": "奥迪",
  "logoUrl": "https://p1-dcd.byteimg.com/img/motor-mis-img/62946ba030f3589e083d8d3e98a595eb~tplv-resize:100:100.image"
}
```

**News-headline row**

| Field | Type | What it does |
|---|---|---|
| resultType | string | news for this shape. |
| id | string | Source article ID. |
| title | string | News headline. |
| editorialClassifications | array of strings | Editorial labels shown by the source. |

```json
{
  "resultType": "news",
  "id": "7691207700407353880",
  "title": "小鹏G9L配置有亮点",
  "editorialClassifications": [
    "hot:1",
    "article_type:2",
    "is_video:true"
  ]
}
```

**Video row**

| Field | Type | What it does |
|---|---|---|
| resultType | string | videos for this shape. |
| id | string | Source video ID. |
| title | string | Video title. |
| description | string | Video description. |
| publishedAt | string | Publication date and time supplied by the source. |
| durationSeconds | number | Video length in seconds. |
| coverUrl | string | Source video cover URL. |
| author | object | Public video author. |
| author.id | string | Source author ID. |
| author.name | string | Author name. |
| author.avatarUrl | string | Source author avatar URL. |
| viewCount | integer | View or watch count reported by the source. |
| likeCount | integer | Source like count. |
| commentCount | integer | Source comment count. |
| shareCount | integer | Source share count. |
| column | object | Source video column. |
| column.id | string | Source column ID. |
| column.name | string | Column name. |
| relatedCars | array of objects | Car series linked to the video. |
| relatedCars\[].id | string | Source car series ID. |
| relatedCars\[].name | string | Car series name. |
| relatedCars\[].imageUrl | string | Source car series image URL. |
| relatedCars\[].officialPrice | string | Source official price text with units. |
| relatedCars\[].dealerPrice | string | Source dealer price text with units. |
| variants | array of objects | Available source playback files by quality. |
| variants\[].url | string | Source playback or download URL. May expire. |
| variants\[].quality | string | Source quality name. |
| variants\[].width | integer | Video width in pixels. |
| variants\[].height | integer | Video height in pixels. |
| variants\[].format | string | Source file format. |
| variants\[].codec | string | Source video codec. |
| variants\[].bitrate | number | Bitrate in bits per second. |
| variants\[].fileSizeBytes | integer | File size in bytes. |
| variants\[].expiresAt | string | Link expiration time supplied by the source. |

```json
{
  "resultType": "videos",
  "id": "7604448736311624216",
  "title": "血亏3万！含泪整理二手车卖车指南！车商/平台/个人究竟该选谁？",
  "description": "刚刚做完整备的二手车想要再次出手会亏多少钱？车商估价逻辑从何而来？车商、个人、平台三种渠道，卖到哪里才能不亏钱？别急，我们整理了一份卖车SOP帮你避坑。",
  "publishedAt": "2026-02-09T05:00:00.000Z",
  "durationSeconds": 1094,
  "coverUrl": "http://p9-dcd-sign.byteimg.com/motor-article-img/9639059c8f0340d4b98de2f97ee885e4~tplv-f042mdwyw7-original:640:0.image?rk3s=87dec8b9&x-expires=1791880250&x-signature=XFOeuhjg4pp3H8daCxqJaQvtFKA%3D&psm=motor.pc_content.api",
  "author": {
    "id": "6480145787",
    "name": "懂车帝原创",
    "avatarUrl": "https://p6-passport.byteacctimg.com/img/user-avatar/415a8a7d4f8f01e02234093f12be3716~300x300.image"
  },
  "viewCount": 1168717,
  "likeCount": 335,
  "commentCount": 31,
  "relatedCars": [
    {
      "id": "3762",
      "name": "Model 3",
      "imageUrl": "http://p3-dcd.byteimg.com/tos-cn-i-dcdx/f1cb1d06a54f44e0a4b8c7eefd1791cd~tplv-f042mdwyw7-original:640:0.image?psm=motor.pc_content.api",
      "officialPrice": "23.55-33.95万",
      "dealerPrice": "23.55-33.95万"
    },
    {
      "id": "145",
      "name": "宝马3系",
      "imageUrl": "http://p3-dcd.byteimg.com/tos-cn-i-dcdx/8a3daca02bc04bfea188f572f278aaf6~tplv-f042mdwyw7-original:640:0.image?psm=motor.pc_content.api",
      "officialPrice": "25.80-39.99万",
      "dealerPrice": "20.80-28.99万"
    },
    {
      "id": "96",
      "name": "奥迪A4L",
      "imageUrl": "http://p3-dcd.byteimg.com/tos-cn-i-dcdx/da440185e7f349d6b0d58938facb129d~tplv-f042mdwyw7-original:640:0.image?psm=motor.pc_content.api",
      "officialPrice": "28.98-36.28万",
      "dealerPrice": "18.84-23.58万"
    }
  ],
  "variants": [
    {
      "url": "https://v26-microapp-dcar.dcarvod.com/7129522f88abf9b978eb476435b313fd/6ac4c44a/video/tos/cn/tos-cn-v-4ab82c/okD7cTbeenCMjdGH1B4IdvIAhLTwNEwDJEIQBe/?a=36&ch=0&cr=0&dr=0&er=0&lr=unwatermarked&cd=0%7C0%7C0%7C0&cv=1&br=731&bt=731&cs=0&ds=2&ft=k7cKGVVywf-RFm8Zmo~ySqTeaApQ0gYVvrK8MMrSto0g3cI&mime_type=video_mp4&qs=0&rc=Ozk0NWY4aWg6NTw5Nzg7OEBpamo0d3g5cjs5OTczNGRpM0BfXjM2YF81NmMxMjQ0NjIzYSNzMW9xMmRzazFhLS1kXi9zcw%3D%3D&btag=80000e00038000&dy_q=1791275508&feature_id=a86f30d13437b00b109e4117546eca60&l=20261006163148DF758436F031153352E3",
      "quality": "480p",
      "width": 854,
      "height": 480,
      "format": "mp4",
      "codec": "h264",
      "bitrate": 749056,
      "fileSizeBytes": 102464810,
      "expiresAt": "2026-10-06T09:50:02.000Z"
    },
    {
      "url": "https://v26-microapp-dcar.dcarvod.com/75f3706dd6264d09f0c921f5500f44a4/6ac4c44a/video/tos/cn/tos-cn-v-4ab82c/owuwITkVGCSpwEEpaiFfABgIhcyAufI3poD96j/?a=36&ch=0&cr=0&dr=0&er=0&lr=unwatermarked&cd=0%7C0%7C0%7C0&cv=1&br=1257&bt=1257&cs=0&ds=3&ft=k7cKGVVywf-RFm8Zmo~ySqTeaApQ0gYVvrK8MMrSto0g3cI&mime_type=video_mp4&qs=0&rc=ZDo2OmlkZjYzZTs3N2Y7OEBpamo0d3g5cjs5OTczNGRpM0AxNjYvMjAvXmIxMjReY2JjYSNzMW9xMmRzazFhLS1kXi9zcw%3D%3D&btag=80000e00038000&dy_q=1791275508&feature_id=a86f30d13437b00b109e4117546eca60&l=20261006163148DF758436F031153352E3",
      "quality": "720p",
      "width": 1280,
      "height": 720,
      "format": "mp4",
      "codec": "h264",
      "bitrate": 1287848,
      "fileSizeBytes": 176167117,
      "expiresAt": "2026-10-06T09:50:02.000Z"
    },
    {
      "url": "https://v26-microapp-dcar.dcarvod.com/5270d06d4e2692aad54c9693a705e719/6ac4c44a/video/tos/cn/tos-cn-v-4ab82c/o0DIHvdIldThpIiQ5CLTncmGAeE7eBKYeNE1J7/?a=36&ch=0&cr=0&dr=0&er=0&lr=unwatermarked&cd=0%7C0%7C0%7C0&cv=1&br=2384&bt=2384&cs=0&ds=4&ft=k7cKGVVywf-RFm8Zmo~ySqTeaApQ0gYVvrK8MMrSto0g3cI&mime_type=video_mp4&qs=0&rc=Nzw2Ojo1NGdlN2VkZTk6OEBpamo0d3g5cjs5OTczNGRpM0A1MC5eL2MyNjIxNGJeMjMyYSNzMW9xMmRzazFhLS1kXi9zcw%3D%3D&btag=80000e00038000&dy_q=1791275508&feature_id=a86f30d13437b00b109e4117546eca60&l=20261006163148DF758436F031153352E3",
      "quality": "1080p",
      "width": 1920,
      "height": 1080,
      "format": "mp4",
      "codec": "h264",
      "bitrate": 2442130,
      "fileSizeBytes": 334063252,
      "expiresAt": "2026-10-06T09:50:02.000Z"
    },
    {
      "url": "https://v26-microapp-dcar.dcarvod.com/b98f9d8ab5f8317ecc75dfc9adc8410b/6ac4c44a/video/tos/cn/tos-cn-v-4ab82c/osedd8EGTC57DyJLIQCN4nQv1BhQeEWAdTIe0H/?a=36&ch=0&cr=0&dr=0&er=0&lr=unwatermarked&cd=0%7C0%7C0%7C0&cv=1&br=6767&bt=6767&cs=0&ds=10&ft=k7cKGVVywf-RFm8Zmo~ySqTeaApQ0gYVvrK8MMrSto0g3cI&mime_type=video_mp4&qs=0&rc=OTg6M2VnZzZoNzNkNjw5PEBpamo0d3g5cjs5OTczNGRpM0BgYmMuLWE2NjUxMjIvMC82YSNzMW9xMmRzazFhLS1kXi9zcw%3D%3D&btag=80000e00038000&dy_q=1791275508&feature_id=a86f30d13437b00b109e4117546eca60&l=20261006163148DF758436F031153352E3",
      "quality": "4k",
      "width": 3840,
      "height": 2160,
      "format": "mp4",
      "codec": "h264",
      "bitrate": 6929769,
      "fileSizeBytes": 947935314,
      "expiresAt": "2026-10-06T09:50:02.000Z"
    }
  ],
  "column": {
    "id": "1385",
    "name": "猎车旗舰店"
  }
}
```

#### 💳 Pricing

This Actor uses pay-per-event pricing. One charge applies to each saved outcome of the chosen type.

| Event | Charged for |
|---|---|
| Used-car listing | One saved used-car listing with available details. |
| Hot car | One saved car from the homepage hot-car selection. |
| New-car launch | One saved homepage new-car launch with available details. |
| Car brand | One saved brand from the homepage directory. |
| News headline | One saved homepage news headline. |
| Video metadata | One saved video with available details and playback links. Video quality options do not add charges. |

No saved outcome means no charge for these events. See the Store pricing panel for current prices by Apify plan.

#### 🔌 Integrations

Start runs and read the saved dataset through the Apify API. You can also export rows from Apify for your own car or content research workflow.

https://www.youtube.com/watch?v=bNACk1_S_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4

#### ❓ FAQ

##### Will video playback links keep working?

The files stay at the source. Links can expire, and expiresAt is included when the source provides it. The Actor does not host permanent video copies or change the video files.

##### Can I collect a full car catalog or new-car spec library?

The Hot cars, New car launches, and Car brands choices read homepage selections. They do not cover the full catalog or login-gated new-car spec libraries. Used-car URLs can return the vehicle facts shown on those public listings.

##### What happens when the same car or video matches more than once?

The first eligible occurrence is saved as it is found. Later matches are ignored, and the saved row is not rewritten to combine them.

##### How do I collect videos from a profile?

Add a public profile URL to videoUrls. Choose all, long, or short with profileVideoType. If you leave that field out, the Actor collects long and short videos.

##### What happens when I leave the video sources empty?

When videoUrls, videoKeywords, and videoCategories are all empty, Videos uses the homepage selection. nameKeyword can filter that selection by title.

##### What currency are the car prices in?

Used-car prices and new-car launch prices are numbers in Chinese yuan (CNY). Related-car prices in video rows stay as source text with their units.

##### Why are some fields missing?

The source may not provide every detail. The Actor keeps available fields and does not invent missing values.

##### What happens when Maximum results is empty?

The Actor returns all available results until the source is exhausted. Homepage choices are still limited to the current homepage selection.

##### Do I need a Dongchedi login or API key?

No. This Actor collects public Dongchedi data without buyer-supplied Dongchedi credentials.

##### Where is the official Dongchedi website?

The source website is [dongchedi.com](https://www.dongchedi.com/). This Actor collects public data from that site.

### 📝 Changelog

**v0.0** (06-10-2026)

- Initial release.

### 🆘 Support

For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~dongchedi/issues) and I'll fix or implement it in less than 24h 🫡

### 🔗 Related Actors

- [CarAndBike India Used Car Scraper](https://apify.com/maximedupre/carandbike) collects Indian used-car listing prices, mileage, sellers, and images.
- [Carsales.com.au Scraper](https://apify.com/maximedupre/carsales-scraper) collects Australian vehicle listings for price and inventory research.
- [Douyin Search Scraper](https://apify.com/maximedupre/douyin-search-scraper) finds public Douyin posts by keyword for car-topic and video research.
- [Dongchedi Used Cars Scraper](https://apify.com/natanielsantos/dongchedi-used-cars-scraper) offers another Dongchedi used-car listing and detail workflow.
- [Dongchedi Video Scraper](https://apify.com/natanielsantos/dongchedi-video-scraper) offers another Dongchedi video collection workflow using public URLs and search terms.

**Made with ❤️ by Maxime Dupré**

# Actor input Schema

## `resultType` (type: `string`):

Choose the kind of rows to collect. Homepage choices cover the homepage selection, not the full car catalog.

## `usedCarUrls` (type: `array`):

Add public Dongchedi used-car listing or detail URLs. Listing URLs keep their car and location filters. Required for Used cars.

## `minPrice` (type: `number`):

Keep New car launches with a source price at or above this amount in Chinese yuan (CNY).

## `maxPrice` (type: `number`):

Keep New car launches with a source price at or below this amount in Chinese yuan (CNY). Must be at least the lowest price if both are set.

## `videoUrls` (type: `array`):

Add public Dongchedi video, profile, category, group, or search URLs. Video URLs fetch those videos; other URLs find videos.

## `videoKeywords` (type: `array`):

Find videos for each keyword. You may use these with video and discovery URLs.

## `videoCategories` (type: `array`):

Find videos in these Dongchedi categories. Enter the category names shown on Dongchedi.

## `profileVideoType` (type: `string`):

Choose which videos to collect from profile URLs. If left out, collect long and short videos.

## `vehicleCategories` (type: `array`):

Filter Hot cars and New car launches by the vehicle category names shown on Dongchedi. Leave empty to keep all categories.

## `brands` (type: `array`):

Filter Hot cars, New car launches, and Car brands by brand name. Leave empty to keep all brands.

## `nameKeyword` (type: `string`):

Keep Hot cars, New car launches, Car brands, News headlines, or homepage Videos whose name or title contains this text. Use a model name to find it within the homepage car selections.

## `maxItems` (type: `integer`):

Stop after this many results across the run. Leave empty to return all available results until the source is exhausted.

## Actor input object example

```json
{
  "resultType": "hotCars",
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

View the collected result rows.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "resultType": "hotCars",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("maximedupre/dongchedi").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "resultType": "hotCars",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("maximedupre/dongchedi").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "resultType": "hotCars",
  "maxItems": 10
}' |
apify call maximedupre/dongchedi --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,maximedupre/dongchedi"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/MENb1rITWNFr39nQS/builds/EXeOMGud1Zb55pdMH/openapi.json