Vehicle Research

The Vehicle Research API provides comprehensive access to detailed vehicle specifications, variants, images, and color information. Use these endpoints to retrieve accurate and up-to-date vehicle data for any make, model, and year combination.

The Vehicle Variant Model

The vehicle variant model contains detailed specifications and information about a specific vehicle configuration.

Properties

Name
id
Type
string
Description
Unique identifier for the vehicle variant.
Name
make
Type
string
Description
Vehicle manufacturer name.
Name
model
Type
string
Description
Vehicle model name.
Name
year
Type
integer
Description
Model year of the vehicle.
Name
trim
Type
string
Description
Specific trim level of the vehicle.
Name
msrp
Type
number
Description
Manufacturer's suggested retail price.
Name
styleName
Type
string
Description
Full style name including trim and transmission.
Name
region
Type
string
Description
Market region code (e.g., "US", "CA").
Name
bodyStyle
Type
string
Description
Body style description.
Name
spec
Type
object
Description
Detailed vehicle specifications grouped by category.
- Name
  Fuel
  Type
  object
  Description
  Fuel-related specifications including type, capacity, and consumption.
- Name
  Safety
  Type
  object
  Description
  Safety features and equipment.
- Name
  Comfort
  Type
  object
  Description
  Comfort and convenience features.
- Name
  Mechanical
  Type
  object
  Description
  Engine, transmission, and mechanical specifications.
- Name
  Exterior
  Type
  object
  Description
  External dimensions and features.
- Name
  Interior
  Type
  object
  Description
  Interior dimensions and features.

The Vehicle Image Model

Name
id
Type
integer
Description
Unique identifier for the image.
Name
url
Type
string
Description
URL path to the image resource.
Name
width
Type
integer
Description
Image width in pixels.
Name
height
Type
integer
Description
Image height in pixels.
Name
type
Type
string
Description
Type of image asset.
Name
metadata
Type
object
Description
Additional image metadata including category, provider, and shot type.

The Vehicle Colors Model

Name
EXTERIOR
Type
array
Description
Array of available exterior colors.
- Name
  name
  Type
  string
  Description
  Color name/description.
- Name
  rgb
  Type
  string
  Description
  RGB color values.
- Name
  hex
  Type
  string
  Description
  Hexadecimal color code.
Name
INTERIOR
Type
array
Description
Array of available interior colors with the same structure as exterior colors.

GET/v1/research/make/:make

Get variants by make

Retrieve all vehicle variants for a specific manufacturer.

Required parameters

Name
make
Type
string
Description
The vehicle manufacturer name.

Request

GET

/v1/research/make/:make

curl "https://api.cardog.ai/v1/research/make/honda" \
  -H "x-api-key: your-api-key"

Response

[
  {
    "id": "Hond-25CA-1ce0fdfcf884",
    "make": "Honda",
    "model": "Accord",
    "year": 2025,
    "trim": "LX",
    "msrp": 28295,
    "styleName": "Honda Accord",
    "region": "CA",
    "bodyStyle": "Sedan",
    "spec": {
      "Fuel": {
        "Fuel": "Gasoline",
        "Fuel Capacity": "56.0 L"
      },
      "Safety": {
        "Brake": "4 Wheel Disc",
        "Driver Air Bag": true,
        "Passenger Air Bag": true
      }
    }
  }
]

GET/v1/research/lineup/:make

Get vehicle lineup

Retrieve the complete vehicle lineup for a specific manufacturer, including models, years, MSRPs, and associated images.

Required parameters

Name
make
Type
string
Description
The vehicle manufacturer name.

Request

GET

/v1/research/lineup/:make

curl "https://api.cardog.ai/v1/research/lineup/honda" \
  -H "x-api-key: your-api-key"

Response

{
  "data": [
    {
      "make": "Honda",
      "model": "Accord",
      "year": 2025,
      "msrp": 28295,
      "images": [
        {
          "url": "https://images.cardog.io/research/honda/accord/2025/2025-honda-accord-touring-hybrid-sedan-exterior-shown.jpg",
          "make": "Honda",
          "model": "Accord",
          "year": 2025,
          "shotType": "FQ",
          "category": "EXTERIOR",
          "title": "2025 Honda Accord Touring Hybrid Sedan Exterior Shown",
          "color": "Canyon River Blue Metallic"
        }
      ]
    }
  ],
  "total": 50,
  "page": 1,
  "limit": 50
}

