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

}