AUTO-API.COM
Лого на Che168.com

Che168 APIScraper & Parser

Достъп до данни от китайска платформа за автомобили. Пълно оборудване на версията, VIN номера, доклади от проверката. Обновявания в обявите чрез API.

Официални SDK библиотеки

Всяка библиотека идва с типизирани отговори и вградена обработка на грешки. Просто я инсталирайте и задайте API ключа си за Che168.

Che168 API

Получавайте данни за автомобили от Китай директно чрез API. Директен достъп до информация за автомобилите, без да разработвате скрейпъри. Идеално за проучване на пазара, анализ на цените и бизнес анализи.

API

Получавайте известия, когато в Che168 се появят новопостъпили автомобили. Следете обявите от момента на публикуването им.

Ежедневни експорти

Ежедневни файлове с всички текущи обяви и данни за цените.

Пълни данни

Получавайте форматирани данни чрез API: цена, пробег, година, марка, модел, технически характеристики, пълно оборудване на версията, доклади от проверката и състояние на автомобила.

Получете достъп до APIДостъпът се предоставя до 2 минути

Обявата идва с характеристиките и пълното оборудване на версията, оборудването, посочено в обявата, и оценката на цената от che168.

Базов URL

https://{access_name}.auto-api.com/api/v3/che168

Оторизация: api_key параметър

Ред на работа

1
/filtersполучаване на наличните стойности на филтрите
2

Първоначално зареждане:

/change_id?date=...получаване на началното ID за потока от промени
/offersполучаване на всички обяви страница по страница
3
/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID
4
/offerполучаване на данни за конкретна обява по inner_id

Откъде да започнете:

1. Преди първото зареждане вземете номера от /change_id за днешната дата и го запазете. След това преминете през /offers страница по страница до края: на последната страница next_page е null.

2. После извиквайте /changes, като започнете от този номер, и подавайте next_change_id от всеки отговор. Така пристигат новите обяви, новите цени и свалените от продажба автомобили. Ако next_change_id е null, все още няма събития: повторете същата заявка по-късно.

3. За да търсите по собствени критерии, извиквайте /offers с филтри.

Формат на данните

  • Типовете се запазват: числото идва като число, списъкът като масив, а липсващата стойност като null.
  • Датата и часът се дават в UTC, например "2026-07-23T09:11:56Z". Датите имат вида "2026-07-23", а месеците вида "2022-11".
  • Всички суми са в CNY.
  • Всички обяви имат едни и същи ключове. Ако за даден блок, например оценката от che168, няма данни, блокът е null.

GET/filters

Връща всички възможни стойности за филтриране

https://{access_name}.auto-api.com/api/v3/che168/filters?api_key=YOUR_API_KEY

Отговор:

{
  "mark": {
    "BYD": { "model": ["D1", "Datang", "Destroyer 05", "Dolphin", ...] },
    "Geely": { "model": ["Binrui", "Binyue", "Binyue NEV", "Borui", ...] },
    ...
  },
  "transmission_type": ["Automatic", "Manual"],
  "color": ["Black", "Blue", "Brown", "Champagne", ...],
  "body_type": ["Coupe/roadster", "Crossover/SUV", "Hatchback", "Light truck", ...],
  "engine_type": ["Diesel", "Diesel and 48V mild hybrid", "Electric", "Gasoline", ...],
  "drive_type": ["AWD", "FWD", "RWD"]
}

GET/offers

Обяви страница по страница. Филтрите стесняват резултатите.

Параметри:

  • page (задължително) - номер на страницата
  • mark, model - имена на марката и модела, изписани както във /filters
  • transmission_type, color, body_type, engine_type, drive_type - стойности за скоростна кутия, цвят, каросерия, гориво и задвижване, без разлика между главни и малки букви
  • year_from, year_to - година на първа регистрация от и до
  • km_age_from, km_age_to - пробег в км от и до
  • price_from, price_to - цена в юани от и до

