Dongchedi APIПарсер и скрапер

GET/filters

Cписок доступных фильтров и их значений

Ответ:

{
  "mark": {
    "BMW": {
      "model": {
        "X5": { "complectation": ["xDrive40i", "xDrive50i"] },
        "X3": { "complectation": ["xDrive30i"] }
      }
    },
    "Audi": {
      "model": {
        "A4": { "complectation": ["40 TFSI", "45 TFSI"] }
      }
    }
  },
  "transmission_type": ["Гибрид", "Редуктор", "Автомат", "Механика", "Вариатор", "Робот"],
  "color": ["Серебристый", "Желтый", "Красный", "Фиолетовый", "Другой", "Черный", "Темно-серый", "Белый", "Кофейный", "Оранжевый", "Зеленый", "Синий", "Шампань"],
  "engine_type": ["Гибрид", "Метан", "Подключаемый гибрид", "Дизель", "Бензин/газ", "Последовательный гибрид", "Бензин", "Электро"],
  "drive_type": ["Передний", "Задний", "Полный"]
}

GET/offers

Список объявлений с пагинацией

Параметры:

• page (обязательно) - номер страницы
• mark, model, complectation - фильтры (регистр не важен)
• transmission_type, color, body_type, engine_type, drive_type - фильтры (регистр не важен)
• year_from, year_to - фильтр по годам
• km_age_from, km_age_to - фильтр по пробегу
• price_from, price_to - фильтр по цене (в CNY)

Ответ:

{
  "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": "Белый",
        "price": 268000,
        "km_age": 18500,
        "body_type": "Кроссовер/внедорожник",
        "engine_type": "Гибрид",
        "transmission_type": "Автомат",
        "address": "Beijing, Chaoyang District",
        "is_dealer": true,
        "displacement": 2.0,
        "city": "Beijing",
        "title": "BYD Tang DM 2022 Premium",
        "owners_count": 1,
        "drive_type": "Полный",
        "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 }
}

Поля данных:

GET/change_id

Получить начальный ID изменений на дату

Параметры:

• date (обязательно) - дата в формате гггг-мм-дд

Ответ:

{ "change_id": 2859364 }

Используйте это значение как параметр change_id в /changes

GET/changes

Поток изменений (новые/измененные/удаленные)

Параметры:

• change_id (обязательно) - начиная с какого change_id

Ответ:

{
  "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 }
}

POST/api/v1/offer/info

Парсинг объявления по прямой ссылке

Входные параметры:

• url (обязательно) - полная ссылка на страницу авто

Пример запроса:

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" }'

Ответ:

{
  "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": "Черный",
  "price": 188000,
  "km_age": 221000,
  "engine_type": "Бензин",
  "transmission_type": "Автомат",
  "body_type": "Кроссовер/внедорожник",
  "displacement": "4.7",
  "seller_type": "dealer",
  "is_dealer": true,
  "drive_type": "Полный",
  "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"
  ]
}

Описание полей: