Image to Vehicle

Search for a vehicle using an image and get detailed info


Have you ever looked at a car or a picture of a car and wondered what's the make, model and year of that vehicle?

The What Car Is That? API given an image (link or base64 string) uses machine learning to identify the particular make, model, year, and body style of the car in the image. The API is able to identify over 3000 vehicles and the dataset is growing everyday!


This endpoint allows you to retrieve a vehicle's basic specifications such as make, model and year from an image.

Required attributes

  • Name
    key
    Type
    string
    Description

    Your CarsXE API key.

  • Name
    body
    Type
    string
    Description

    POST body that's a URL to an image or the base64 string of the image.


Response attributes

  • Name
    success
    Type
    boolean
    Description

    Whether the algorithm has been able to successfully analyze the image.

  • Name
    results
    Type
    array
    Description

    A list (array) of "vehicle" elements or objects, each of which contain the body style, year, make, model and confidence score (between 0 and 1).

    The confidence score is a probability that the vehicle in the image matches the values returned.

  • Name
    message
    Type
    string
    Description

    String detailing error if any.

Frequently asked questions

Request

POST
/whatcaristhat
curl --location 'https://api.carsxe.com/whatcaristhat?key=CARSXE_API_KEY' \
--header 'Content-Type: text/plain' \
--data 'https://upload.wikimedia.org/wikipedia/commons/4/44/2019_Acura_RDX_A-Spec_front_red_4.2.18.jpg'

Response

{
  "success": true,
  "results": [{
      "body_style": "SUV",
      "confidence": "0.99",
      "make": "Acura",
      "model": "RDX",
      "model_year": "2018"
  },
  {
      "body_style": "SUV",
      "confidence": "0.00",
      "make": "Acura",
      "model": "RDX",
      "model_year": "2015"
  },{...}],
  "message": "Could not make out the vehicle in the image."
}