Che168 APIПарсер, скрапер и краулер

GET/filters

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

Ответ:

{
  "mark": {
    "BMW": { "model": ["X5", "X3", "3 Series"] },
    "Audi": { "model": ["A4", "A6", "Q7"] }
  },
  "transmission_type": ["Механическая", "Автоматическая"],
  "color": ["Красный", "Фиолетовый", "Серебристо-серый", "Желтый", "Черный", "Другой", "Коричневый", "Синий", "Темно-серый", "Белый", "Оранжевый", "Зеленый", "Шампань"],
  "body_type": ["Минивэн", "Седан", "Пикап", "Фургон", "Микроавтобус", "Легкий грузовик", "Седан/хэтчбек", "Кроссовер/внедорожник", "Купе/родстер", "Хэтчбек", "Малолитражка"],
  "engine_type": ["Дизельный", "Бензиновый + 48V mild hybrid", "Гибридный (HEV)", "Бензиновый + 90V mild hybrid", "Бензиновый с электроприводом", "Подключаемый гибрид (PHEV)", "Бензиновый + CNG", "Расширитель диапазона (REEV)", "Бензиновый", "Бензиновый + 24V mild hybrid", "Бензиновый + природный газ", "Дизельный + 48V mild hybrid", "Электрический (BEV)"],
  "drive_type": ["Передний привод", "Задний привод", "Полный привод", "Задний привод (2 мотора)", "Полный привод (2 мотора)", "Полный привод (3 мотора)", "Полный привод (4 мотора)"]
}

GET/offers

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

Параметры:

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

Ответ:

{
  "result": [
    {
      "id": 1273379,
      "inner_id": "55651236",
      "change_type": "added",
      "created_at": "2025-08-05T08:18:10.679Z",
      "data": {
        "id": 1273379,
        "inner_id": "55651236",
        "url": "https://www.che168.com/dealer/648815/55651236.html",
        "mark": "Lamborghini",
        "model": "Huracán",
        "title": "Huracán 2020 Huracán EVO RWD",
        "year": 2020,
        "color": "Красный",
        "price": 1890000,
        "km_age": 19000,
        "engine_type": "Бензиновый",
        "transmission_type": "Автоматическая",
        "body_type": "Купе/родстер",
        "drive_type": "Задний привод (среднемоторная)",
        "address": "Shanghai, Minhang",
        "seller_type": "dealer",
        "is_dealer": true,
        "section": "Used",
        "salon_id": "648815",
        "description": "Shanghai Luxury Car Store: 166 detailed inspections...",
        "displacement": 5.2,
        "offer_created": "2025-08-05",
        "images": ["https://2sc2.autoimg.cn/escimg/auto/g34/M04/C4/EC/..."],
        "extra": {"inspection": {...}, "configuration": {...}},
        "power": 610
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Поля данных:

GET/change_id

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

Параметры:

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

Ответ:

{ "change_id": 3294715 }

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

GET/changes

Поток изменений в реальном времени

Параметры:

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

Ответ:

{
  "result": [
    {
      "id": 456,
      "inner_id": "55651236",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "55651237",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 1790000 }
    },
    {
      "id": 458,
      "inner_id": "55651238",
      "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

Получить данные объявления с che168.com по URL

Параметры:

• url (обязательно) - link to the listing on che168.com

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

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.che168.com/dealer/413863/56520004.html" }'

Ответ:

{
  "inner_id": "56520004",
  "url": "https://www.che168.com/dealer/413863/56520004.html",
  "mark": "Ora",
  "model": "Black Cat",
  "year": 2020,
  "color": "Белый",
  "price": 31800,
  "km_age": 54000,
  "engine_type": "Электрический (BEV)",
  "transmission_type": "Автоматическая",
  "body_type": "Малолитражка",
  "drive_type": "Передний привод",
  "displacement": "0",
  "vin": "LGWECMA47LE008164",
  "city": "Shenzhen",
  "seller_type": "dealer",
  "is_dealer": true,
  "offer_created": "2025-12-04",
  "images": [
    "https://2sc2.autoimg.cn/escimg/auto/g33/M0B/AE/D7/1024x768_c42_autohomecar__ChxpVWj8TteALlI3AAnIctts-w8397.jpg.webp",
    "https://2sc2.autoimg.cn/escimg/auto/g34/M0B/A3/C5/1024x768_c42_autohomecar__ChxpWGj8TtiAJ0EJAAq9t0PZjQc486.jpg.webp"
  ],
  "power": 61,
  "first_registration": "2020-09"
}

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