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

Търсене на автомобили

Филтриране на активни автомобили във всички активирани източници. Резултатите са олекотени: всеки автомобил съдържа флагове за доклади, а не самите доклади.

perPage е 2–50 (по подразбиране 50). perPage=1 връща 422.
Поддържайте page × perPage не повече от 10,000. За да четете по-нататък, използвайте /cars.
data може да съдържа perPage + 1 автомобила, а meta.total спира на 10,000. За точни суми използвайте /search/count.
Сортиранията по цена (cheaper, expensive) сравняват цените в currency.

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

Заявка, странициране и обхват

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.

Връща · Страница с обекти Car в data, с links и meta. Масивите inspections и vehicle_history_reports се пропускат.

GET/search

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

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

{3 keys

"data": [1 item

0: {21 keys

"id": "l_eCJb-8zB_XcJ-z6Y7oZWjw"

"has_inspections": true

"has_history_reports": true

"year": 2014

"month": 4

"vin": "wddhf0cb3ea952710"

"brand": {2 keys

}

"model": {2 keys

}

"engine_volume": 2143

"seats": 5

"body_type": {2 keys

}

"transmission": {2 keys

}

"transmission_steps": 6

"fuel": {2 keys

}

"color": {2 keys

}

"power_hp": 170

"market_origin": {2 keys

}

"badge": "E220 CDI Avantgarde"

"option_ids": [53 items

]

"listings": [1 item

]

"hash": "093563801f92d9cfa23a07346b26b69db32df8da05d7c5ee60fa5fd876a7fe0b"

}

]

"links": {4 keys

}

"meta": {7 keys

}