Документация API

Базовый запрос

GET /api/v1/cars?market=autoscout24&brand=BMW&limit=5

Параметры

ПараметрТипОписание
marketstringКод рынка (autoscout24, che168, encar, dubicars, motoscout24, guazi)
brandstringМарка (BMW, Audi, Toyota...)
modelstringМодель
year_from / year_tointГод выпуска
price_min / price_maxfloatЦена
mileage_maxintПробег до (км)
fuel_typestringТопливо: petrol, diesel, electric
transmissionstringКПП: manual, automatic
fieldsstringСписок полей через запятую
sortstringprice_asc, price_desc, year_asc, year_desc
limitintЗаписей на странице (1–100)
pageintНомер страницы
sinceISO8601Дельта-обновления с момента последнего визита

Примеры

# Все BMW на европейском рынке
curl "BASE_URL/api/v1/cars?market=autoscout24&brand=BMW&limit=10"

# Audi A6 2019-2022, дизель, до 30000€
curl "BASE_URL/api/v1/cars?market=autoscout24&brand=Audi&model=A6&year_from=2019&year_to=2022&fuel_type=diesel&price_max=30000"

# Электромобили из Китая
curl "BASE_URL/api/v1/cars?market=guazi&fuel_type=BEV&limit=20"

# Только нужные поля
curl "BASE_URL/api/v1/cars?market=autoscout24&fields=id,make,model,year,price,mileage&limit=5"

# Дельта с последнего визита
curl "BASE_URL/api/v1/cars?market=autoscout24&since=2026-06-24T12:00:00Z&include_removed=true"

Другие эндпоинты

МетодЭндпоинтОписание
GET/api/v1/cars/filtersДоступные значения для фильтров
GET/api/v1/cars/rangeДиапазоны цен, года, пробега
GET/api/v1/cars/aggregationsСтатистика по выбранным фильтрам
GET/api/v1/cars/statsОбщая статистика рынка
GET/api/v1/cars/{id}/similarПохожие объявления
GET/api/v1/currency/ratesКурсы валют
GET/api/v1/marketsСписок доступных рынков