GET/v1/research/vin/:vin

Get variant by VIN

Retrieve vehicle variant information using a VIN (Vehicle Identification Number).

Required parameters

Name
vin
Type
string
Description
17-character Vehicle Identification Number.

Request

GET

/v1/research/vin/:vin

curl "https://api.cardog.ai/v1/research/vin/1HGCM82633A123456" \
  -H "x-api-key: your-api-key"

Response

{
  "error": "Variant not found"
}

GET/v1/research/make/:make/model/:model

Get variants by make and model

Retrieve all variants for a specific make and model combination.

Required parameters

Name
make
Type
string
Description
Vehicle manufacturer name.
Name
model
Type
string
Description
Vehicle model name.

Request

GET

/v1/research/make/:make/model/:model

curl "https://api.cardog.ai/v1/research/make/honda/model/accord" \
  -H "x-api-key: your-api-key"

Response

[
  {
    "id": "Hond-20CA-c9074ccbe912",
    "make": "Honda",
    "model": "Accord Sedan",
    "year": 2020,
    "trim": "Sport 2.0 Manual",
    "msrp": 34405,
    "styleName": "Honda Accord Sedan",
    "region": "CA",
    "bodyStyle": "Sport 2.0 Manual",
    "spec": {
      "Fuel": {
        "Fuel": "Gasoline",
        "Fuel Capacity": "56.0 L"
      }
    }
  }
]

GET/v1/research/make/:make/year/:year

Get variants by make and year

Retrieve all variants for a specific make and year combination.

Required parameters

Name
make
Type
string
Description
Vehicle manufacturer name.
Name
year
Type
integer
Description
Model year.

Request

GET

/v1/research/make/:make/year/:year

curl "https://api.cardog.ai/v1/research/make/honda/year/2020" \
  -H "x-api-key: your-api-key"

Response

[
  {
    "id": "Hond-20CA-c9074ccbe912",
    "make": "Honda",
    "model": "Accord Sedan",
    "year": 2020,
    "trim": "Sport 2.0 Manual",
    "msrp": 34405,
    "styleName": "Honda Accord Sedan",
    "region": "CA",
    "bodyStyle": "Sport 2.0 Manual"
  }
]

GET/v1/research/make/:make/model/:model/year/:year

Get variants by make, model and year

Retrieve all variants for a specific make, model, and year combination.

Required parameters

Name
make
Type
string
Description
Vehicle manufacturer name.
Name
model
Type
string
Description
Vehicle model name.
Name
year
Type
integer
Description
Model year.

Request

GET

/v1/research/make/:make/model/:model/year/:year

curl "https://api.cardog.ai/v1/research/make/honda/model/accord/year/2020" \
  -H "x-api-key: your-api-key"

Response

[
  {
    "id": "Hond-20CA-c9074ccbe912",
    "make": "Honda",
    "model": "Accord Sedan",
    "year": 2020,
    "trim": "Sport 2.0 Manual",
    "msrp": 34405,
    "styleName": "Honda Accord Sedan",
    "region": "CA",
    "bodyStyle": "Sport 2.0 Manual",
    "spec": {
      "Fuel": {
        "Fuel": "Gasoline",
        "Fuel Capacity": "56.0 L",
        "Fuel Consumption: City": "10.7 L/100 km",
        "Fuel Consumption: Highway": "7.3 L/100 km"
      },
      "Safety": {
        "Brake": "4 Wheel Disc",
        "Knee Air Bag": true,
        "Driver Air Bag": true,
        "Brake ABS System": true,
        "Traction Control": true,
        "Passenger Air Bag": true,
        "Rear Head Air Bag": true,
        "Stability Control": true
      },
      "Mechanical": {
        "Engine": "Intercooled Turbo Regular Unleaded I-4",
        "Torque": "273 ft-lb @ 1500 rpm",
        "Steering": "Power Steering",
        "Drivetrain": "Front-Wheel Drive",
        "Horsepower": "252 hp @ 6500 rpm",
        "Transmission": "6-Speed Manual"
      }
    }
  }
]

GET/v1/research/images/profiles/:make/:model/:year

Get profile images

