GET/v2/carfacets

Available values and counts for each dimension, given a selection.

Builds every dependent dropdown in one request instead of one request per level. Facets narrow with whatever is already selected.

API Ninjas·$0.001 per call

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "api-ninjas",
  path: "/v2/carfacets"
});

console.log(output);

Query parameters

facets

string

Comma-separated dimensions to count, at most 6. One of: make, model, generation, chassis_code, body, doors, fuel, transmission, drive, cylinders, year, badge.

make

string

Manufacturer, as a word. Case and punctuation are ignored, so bmw, BMW and Bmw all resolve.

model

string

Model, as a word. '3 Series', '3-series' and '3series' all resolve.

generation

string

Generation, as a word.

body

string

Body style. (Allowed: Sedan, Coupe, Convertible, Wagon, Hatchback, Liftback, SUV, MPV, Van, Pickup)

doors

number

Number of doors.

fuel

string

Fuel type. (Allowed: gasoline, diesel, electric, hybrid, plugin_hybrid, lpg, cng, hydrogen, ethanol)

transmission

string

Transmission type. (Allowed: manual, automatic, cvt, dual_clutch, automated_manual, single_speed)

drive

string

Driven wheels. (Allowed: fwd, rwd, awd, 4wd)

cylinders

number

Number of cylinders.

year

number

Cars in production in this year.