За да подадете няколко стойности на един филтър, повторете параметъра със скоби: mark[]=Zeekr&mark[]=Li Auto

https://{access_name}.auto-api.com/api/v3/che168/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/che168/offers?api_key=YOUR_API_KEY&page=1&mark=Zeekr&model=001&year_from=2022https://{access_name}.auto-api.com/api/v3/che168/offers?api_key=YOUR_API_KEY&page=1&mark[]=Zeekr&mark[]=Li Auto&color[]=Black&color[]=White&price_to=200000

Отговор:

{
  "result": [
    {
      "id": 386145,
      "inner_id": "59128731",
      "change_type": "added",
      "created_at": "2026-07-23T09:11:56Z",
      "data": {
        "id": 386145,
        "inner_id": "59128731",
        "url": "https://www.che168.com/dealer/553333/59128731.html",
        "mark": "Zeekr",
        "model": "001",
        "manufacturer": "Zeekr",
        "complectation": "Zeekr 001 2022 Ultra Long Range Dual Motor YOU Edition",
        "configuration": "Ultra Long Range Dual Motor YOU Edition",
        "year": 2022,
        "model_year": 2022,
        "first_registration": "2022-11",
        "first_registration_date": null,
        "notice": null,
        "km_age": 40000,
        "owners_count": 1,
        "price": 147800,
        "currency": "CNY",
        "engine_type": "Electric",
        "transmission_type": "Automatic",
        "gearbox_type": "Single-speed transmission",
        "gears_count": 1,
        "body_type": "Sedan",
        "body_style": "Liftback",
        "vehicle_class": "Mid-to-large car",
        "drive_type": "AWD",
        "color": "Black",
        "displacement": null,
        "displacement_cc": null,
        "engine_model": null,
        "power": 544,
        "power_ice_hp": null,
        "power_ice_kw": null,
        "power_ice_net_kw": null,
        "power_hybrid_hp": null,
        "power_hybrid_kw": null,
        "power_electro_hp": 544,
        "power_electro_kw": 400,
        "power_electro_front_kw": 200,
        "power_electro_rear_kw": 200,
        "battery_capacity_kwh": 100,
        "battery_type": "Ternary lithium (NCM)",
        "battery_ownership": null,
        "electric_range_km": 650,
        "seat_count": 5,
        "emission_standard": null,
        "inspection_valid_until": "2026-11",
        "insurance_valid_until": "2026-11",
        "vin": "L6T79T2E9NP044514",
        "section": "Used",
        "seller_type": "Dealer",
        "is_dealer": true,
        "salon_id": "553333",
        "city": "Wenzhou",
        "region": "Zhejiang",
        "address": "温州, 鹿城",
        "description": "买下!22年极氪001 you版 外...",
        "offer_created": "2026-07-23",
        "created_at": "2026-07-23T09:11:56Z",
        "photos": [
          "https://2sc2.autoimg.cn/escimg/auto/g34/M01/3B/EA/1024x768_c42_autohomecar__ChxpV2phvoOAGc3tAAkCio7thK8295.jpg.webp",
          "https://2sc2.autoimg.cn/escimg/auto/g34/M0A/3B/F4/1024x768_c42_autohomecar__ChxpWGphvoSAWFpXAAjAIgYkTOI530.jpg.webp",
          "https://2sc2.autoimg.cn/escimg/auto/g34/M0B/3B/EA/1024x768_c42_autohomecar__ChxpV2phvoWAWYoAAAjG12GxZEE037.jpg.webp",
          "https://2sc2.autoimg.cn/escimg/auto/g34/M00/3B/F4/1024x768_c42_autohomecar__ChxpWGphvoWAPqRMAAiq5qqYaGs574.jpg.webp",
          ...
        ],
        "video_url": "https://2sc.autohome.com.cn/video/m.html?infoid=59128731",
        "inspection_report_url": null,
        "cxc_report_url": null,
        "original": {  // оригинални стойности от che168.com
          "mark": "极氪",
          "model": "极氪001",
          "complectation": "极氪001 2022款 超长续航双电机 YOU版",
          "color": "黑色",
          "engine_type": "纯电动",
          "transmission_type": "自动",
          "body_type": "中大型车",
          "drive_type": "双电机四驱",
          "emission_standard": null,
          "city": "温州"
        },
        "catalog_ids": {
          "mark": "456",
          "model": "6091",
          "complectation": "58175"
        },
        "options": {
          "Safety": ["ISOFIX child seat anchors", "Autonomous emergency braking", "Blind spot monitoring", "Lane keeping assist", ...],
          "Driver assistance": ["Auto hold"],
          "Exterior and access": ["Keyless start", "Power tailgate", "Hands-free tailgate", "Active grille shutters"],
          "Interior": ["Digital instrument cluster", "Head-up display", "Heated steering wheel", "Built-in dashcam"],
          "Multimedia and connectivity": ["Bluetooth and hands-free calling", "Connected services", "Over-the-air updates"],
          "Climate": ["Rear air vents", "Rear climate control", "PM2.5 cabin filter"],
          "Lighting": ["Automatic high beam"]
        },
        "specs": {
          "Basic parameters": {
            "Trim name": "Zeekr 001 2022 Ultra Long Range Dual Motor YOU Edition",
            "MSRP (CNY)": "386000",
            "Manufacturer": "Zeekr",
            "Class": "Mid-to-large car",
            "Fuel type": "Electric",
            "Launch date": "2022-07",
            ...
          },
          "Body": {
            "Length (mm)": "4970",
            "Width (mm)": "1999",
            "Height (mm)": "1548",
            "Wheelbase (mm)": "3005",
            "Front track (mm)": "1713",
            ...
          },
          "Electric motor": {
            "Motor type": "Permanent magnet synchronous",
            "Total electric motor power (kW)": "400",
            "Total electric motor torque (N·m)": "768",
            "Front motor max power (kW)": "200",
            "Front motor max torque (N·m)": "384",
            ...
          },
          ...
        },
        "equipment": {
          "Passive safety": {
            "Driver/front passenger airbags": "Driver, Passenger",
            "Front/rear side airbags": "Front",
            "Front/rear curtain airbags": "Front, Rear",
            "Run-flat tires": "Optional"
          },
          "Handling": {
            "Drive mode selection": "Sport, Eco, Standard/comfort, Off-road, Snow, Custom/individual",
            "Air suspension": "Standard",
            "Adjustable suspension": "Suspension stiffness adjustment, Ride height adjustment",
            ...
          },
          "Driving features": {
            "Cruise control system": "Full-speed adaptive cruise control",
            "Park assist": "Optional",
            "Driver assistance system": "ZEEKR AD",
            ...
          },
          "Connectivity and smart features": {
            "Center screen size": "15.4 inch",
            "Infotainment system": "ZEEKR OS",
            "4G/5G network": "5G",
            ...
          },
          "Seats": {
            "Seat material": "Genuine leather",
            "Front seat functions": "Heating, Ventilation (optional), Massage, Ventilation (driver only)",
            ...
          },
          ...
        },
        "assessment": {
          "score": 86,
          "score_age": 42,
          "score_mileage": 66,
          "score_popularity": 62,
          "ownership_changes_level": "Very few",
          "mileage_level": "Very low",
          "age_level": "Average",
          "value_retention_3y_percent": 66,
          "reference_price_from": 130000,
          "reference_price_to": 160000,
          "price_verdict": "Reasonable price",
          "price_below_average": null,
          "price_vs_similar": "In line with average",
          "resale_price": 120000,
          "resale_after_years": 2,
          "resale_discount_percent": 13.5
        }
      }
    }
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Полета с данни:

Обява

id - вътрешно ID в базата данни

inner_id - ID на обявата в платформата

url - връзка към обявата

price, currency - Цена в юани, currency винаги е CNY.

notice - Предупреждение от che168, например че автомобилът се подготвя за продажба.

section - "Used" или "New".

description - описание

offer_created - Ден, в който е публикувана обявата.

created_at - Дата и час, когато обявата е постъпила в нашата база данни.

Автомобил

mark, model - Марка и модел.

manufacturer - Производител. Може да е местно съвместно предприятие, например "BMW Brilliance", или "BMW (imported)" при вносните автомобили.

complectation - Пълно име на версията.

configuration - Версия (марката, моделът и годината не са включени).

year - Година на първа регистрация.

model_year - Моделна година.

first_registration, first_registration_date - Първа регистрация: месец, а при някои обяви и точната дата.

km_age - пробег в км

owners_count - Колко собственици е имал автомобилът. 0, ако автомобилът никога не е бил регистриран.

vin - VIN номер от 17 знака, не е посочен във всяка обява.

inspection_valid_until, insurance_valid_until - Месец на изтичане на периодичния технически преглед и месец на изтичане на задължителната застраховка.

Характеристики

engine_type - Тип двигател.

transmission_type - "Automatic" или "Manual".

gearbox_type, gears_count - Конструкция на скоростната кутия и брой предавки.

body_type, body_style - Тип каросерия най-общо и по-точно, например "Crossover/SUV" и "SUV".

vehicle_class - Клас по размер, например "Mid-to-large SUV".

drive_type - Задвижване: "FWD", "RWD" или "AWD".

color - Цвят на каросерията.

displacement, displacement_cc - Обем на двигателя в литри и в кубически сантиметри.

engine_model - Код на двигателя.

power - Обща мощност, к.с.

power_ice_hp, power_ice_kw - Двигател с вътрешно горене: к.с. и kW.

power_ice_net_kw - Нетна мощност на двигателя с вътрешно горене, kW.

power_hybrid_hp, power_hybrid_kw - Мощност на цялата хибридна система: к.с. и kW.

power_electro_hp, power_electro_kw - Всички електромотори заедно: к.с. и kW.

power_electro_front_kw, power_electro_rear_kw - Предният и задният електромотор поотделно, kW.

battery_capacity_kwh, battery_type - Капацитет на батерията в kWh и химичният ѝ тип, например "Lithium iron phosphate (LFP)".

battery_ownership - "Owned" или "Leased".

electric_range_km - Пробег само на електрическа тяга, км.

seat_count - Брой места.

emission_standard - Екологичен стандарт, например "China VI".

Продавач

seller_type, is_dealer - "Dealer" или "Private seller", is_dealer повтаря това като true/false.

salon_id - ID на дилъра в che168.

city, region - Град на продавача и провинцията, към която спада.

address - Град и район на дилъра.

Снимки, оборудване и справочни данни

photos - масив от URL адреси на изображения

video_url - Видео, заснето от продавача. Не винаги е налично.

inspection_report_url - Доклад от проверка, публикуван от продавача. Не всяка обява има такъв.

cxc_report_url - Доклад от проверка, предоставен от самата платформа che168. Не всяка обява има такъв.

options - Оборудване, посочено в обявата, по групи "Safety", "Driver assistance", "Exterior and access", "Interior", "Multimedia and connectivity", "Climate", "Lighting", "Glass".

specs - Характеристики на версията по раздели "Basic parameters", "Body", "Engine", "Electric motor", "Transmission", "Chassis and steering", "Wheels and brakes", стойностите като низове.

original - Оригинални имена и стойности от che168.com.

catalog_ids - Кодове на марката, модела и версията в каталога на che168.com.

Пълно оборудване на версията (equipment)

Цялото оборудване на версията, разпределено по същите раздели като на страницата с характеристики в che168.com. Обектът съдържа само елементите, налични във версията. Без данни за оборудването equipment е null.

"Standard" - елементът е част от базовото оборудване на версията.

"Optional" - предлага се срещу доплащане. При някои опции е посочена и сумата в CNY: "Optional, 3000 CNY".

разположение - къде в автомобила е разположен елементът: "Driver, Passenger", "Front". Разположение, което се предлага само като опция, е отбелязано така: "Rear (optional)".

текст или число - с какво точно е оборудван автомобилът, например "Genuine leather" или "15.4 inch". Вариантите са разделени със запетаи, а вариант срещу доплащане е отбелязан с бележка в скоби: "Heating, Ventilation (optional), Massage".

Раздели: "Passive safety", "Active safety", "Handling", "AWD/off-road", "Driver assistance hardware", "Driving features", "Exterior/anti-theft", "Exterior lighting", "Sunroof/glass", "Exterior mirrors", "Connectivity and smart features", "Steering wheel/interior mirror", "In-car charging", "Seats", "Audio/interior lighting", "Air conditioning/refrigerator", "Special features".

Оценка от che168 (assessment)

Как che168 оценява автомобила и цената му. Не всяка обява има такава оценка. Без оценка assessment е null.

score - Общ резултат.

score_age, score_mileage, score_popularity - Компоненти на резултата: възраст, пробег, популярност на модела.

ownership_changes_level - Колко често е сменян собственикът: "Very few", "Few", "Quite a few", "Many".

mileage_level - Етикет за пробега: "Very low" или "Low".

age_level - Етикет за възрастта: "Low", "Average", "High".

value_retention_3y_percent - Прогноза на che168: какъв процент от цената ще остане след три години.

reference_price_from, reference_price_to - Диапазонът на цената, който che168 смята за нормален.

price_verdict - Мнението на che168 за цената, например "Reasonable price".

price_below_average - С колко цената е под средната, ако che168 го посочва.

price_vs_similar - Сравнение с подобни обяви: "In line with average" или "Below average".

resale_price, resale_after_years, resale_discount_percent - Прогноза на che168 за препродажба: очаквана цена, срок в години (resale_after_years) и загуба в проценти.

GET/change_id

Получаване на първото ID на промяна по дата (за използване в /changes)

Параметри:

  • date (задължително) - дата във формат yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/che168/change_id?api_key=YOUR_API_KEY&date=2026-10-22

Отговор:

{
  "change_id": 85236
}

Използвайте върнатата стойност като параметър change_id в /changes

GET/changes

Поток от промени (добавени/променени/премахнати)

Параметри:

  • change_id (задължително) - от кое ID на промяна да се започне
https://{access_name}.auto-api.com/api/v3/che168/changes?api_key=YOUR_API_KEY&change_id=85240

Отговор:

{
  "result": [
    {
      "id": 85241,
      "inner_id": "60271904",
      "change_type": "removed",
      "created_at": "2026-10-22T06:12:40Z",
      "data": {}  // свален от продажба
    },
    {
      "id": 85247,
      "inner_id": "59873316",
      "change_type": "changed",
      "created_at": "2026-10-22T06:29:03Z",
      "data": {  // цената е променена, новата е в CNY
        "new_price": 92800
      }
    },
    {
      "id": 85252,
      "inner_id": "60288471",
      "change_type": "added",
      "created_at": "2026-10-22T06:45:58Z",
      "data": { ... }  // цялото тяло на обявата
    }
    // ... следват останалите събития, до 20 на страница
  ],
  "meta": {
    "cur_change_id": 85240,
    "next_change_id": 85260,
    "limit": 20
  }
}

GET/offer

Една обява по inner_id

Параметри:

  • inner_id (задължително)
https://{access_name}.auto-api.com/api/v3/che168/offer?api_key=YOUR_API_KEY&inner_id=59128731

Отговорът съдържа само обекта data, без обвивката result.

Грешки

При грешка отговорът съдържа поле error с описание: { "error": "parameter page is required" }

  • 401 - ключът api_key не е приет
  • 400 - липсва задължителен параметър или някоя стойност е в неправилен формат
  • 404 - няма обява с такъв inner_id (/offer)
  • 429 - лимитът на заявките е изчерпан

API-то връща данните на обява в che168.com по връзка към нея: полетата както в /offer и блок meta с оставащия лимит.

Базов URL

https://{access_name}.auto-api.com/api/v2/offer/info

Оторизация: хедър x-api-key

POST/api/v2/offer/info

Една обява по връзката към нея

Параметри:

  • url (задължително) - URL адрес на страницата на обявата в che168.com

Примерна заявка:

curl -L 'https://{access_name}.auto-api.com/api/v2/offer/info' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://www.che168.com/dealer/553333/59128731.html" }'

Отговор:

{
  "id": 386145,
  "inner_id": "59128731",
  "url": "https://www.che168.com/dealer/553333/59128731.html",
  "mark": "Zeekr",
  "model": "001",
  "manufacturer": "Zeekr",
  "complectation": "Zeekr 001 2022 Ultra Long Range Dual Motor YOU Edition",
  "configuration": "Ultra Long Range Dual Motor YOU Edition",
  "year": 2022,
  "model_year": 2022,
  // ... останалите полета на обявата, както в /offer на API v3
  "meta": {
    "requests_made": 48,
    "requests_left": 1952,
    "requests_limit": 2000,
    "period_start": "2026-11",
    "platform": "che168"
  }
}

Полетата на обявата са същите, които връща /offer в API v3. Блокът meta идва последен.

Какво има в meta:

  • requests_made - колко успешни заявки са направени през текущия месец
  • requests_left - колко още заявки можете да направите
  • requests_limit - месечният лимит
  • period_start - месецът на брояча
  • platform - от коя платформа е обявата: encar, che168, dongchedi, guazi или mobilede

Към месечния лимит се отчитат само отговорите с обява, а грешките не го изразходват.

Грешки

При грешка отговорът съдържа поле error с описание: { "error": "Failed to get info" }

  • 401 - ключът x-api-key не е приет
  • 400 - липсва връзка или тя не е разпозната, или платформата не е включена за ключа
  • 422 - данните от обявата не могат да бъдат получени
  • 429 - лимитът на заявките е изчерпан

Съхранение на файловете

Файловете се съхраняват поне 3 дни

График на обновяванията

Нови файлове с данни, генерирани ежедневно и достъпни за изтегляне

Формат на файловете

CSV файловете използват вертикална черта (|) за разделяне на колоните

Структура на URL адреса:

https://{access_name}.auto-api.com/{date}/{file_name}

Параметри на заявката:

  • access_name - предоставеният ви идентификатор на поддомейна
  • date - желаната дата във формат yyyy-mm-dd (напр. 2025-09-06)
  • file_name - име на експортния файл с разширението

Налични формати:

  • CSV - all_active.csv, new_daily.csv, removed_daily.csv
  • JSON - all_active.json, new_daily.json, removed_daily.json
  • Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

Примерна API заявка с cURL

curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
  -H 'Authorization: Basic XXX' \
  -o daily_car_data.csv

Команда за изтегляне с Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
Che168.com

Обявите в Che168.com съдържат пълни данни за автомобилите, включително технически характеристики, цени, информация за продавача и данни за местоположението. Тези данни разкриват пазарните тенденции, закономерностите в цените и поведението на купувачите на автомобилния пазар в Китай.

Историята на автомобилите, докладите от проверката и данните за финансиране от платформата дават ценна информация. Фирмите използват тези данни за планиране на наличностите, решения за цените и пазарна стратегия.

Екипи за проучване на пазара, разработчици на автомобилни приложения и анализатори използват тези данни чрез нашето Che168 API. Директният достъп до данните означава, че няма нужда от разработка или поддръжка на скрейпъри.

Che168 API работи непрекъснато, като открива нови обяви в рамките на минути и наблюдава промените в цените, за да предоставя пазарни данни в реално време. Цялата информация за автомобилите е достъпна чрез структурирани крайни точки на API-то.

Отговор до 2 мин