Vehicle Images - CarsXE Docs

Fetch real vehicle photos for any make and model. Returns up to 10 clean, relevant 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	`interior`, `exterior`, or `engine`. Only valid alongside `make`, `model`, `year`, and `trim`
`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) — return only clean, relevant vehicle photos
`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 when no matching images are found — not absent.

images

Each object in the images array represents one 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.
Name
contextLink
Type
string
Description
Related page URL for the image — useful for attribution.
Name
height
Type
string | number
Description
Image height in pixels. May be returned as a string or number depending on the image.
Name
width
Type
string | number
Description
Image width in pixels. May be returned as a string or number depending on the image. 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 thumbnail of the image. 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.

Image quality

By default (validate=true), results include only clean, relevant vehicle photos that match the requested make, model, and year.

Pass validate=false for up to 10 images at full speed.

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.

Retrieve photos of any vehicle by make, model, and year — filter by angle, color, and size.