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

Преброяване на съвпадащи автомобили

Преброяване на автомобилите, които отговарят на набор от филтри. Приема всички филтри на /search; страницирането и сортирането се игнорират.

vehicle_type=automobile / 1 е по подразбиране; motorcycle / 2 избира мотоциклети в /search, /search/count и /cars. Използвайте същия тип в речниците.
Пълна вложеност: brands[] → models[] → generations[] → variants[] / trims[]. Всеки обект за марка, модел и поколение изисква id. ИЛИ между съседите и стойностите на variants/trims; И между условията в един клон. Липсващ или празен дочерен списък означава всички наследници. До 100 елемента в масив. Непознати или несъвместими ID дават празен резултат; невалиден формат — 422.
Старият brands[0][models][]=573 работи. За наследници използвайте brands[0][models][0][id]=573. Изчистете старото поле за ID преди обектите на моделите на същата марка, иначе PHP презаписва индекс 0.
is_auction приема true/false/1/0. False включва false, null и липсващ флаг; без параметър няма филтър. Трябва да съвпада с is_leasing в една активна обява на разрешен домейн; други обяви могат да останат в listings[].
Точен, за разлика от meta.total в /search, който спира на 10,000.
Ако няма съвпадения, връща {"count": 0} със статус 200.

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

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

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

Sort order. Price sorting requires a resolved currency. auction_nearest selects only cars with an active listing in an enabled/selected domain with auction_at >= now; past dates do not participate in sorting. Pass the same sort to /search/count for a matching count.

currencystring3 chars · default usd

Код на валута без значение от регистъра за филтриране/сортиране по цена. Трябва да съществува в речника на валутите. Не конвертира сериализираните цени на обявите.

currency_idinteger≥ 1

Незадължително вътрешно ID на валута; има предимство пред currency.

domains[]integer[]≥ 1

Незадължителен обхват на източниците. Използвайте ID, върнати от GET /domains. Пропуснете, за да използвате всички активирани домейни. Повтаряйте параметъра със скоби: domains[]=33&domains[]=34. Всяко ID трябва да е активирано за този ключ.

vehicle_typestringdefault automobile

vehicle_type=automobile / 1 е по подразбиране; motorcycle / 2 избира мотоциклети в /search, /search/count и /cars. Използвайте същия тип в речниците.

langstring

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

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

brands[0][id]integer≥ 1

Пълна вложеност: brands[] → models[] → generations[] → variants[] / trims[]. Всеки обект за марка, модел и поколение изисква id. ИЛИ между съседите и стойностите на variants/trims; И между условията в един клон. Липсващ или празен дочерен списък означава всички наследници. До 100 елемента в масив. Непознати или несъвместими ID дават празен резултат; невалиден формат — 422.

brands[0][models][]integer[]≥ 1 · ≤ 100 items

Старият brands[0][models][]=573 работи. За наследници използвайте brands[0][models][0][id]=573. Изчистете старото поле за ID преди обектите на моделите на същата марка, иначе PHP презаписва индекс 0.

brands[0][models][0][id]integer≥ 1

brands[0][models][0][generations][0][id]integer≥ 1

brands[0][models][0][generations][0][variants][]integer[]≥ 1 · ≤ 100 items

brands[0][models][0][generations][0][trims][]integer[]≥ 1 · ≤ 100 items

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; започнете ново обхождане.

is_auctionboolean

Optional auction filter. Send true (or 1) for listings explicitly marked is_auction=true. Send false (or 0) to exclude true, including stored false, null and missing fields. Omit for no auction filter; empty or invalid values return 422. Combined is_auction and is_leasing must match the same listing. A car must have at least one matching active listing in the enabled/selected domain scope. Other listings can remain in the response, so cars with mixed listing types can match both values. For /cars, set this on the first request and follow next_url unchanged; false is preserved. Continuing with only scroll_id retains the filter. Changing or adding the filter mid-scroll returns 422. If cached filter state is lost or the scroll predates this parameter, an explicit value returns 422; start a new scroll.

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.

interior_colors[]integer[]≤ 100 items

ID на цветовете на салона от речника за цветове. В списъка важи ИЛИ; липсващите стойности не съвпадат. Прилага се в /search, /search/count и /cars. Не променяйте при продължаване на scroll.

cylinders[]integer[]1–99 · ≤ 99 items

Точен брой цилиндри (1–99), ИЛИ в списъка; неизвестните стойности не съвпадат. Прилага се в /search, /search/count и /cars. Не променяйте при продължаване на scroll.

Допълнителни полета на обяви

Заредете /listing-fields след проверка на ключа. Определенията, ограниченията, операторите и бележките важат само за този ключ и избраните домейни.

Низове: eq, in, exists. Числа и дати също gt, gte, lt, lte. Boolean: eq или exists. Изберете eq, in, exists или диапазон; exists самостоятелно. До 20 полета и 100 стойности в in.

Всички условия, домейни и активност трябва да съвпаднат в една обява. Нула и false са стойности. Масив съвпада при подходящ елемент. Непознати или недостъпни полета/оператори връщат 422.

Филтрирайте само filterable полета. Индексирани стойности: listings[].custom_fields; останалите: listings[].source_data. Публикуването включва филтрите, следващите обичайни импорти попълват стойности. Без обновяване на стари документи.

В /cars условията остават за целия scroll. Несъвместимо определение или загубено състояние изисква нов scroll. Сортиране и агрегации не се поддържат.

Заменете FIELD_KEY с ключ от достъпния каталог. За парични сравнения задайте валутата на обявата; преобразуването Buy Now не се прилага.

Историческите пазарни оценки от източника са справочни неиндексирани стойности. Описват сравними продажби, а не цената, офертата или резервната цена на тази обява. Проверявайте описанието на полето, критериите за сравнение и датата на изчисление; валутата на обявата не се подразбира. Регистрираните числови полета може да са null, когато няма оценка.

custom_fields[FIELD_KEY][gte]=2
custom_fields[FIELD_KEY][in][]=a&custom_fields[FIELD_KEY][in][]=b
custom_fields[FIELD_KEY][eq]=false
custom_fields[FIELD_KEY][lte]=15000&custom_fields[FIELD_KEY][currency]=cad

Допълнителни полета на обяви

Свържете ключ, за да видите полетата за достъпните домейни.

Връща · {"count": integer}

GET/search/count

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

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

{1 key

"count": 3217391

}

Вземете достъп до API

Свържете ключа си, за да изпълнявате всяка заявка от тези страници с вашите данни. Още нямате ключ? Поискайте ни демо ключ: същият JSON като в платените планове.

Имам ключ