listings

Search listings — ref filters + spec filters

Filters are entity refs, checked for grammar and then registry membership — an unknown ref returns a 400 naming it, never a silent fuzzy match. Sort: ?sort=<field>&order=<asc|desc>.

get/v2/listings/search

Request

  • Base URL: https://api.cardog.app
  • URL: https://api.cardog.app/v2/listings/search
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

makestring[]

Make ref, repeatable — e.g. "make:mini"

modelstring[]

Model ref, repeatable — e.g. "model:mini/hardtop"

nanostring[]

Nano ref (fungible build grain), repeatable — e.g. "nano:5TDGSKFCRS"

bodyStylestring[]

Body-style ref, repeatable — e.g. "body-style:sedan-saloon"

fuelTypestring[]

Fuel-type ref, repeatable — e.g. "fuel-type:electric"

driveTypestring[]

Drive-type ref, repeatable — e.g. "drive-type:awd-all-wheel-drive"

transmissionstring[]

Transmission ref, repeatable — e.g. "transmission:automatic"

electrificationstring[]

Electrification-level ref, repeatable — e.g. "electrification-level:bev-battery-electric-vehicle"

vehicleTypestring[]

Vehicle-type ref, repeatable — e.g. "vehicle-type:passenger-car"

trimstring[]

Free-text trim (dealer-entered, no domain), repeatable

sellerstring[]

Seller id, repeatable

exteriorColorstring[]

Normalized exterior color, repeatable

interiorColorstring[]

Normalized interior color, repeatable

year.mininteger

Model year lower bound

year.maxinteger

Model year upper bound

price.minnumber

Price lower bound

price.maxnumber

Price upper bound

odometer.minnumber

Odometer lower bound

odometer.maxnumber

Odometer upper bound

latnumber

Latitude (with lng + radius)

lngnumber

Longitude (with lat + radius)

radiusnumber

Radius in km (with lat + lng)

verifiedboolean

Verified-only gate (defaults true)

createdAfterstring date-time

Freshness floor on listing creation

updatedAfterstring date-time

Freshness floor on listing update

spec.{attributeId}string

Canonical spec filter, dynamic keys: numeric attributes take spec.{id}.min/.max (e.g. spec.fuelEconomyCombined.min=35); availability attributes repeat tri-state values (spec.heatedSeatsFront=standard). Attribute ids come from GET /v2/specs/catalog; unknown ids 400 with the id named.

pageinteger

Page number

limitinteger

Page size

sortstring

Sort field

order'asc' | 'desc'

Sort order

Response

Listings + pagination + echoed filters

Changes

No recorded changes to this operation across all 1 revision of this API.