Retrieve profile images for a specific vehicle make, model, and year combination.

Required parameters

Name
make
Type
string
Description
Vehicle manufacturer name.
Name
model
Type
string
Description
Vehicle model name.
Name
year
Type
integer
Description
Model year.

Request

GET

/v1/research/images/profiles/:make/:model/:year

curl "https://api.cardog.ai/v1/research/images/profiles/honda/accord/2020" \
  -H "x-api-key: your-api-key"

Response

[
  {
    "id": 4065483,
    "listingId": null,
    "type": "image",
    "url": "https://images.cardog.io/profiles/Honda/Accord Hybrid/2018/Honda Accord Hybrid Touring Sedan Profile Shown.png",
    "make": null,
    "model": null,
    "year": null,
    "width": 1280,
    "height": 854,
    "sizeBytes": null,
    "mimeType": "image/png",
    "sourceUri": "/Honda/Accord Hybrid/2018/Honda Accord Hybrid Touring Sedan Profile Shown.png",
    "sourceType": "bg-removed",
    "metadata": {
      "make": "Honda",
      "tags": "honda-accord-hybrid,honda,2021-honda-accord-hybrid",
      "year": "2021",
      "model": "Accord Hybrid",
      "category": "EXTERIOR",
      "provider": "OEM",
      "shot_type": "S",
      "submodels": "Accord Hybrid Sedan",
      "model_year_id": 401874145
    },
    "createdAt": "2025-03-08T20:29:14.069Z",
    "updatedAt": "2025-03-08T20:29:14.069Z",
    "removedAt": null
  }
]

GET/v1/research/images

Get vehicle images

Retrieve images for a specific vehicle make, model, and year combination.

Required query parameters

Name
make
Type
string
Description
Vehicle manufacturer name.
Name
model
Type
string
Description
Vehicle model name.
Name
year
Type
integer
Description
Model year.

Optional query parameters

Name
limit
Type
integer
Description
Maximum number of images to return (default: 10).

Request

GET

/v1/research/images?make=Honda&model=Accord&year=2020&limit=5

curl "https://api.cardog.ai/v1/research/images?make=Honda&model=Accord&year=2020&limit=5" \
  -H "x-api-key: your-api-key"

Response

[
  {
    "id": 4065483,
    "type": "image",
    "url": "https://images.cardog.io/profiles/Honda/Accord Hybrid/2018/Honda Accord Hybrid Touring Sedan Profile Shown.png",
    "width": 1280,
    "height": 854,
    "metadata": {
      "make": "Honda",
      "model": "Accord Hybrid",
      "year": "2021",
      "category": "EXTERIOR",
      "provider": "OEM",
      "shot_type": "S"
    }
  }
]

GET/v1/research/colors

Get vehicle colors

Retrieve available exterior and interior colors for a specific vehicle.

Required query parameters

Name
make
Type
string
Description
Vehicle manufacturer name.
Name
model
Type
string
Description
Vehicle model name.
Name
year
Type
integer
Description
Model year.

Request

GET

/v1/research/colors?make=Honda&model=Accord&year=2020

curl "https://api.cardog.ai/v1/research/colors?make=Honda&model=Accord&year=2020" \
  -H "x-api-key: your-api-key"

Response

{
  "EXTERIOR": [
    {
      "name": "Platinum White Pearl",
      "rgb": "231,233,232",
      "hex": "#E7E9E8"
    },
    {
      "name": "Crystal Black Pearl",
      "rgb": "29,29,29",
      "hex": "#1D1D1D"
    },
    {
      "name": "Modern Steel Metallic",
      "rgb": "51,59,72",
      "hex": "#333B48"
    },
    {
      "name": "Radiant Red Metallic",
      "rgb": "115,18,33",
      "hex": "#731221"
    }
  ],
  "INTERIOR": [
    {
      "name": "Black, cloth",
      "rgb": "25,25,25",
      "hex": "#191919"
    },
    {
      "name": "Gray, cloth",
      "rgb": "134,132,131",
      "hex": "#868483"
    },
    {
      "name": "Ivory, cloth",
      "rgb": "222,214,195",
      "hex": "#DED6C3"
    },
    {
      "name": "Black, leather",
      "rgb": "25,25,25",
      "hex": "#191919"
    }
  ]
}