GET
/
{vin}
-
{photoIndex}
.jpg

View a photo of a vehicle by its Vehicle Identification Number (VIN) and photo index. The API provides access to a collection of high-quality images that can be used to enhance your website, listings, or marketing materials.

photos.vin is our content delivery network (CDN) for vehicle photos. Enhance your vehicle listings with high-quality images from our database of over 1.5 million vehicles.

subdomain
string

The target subdomain for the image. This is either wholesale or retail.

vin
string

The vehicle identification number (VIN) of the vehicle.

photoIndex
number

The index of the photo. The index starts at 1 and goes up to 100.

Query parameters

w
number

The width of the image in pixels. The maximum width is 1920 pixels. If the width is not specified, the original width of the image is used. If combined with the h parameter, the image is resized to fit within the specified dimensions while maintaining the original aspect ratio. However, you can also use the fit to specify how the image is resized (cover, contain, fill, inside, outside).

h
number

The height of the image in pixels. The maximum height is 1920 pixels. If the height is not specified, the original height of the image is used. If combined with the w parameter, the image is resized to fit within the specified dimensions while maintaining the original aspect ratio. However, you can also use the fit to specify how the image is resized (cover, contain, fill, inside, outside).

fit
string
default: "cover"

The fit parameter specifies how the image is resized to fit within the specified dimensions. The following values are supported: - cover: The image is resized to fill the specified dimensions while maintaining the original aspect ratio. The image is cropped if necessary. (This is our recommended option.) - contain: The image is resized to fit within the specified dimensions while maintaining the original aspect ratio. The image is not cropped. - fill: The image is resized to fill the specified dimensions while maintaining the original aspect ratio. The image is not cropped. - inside: The image is resized to fit within the specified dimensions while maintaining the original aspect ratio. The image is not cropped. - outside: The image is resized to fill the specified dimensions while maintaining the original aspect ratio. The image is cropped if necessary.

quality
string

The quality parameter specifies the quality of the image. The value must be a number between 0 and 100. The default value is 85. Only applies to JPEG, WebP, and TIFF images.

output
string

Encodes the image to a specific format. Accepts jpg, png, gif, tiff, webp or json. If none is given, it will honor the origin image format.