GET/search/countАвтомобили

Подсчёт подходящих автомобилей

Подсчёт автомобилей, соответствующих набору фильтров. Принимает все фильтры /search; пагинация и сортировка игнорируются.

Точное значение, в отличие от meta.total в /search, который ограничен 10,000.
Если совпадений нет, возвращается {"count": 0} со статусом 200.

Параметры запроса

Запрос, страницы и охват

querystring≤ 200 chars

Полнотекстовый поиск автомобилей. Не передавайте неиспользуемые фильтры.

vinstring1–19 chars

Частичный VIN без учёта регистра. Для точного VIN из 16–19 символов используйте /cars/vin/{vin}.

pageinteger≥ 1 · default 1

Номер страницы. Для /search явно передавайте perPage и соблюдайте page × perPage ≤ 10000. /search/count игнорирует пагинацию и пропускает эту проверку смещения.

perPageinteger2–50 · default 50

Размер страницы поиска: минимум 2, максимум 50. perPage=1 возвращает 422; для небольшой выборки используйте perPage=2. Если значения пагинации не переданы или равны null, используются page=1 и perPage=50, в том числе при проверке окна результатов поиска. Недопустимые значения возвращают 422.

sortstring

Порядок сортировки. Для сортировки по цене нужна определённая валюта.

currencystring3 chars · default usd

Код валюты без учёта регистра для фильтрации/сортировки по цене. Должен существовать в справочнике валют. Не конвертирует цены объявлений в ответе.

currency_idinteger≥ 1

Необязательный внутренний ID валюты; имеет приоритет над currency.

domains[]integer[]≥ 1

Необязательный набор источников. Используйте ID, возвращаемые GET /domains. Если не указан, используются все включённые домены. Повторяйте параметр со скобками: domains[]=33&domains[]=34. Каждый ID должен быть включён для этого ключа.

langstring

Локаль ответа. Переводы опций также ограничены языками аккаунта. Страница автоматически подставляет текущий язык.

Марка, модель и местоположение

brands[0][id]integer

ID первой марки из /brands. Для дополнительных марок используйте brands[1][id] и т. д.

brands[0][models][]integer[]

Необязательные ID моделей для первой марки, возвращаемые /models/{brand_id}. Не передавайте, чтобы выбрать все модели.

countries[0][id]integer

Внутренний ID первой страны из /countries. Для дополнительных стран используйте countries[1][id] и т. д.

countries[0][regions][]integer[]

Необязательные внутренние ID регионов, относящихся к первой стране.

Диапазоны

seatsinteger1–200

Точное число посадочных мест.

price_fromint64≥ 0

Минимальная цена объявления в выбранной валюте. Максимум 9223372036854775807 (знаковое 64-битное целое); значения за пределами безопасных целых чисел JavaScript клиенты должны хранить как десятичный текст.

price_toint64≥ 1

Максимальная цена объявления в выбранной валюте. Максимум 9223372036854775807 (знаковое 64-битное целое); значения за пределами безопасных целых чисел JavaScript клиенты должны хранить как десятичный текст.

year_frominteger1,800–3,000

Минимальный год выпуска.

year_tointeger1,800–3,000

Максимальный год выпуска.

odometer_frominteger0–999,999,999

Минимальный пробег в километрах.

odometer_tointeger0–999,999,999

Максимальный пробег в километрах.

engine_volume_frominteger0–999,999,999

Минимальный объём двигателя.

engine_volume_tointeger0–999,999,999

Максимальный объём двигателя.

power_hp_frominteger0–100,000

Минимальная мощность в лошадиных силах.

power_hp_tointeger1–100,000

Максимальная мощность в лошадиных силах.

Флаги

is_leasingboolean

Необязательный фильтр лизинга. Передайте true (или 1) для объявлений, явно помеченных is_leasing=true. Передайте false (или 0), чтобы исключить true, включая сохранённые false, null и отсутствующие поля. Не передавайте, чтобы не фильтровать по лизингу; пустые или недопустимые значения возвращают 422. У автомобиля должно быть хотя бы одно подходящее активное объявление во включённом/выбранном наборе доменов. Другие объявления могут остаться в ответе, поэтому автомобили со смешанными типами объявлений могут соответствовать обоим значениям. Для /cars задайте его в первом запросе и следуйте next_url без изменений; false сохраняется. При продолжении только со scroll_id фильтр сохраняется. Изменение или добавление фильтра посреди прокрутки возвращает 422. Если сохранённое в кэше состояние фильтра утеряно или прокрутка начата до появления этого параметра, явное значение возвращает 422; начните новую прокрутку.

keys_availableinteger

У объявления есть ключи. Передайте 1 (true) или 0 (false). Не передавайте, чтобы учитывать оба значения; строки "true"/"false" не принимаются.

is_manufacturer_certifiedinteger

Объявление сертифицировано производителем или официальной дилерской программой. Передайте 1 (true) или 0 (false). Не передавайте, чтобы учитывать оба значения; строки "true"/"false" не принимаются.

has_inspectionsinteger

У корневого автомобиля есть публичный осмотр. Передайте 1 (true) или 0 (false). Не передавайте, чтобы учитывать оба значения; строки "true"/"false" не принимаются.

has_history_reportsinteger

У объявления в выбранном наборе доменов есть публичный отчёт об истории. Передайте 1 (true) или 0 (false). Не передавайте, чтобы учитывать оба значения; строки "true"/"false" не принимаются.

Категории

body_types[]integer[]

Repeat to match any of the values.

colors[]integer[]

Repeat to match any of the values.

fuels[]integer[]

Repeat to match any of the values.

transmissioninteger

One value.

seller_typeinteger

One value.

steering_wheel_positioninteger

One value.

airbagsinteger

One value.

damages[]integer[]

Repeat to match any of the values.

conditions[]integer[]

Repeat to match any of the values.

availabilities[]integer[]

Repeat to match any of the values.

emissions[]integer[]

Repeat to match any of the values.

drive_wheels[]integer[]

Repeat to match any of the values.

Возвращает · {"count": integer}

GET/search/count

curl -g "https://api.lotarius.com/search/count?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"

ПримерыЗаписано

{1 key

"count": 3217391

}