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

}