Vehicle Images - CarsXE Docs

Fetch real vehicle photos for any make and model. The endpoint searches the web for matching images, validates each one with AI to confirm it shows the right vehicle, and returns up to 10 results per call. Filter by angle, color, photo type, and size to get exactly the images your use case needs.

Parameters

Parameter	Required	Description
`make`	Yes	Vehicle manufacturer. Example: `"Toyota"`, `"Ford"`, `"BMW"`
`model`	Yes	Vehicle model name. Example: `"Camry"`, `"F-150"`, `"3 Series"`
`key`	Yes	Your CarsXE API key
`year`	No	4-digit model year. Narrows results to a specific model year
`trim`	No	Trim level. Helps surface images of the right variant
`color`	No	Preferred vehicle color. Example: `"red"`, `"midnight blue"`
`angle`	No	`front`, `side`, or `back`
`photoType`	No	`exterior` (default), `interior`, or `engine`
`size`	No	`Small`, `Medium`, `Large`, `Wallpaper`, or `All`
`license`	No	Filter by usage rights: `Public`, `Share`, `ShareCommercially`, `Modify`, or `ModifyCommercially`
`transparent`	No	`true` (default) — prefer images with transparent/white backgrounds
`validate`	No	`true` (default) — AI validates each image before including it in the response
`format`	No	`json` (default) or `xml`

Example

Get vehicle images

Code

curl -G https://api.carsxe.com/images \
  -d key=YOUR_API_KEY \
  -d make=Toyota \
  -d model=Camry \
  -d year=2022 \
  -d angle=front

Response

Top-level shape

{

"success": true,// always true on 200

}

Click the query or images sections to expand them and see sample data. For the full interactive reference, try it live in the API Reference.

The images array is always present. It will be empty if no matching images pass validation — not absent.

images

Each object in the images array represents one validated vehicle photo.

Name
mime
Type
string
Description
The MIME type of the image file. Example: "image/jpeg", "image/png", "image/webp".
Name
link
Type
string
Description
Direct URL to the full-resolution image. Use this to display or download the image. URLs are sourced from the public web and may become unavailable over time — cache images on your end if persistence matters.
Name
contextLink
Type
string
Description
URL of the web page where this image was found. Useful for attribution or linking users back to the original source.
Name
height
Type
string | number
Description
Image height in pixels. May be returned as a string or number depending on the source.
Name
width
Type
string | number
Description
Image width in pixels. May be returned as a string or number depending on the source. All images are at least 300px on their shortest side.
Name
byteSize
Type
number | string
Description
File size in bytes. Useful for estimating download time or enforcing size limits before fetching the full image.
Name
thumbnailLink
Type
string
Description
URL to a smaller cached thumbnail of the image, hosted by Google. Faster to load than the full image — useful for previews and grids.
Name
thumbnailHeight
Type
string
Description
Thumbnail height in pixels.
Name
thumbnailWidth
Type
string
Description
Thumbnail width in pixels.

AI validation

By default, each image is validated by AI before being included in the response. The validator confirms the image shows the correct vehicle make, model, and year — images that don't match are dropped.

Set validate=false to skip validation. This reduces latency but may return images that don't precisely match the requested vehicle.

Errors

See the Errors guide for the full list. The most common cases specific to this endpoint:

400 — "Missing make" or "Missing model" — both parameters are required. Add them and retry.
404 — No images found for this combination — try relaxing your filters (remove angle, color, or trim) or verify the make and model spelling.

llms.txt llms-full.txt