GET/search/countVehicles

Count matching vehicles

Count the cars that match a filter set. Accepts every /search filter; pagination and sort are ignored.

Exact, unlike meta.total on /search, which stops at 10,000.
No matches returns {"count": 0} with status 200.

Query parameters

Query, paging and scope

querystring≤ 200 chars

Full-text vehicle search. Omit unused filters.

vinstring1–19 chars

Case-insensitive partial VIN. For an exact 16–19 character VIN, use /cars/vin/{vin}.

pageinteger≥ 1 · default 1

Page number. For /search, explicitly pass perPage and keep page × perPage ≤ 10000. /search/count ignores pagination and skips this offset check.

perPageinteger2–50 · default 50

Search page size: minimum 2, maximum 50. perPage=1 returns 422; use perPage=2 to fetch a small sample. Omitted or null pagination values use page=1 and perPage=50, including the search result-window check. Invalid values return 422.

sortstring

Sort order. Price sorting requires a resolved currency.

currencystring3 chars · default usd

Case-insensitive currency code for price filtering/sorting. Must exist in the currency dictionary. Does not convert serialized listing prices.

currency_idinteger≥ 1

Optional internal currency ID; overrides currency.

domains[]integer[]≥ 1

Optional source scope. Use IDs returned by GET /domains. Omit to use all enabled domains. Repeat the bracketed parameter: domains[]=33&domains[]=34. Every ID must be enabled for this key.

langstring

Response locale. Option translations are also limited by the account languages. The page selects its current language automatically.

Brand, model and location

brands[0][id]integer

First brand ID from /brands. Additional brands use brands[1][id], etc.

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

Optional model IDs for the first brand, returned by /models/{brand_id}. Omit for all models.

countries[0][id]integer

First internal country ID from /countries. Additional countries use countries[1][id], etc.

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

Optional internal region IDs belonging to the first country.

Ranges

seatsinteger1–200

Exact seating capacity.

price_fromint64≥ 0

Minimum listing price in the selected currency. Maximum 9223372036854775807 (signed 64-bit integer); values beyond JavaScript safe integers must be preserved as decimal text by clients.

price_toint64≥ 1

Maximum listing price in the selected currency. Maximum 9223372036854775807 (signed 64-bit integer); values beyond JavaScript safe integers must be preserved as decimal text by clients.

year_frominteger1,800–3,000

Minimum production year.

year_tointeger1,800–3,000

Maximum production year.

odometer_frominteger0–999,999,999

Minimum mileage in kilometres.

odometer_tointeger0–999,999,999

Maximum mileage in kilometres.

engine_volume_frominteger0–999,999,999

Minimum engine displacement.

engine_volume_tointeger0–999,999,999

Maximum engine displacement.

power_hp_frominteger0–100,000

Minimum power in horsepower.

power_hp_tointeger1–100,000

Maximum power in horsepower.

Flags

is_leasingboolean

Optional leasing filter. Send true (or 1) for listings explicitly marked is_leasing=true. Send false (or 0) to exclude true, including stored false, null and missing fields. Omit for no leasing filter; empty or invalid values return 422. 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

Listing has keys. Send 1 (true) or 0 (false). Omit for either value; strings "true"/"false" are rejected.

is_manufacturer_certifiedinteger

Listing is certified by the manufacturer or official dealer program. Send 1 (true) or 0 (false). Omit for either value; strings "true"/"false" are rejected.

has_inspectionsinteger

Root car has a public inspection. Send 1 (true) or 0 (false). Omit for either value; strings "true"/"false" are rejected.

has_history_reportsinteger

A listing in the selected domain scope has a public history report. Send 1 (true) or 0 (false). Omit for either value; strings "true"/"false" are rejected.