Vehicle Specifications

Search and rank vehicles by metric

Search and rank vehicles by a performance or efficiency metric. Supports filtering by year, make, model, body type, fuel type, drive type, and transmission. For electrified vehicles, horsepower and torque use total system output when available. Fuel economy supports combined values from all available test cycles and MPGe for EVs. Requires credit access; charged at the published vehicle search rate.

get/v1/specs/search

Request

  • Base URL: https://api.carstat.app
  • URL: https://api.carstat.app/v1/specs/search
  • Auth: HTTP bearer

Query parameters

metric'horsepower' | 'torque' | 'mpg' | 'acceleration' | 'max_speed' | 'curb_weight' | 'cargo' required

Metric to rank by

order'asc' | 'desc'

Sort order. Defaults to desc for horsepower/torque/mpg/max_speed/cargo, asc for acceleration/curb_weight

limitinteger

Number of results (default 10, max 25)

yearinteger

Filter by an exact confirmed production year. A missing final production year is not assumed to mean ongoing production.

year_mininteger

Minimum confirmed production year (inclusive)

year_maxinteger

Maximum confirmed production year (inclusive)

makestring

Filter by manufacturer (case-insensitive)

modelstring

Filter by model name (case-insensitive)

body_type'sedan' | 'hatchback' | 'liftback' | 'coupe' | 'cabriolet' | 'roadster' | 'targa' | 'suv' | 'crossover' | 'station_wagon' | 'pickup' | 'van' | 'minivan' | 'minibus' | 'offroad' | 'quadricycle'

Filter by body type (e.g. 'sedan', 'suv', 'hatchback'). Matches vehicles where body_type is the given value or an array containing it (e.g. filtering 'suv' matches both ['suv'] and ['suv', 'crossover']).

fuel_type'petrol' | 'diesel' | 'electric' | 'natural_gas' | 'lpg' | 'hydrogen' | 'ethanol' | 'ethanol_e85' | 'ethanol_e100' | 'synthetic_gasoline' | 'mixture_of_two_stroke_engine'

Filter by fuel type — matches vehicles whose fuel_type array contains the value (e.g. 'petrol', 'diesel', 'electric', 'ethanol_e85')

drive_type'fwd' | 'rwd' | 'awd' | 'unknown'

Filter by drive type (e.g. 'fwd', 'rwd', 'awd')

transmission'at' | 'mt' | 'dct' | 'cvt' | 'amt' | 'imt' | 'unknown'

Filter by transmission type. Electric vehicles generally have no transmission value; use fuel_type=electric to find them.

Response

successful search

metric'horsepower' | 'torque' | 'mpg' | 'acceleration' | 'max_speed' | 'curb_weight' | 'cargo' required

The metric used for ranking. Available metrics and their data sources:

  • horsepower — total system power (hp) for electrified vehicles; engine hp for ICE; summed motor output when no aggregate is available. Default order: desc.
  • torque — total system torque (Nm) for electrified vehicles; engine torque for ICE; summed motor output when no aggregate is available. Default order: desc.
  • mpg — combined US mpg from the available test cycle (combined, WLTC, EPA, CLTC, NEDC-equivalent, or NEDC); falls back to extra-urban mpg or EV MPGe. Default order: desc.
  • acceleration — 0–100 km/h time in seconds. Default order: asc (faster = lower).
  • max_speed — top speed in km/h. Default order: desc.
  • curb_weight — kerb weight in kg. Default order: asc (lighter = lower).
  • cargo — maximum trunk/boot volume in litres. Default order: desc.
order'asc' | 'desc' required

Sort order applied

total_matchinginteger required

Total vehicles matching the filters (before limit)

showinginteger required

Number of results returned

Example response

{
  "metric": "horsepower"
}

Changes

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