Vehicle Images API

Access a library of vehicle images for your website or app.

The Vehicle Images API looks up high-quality photos of vehicles from their year, make, and model. You can also specify trim, vehicle color or angle.

All attributes are case sensitive. To ensure you receive the intended response make sure to use the attribute values as shown below. For example, to retrieve images with a public license only use license=Public any other value such as public (lowercase) or PUBLIC (all caps) will not work as intended.

This endpoint allows you to retrieve the images for a specific vehicle based on a list of possible filters such as make, model, year and more.

Required attributes

Name
key
Type
string
Description
Your CarsXE API key.
Name
make
Type
string
Description
The vehicle make.
Name
model
Type
string
Description
The vehicle model.

Optional attributes

Name
year
Type
string
Description
The vehicle year.
Name
trim
Type
string
Description
The vehicle trim.
Name
color
Type
string
Description
The vehicle color.
Name
transparent
Type
boolean
Description
Prioritize images with transparent background. Could be true or false. Defaults to true.
Name
angle
Type
string
Description
The vehicle's angle. One of front, front three-quarter, side, rear, or rear three-quarter. Omit to return all angles.
Name
photoType
Type
string
Description
Optionally request images of either the interior, exterior or engine. Can only be used in conjunction with year, make, model and trim query params.
Name
size
Type
string
Description
Optionally request images of size: Small, Medium, Large, Wallpaper or All. By default it returns all sizes.
Name
license
Type
string
Description
Filter images by the following license types: Public, Share, ShareCommercially, Modify or ModifyCommercially. You may leave this field blank to return all images.
Name
format
Type
string
Description
The format of the response. One of json or xml. Defaults to json.
Name
validate
Type
boolean
Description
AI-powered image quality filtering. Defaults to true. When enabled, results are filtered to remove parts listings, renders, and unrelated content — only clean, relevant vehicle photos are returned. Fewer than 10 images may be returned and response time may be slightly longer. Pass validate=false to skip filtering and receive up to 10 unfiltered images at the fastest speed.

Response attributes

Name
query
Type
object
Description
Object detailing the query you made.
Name
images
Type
array
Description
A list of image objects. Each contains a MIME type, full image link, context link, dimensions (height/width), byte size, and thumbnail link.
Name
success
Type
boolean
Description
Whether the images has been retrieved.
Name
error
Type
string
Description
String detailing error if any.

Perguntas frequentes

Request

GET

/images

curl -G https://api.carsxe.com/images \
  -d key=CARSXE_API_KEY \
  -d year=2019 \
  -d make=jaguar \
  -d model=f-pace

Response

{
  "query": {
    "year": "2019",
    "make": "jaguar",
    "model": "f-pace"
  },
  "images": [
    {
      "mime": "image/jpeg",
      "link": "https://www.exclusiveautomotivegroup.com/imagetag/3162/main/l/Used-2019-Jaguar-F-PACE-25t-Premium-1657742271.jpg",
      "contextLink": "https://www.exclusiveautomotivegroup.com/2019-jaguar-f-pace-25t-premium-c-3162/",
      "height": 1279,
      "width": 1919,
      "byteSize": 425535,
      "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT23lCo9X3qJKNVHaiVfUDLkVibj2sz58LZ5YcrfZoRr5coErPxdLmnrVI&s",
      "thumbnailHeight": 100,
      "thumbnailWidth": 150,
      "hostPageDomainFriendlyName": "",
      "accentColor": "",
      "datePublished": ""
    },
    {
      "mime": "image/jpeg",
      "link": "https://www.perfectautocollection.com/imagetag/2185/2/l/Used-2019-Jaguar-F-PACE-20d-Prestige-1669673633.jpg",
      "contextLink": "https://www.perfectautocollection.com/used-vehicle-2019-jaguar-f-pace-20d-prestige-c-2185/",
      "height": 1277,
      "width": 1920,
      "byteSize": 400471,
      "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRG8MUlww6vvIP_52-2XCh2OPx1n-ix2THTRcevTpRl_-Im_aW8uzATMw&s",
      "thumbnailHeight": 100,
      "thumbnailWidth": 150,
      "hostPageDomainFriendlyName": "",
      "accentColor": "",
      "datePublished": ""
    },
    {
      "mime": "image/webp",
      "link": "https://static.overfuel.com/photos/306/192683/3f0d5bd91fa1417d983339d61205da10.webp",
      "contextLink": "https://www.luxmotors.com/used-cars/2019-jaguar-f-pace-s-SADCM2FV6KA360455",
      "height": 682,
      "width": 1024,
      "byteSize": 79808,
      "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSrIrEKmkRJTbLlv1vsJUOPMOt5tkOYGnEjeWP4YEKC8WeI-Yo7Tql7qmw&s",
      "thumbnailHeight": 100,
      "thumbnailWidth": 150,
      "hostPageDomainFriendlyName": "",
      "accentColor": "",
      "datePublished": ""
    },
    {
      "mime": "image/jpeg",
      "link": "https://media.production.jlrms.com/alf/images/2019-06/10837707-3ebc-4ad4-8cd6-9897079fb25b/jfpacedrivesglacierwhite30tv6portfolio280416061resizex682.JPG?VersionId=b4hIPF5rZK0TYZCf85TY5bW1GoPR8nhW",
      "contextLink": "https://archive.jaguar.com/en-us/news/2019/03/technical-press-kit-2019-jaguar-f-pace",
      "height": 682,
      "width": 1023,
      "byteSize": 229820,
      "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjZwKPOPAqartXvOuqypkuMNv43bRqtS8KaXsVsx62xTeA2es0xJo8jg&s",
      "thumbnailHeight": 100,
      "thumbnailWidth": 150,
      "hostPageDomainFriendlyName": "",
      "accentColor": "",
      "datePublished": ""
    },
    {
      "mime": "image/jpeg",
      "link": "https://di-uploads-pod10.dealerinspire.com/jaguarofcharleston/uploads/2019/01/2019-Jaguar-F-PACE-side-view.jpg",
      "contextLink": "https://www.jaguarcharleston.com/2019-jaguar-f-pace-configurations/",
      "height": 400,
      "width": 1000,
      "byteSize": 24570,
      "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTPNLEnQ7avCKJTdGQZcx95DAuFjuPk0wdYzyRClayQ0yhqMM4F5_oMhKk&s",
      "thumbnailHeight": 60,
      "thumbnailWidth": 149,
      "hostPageDomainFriendlyName": "",
      "accentColor": "",
      "datePublished": ""
    },
    {
      "mime": "image/jpeg",
      "link": "https://f.hubspotusercontent00.net/hubfs/2684054/car-review-blog/review_337113_1.jpg",
      "contextLink": "https://www.carpro.com/vehicle-reviews/2019-jaguar-f-pace-svr-review",
      "height": 480,
      "width": 640,
      "byteSize": 96979,
      "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ8znK5YuzDubqU4InxEjrYscVBsGrSktd5_0LJPfI_wdf8iFolmuaHmYk&s",
      "thumbnailHeight": 103,
      "thumbnailWidth": 137,
      "hostPageDomainFriendlyName": "",
      "accentColor": "",
      "datePublished": ""
    },
    {
      "mime": "image/jpeg",
      "link": "https://www.exoticmotorsportsok.com/imagetag/2103/main/l/Used-2019-Jaguar-F-PACE-SVR-1714496536.jpg",
      "contextLink": "https://www.exoticmotorsportsok.com/used-vehicle-2019-jaguar-f-pace-svr-c-2103/",
      "height": 1440,
      "width": 1920,
      "byteSize": 354790,
      "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXj00nUImgnvD3OdpnwePeXjs5nForTarXOIWCtBCmkxqwsOZzYGFN7A&s",
      "thumbnailHeight": 113,
      "thumbnailWidth": 150,
      "hostPageDomainFriendlyName": "",
      "accentColor": "",
      "datePublished": ""
    },
    {
      "mime": "image/jpeg",
      "link": "https://www.motorcarspalmbeach.com/imagetag/120/main/l/Used-2019-Jaguar-F-PACE-S-1646175841.jpg",
      "contextLink": "https://www.motorcarspalmbeach.com/used-vehicle-2019-jaguar-f-pace-s-c-120/",
      "height": 1200,
      "width": 1600,
      "byteSize": 204455,
      "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRq2UAxnMDe6jsuHXnPMmm7qqV7pHCNaPD3nR_faztO2xrCPfsA-bHhQw&s",
      "thumbnailHeight": 113,
      "thumbnailWidth": 150,
      "hostPageDomainFriendlyName": "",
      "accentColor": "",
      "datePublished": ""
    }
  ],
  "success": true,
  "error": ""
}

Optional attributes

Name
year
Type
string
Description
The vehicle year.
Name
trim
Type
string
Description
The vehicle trim.
Name
color
Type
string
Description
The vehicle color.
Name
transparent
Type
boolean
Description
Prioritize images with transparent background. Could be true or false. Defaults to true.
Name
angle
Type
string
Description
The vehicle's angle. One of front, front three-quarter, side, rear, or rear three-quarter. Omit to return all angles.
Name
photoType
Type
string
Description
Optionally request images of either the interior, exterior or engine. Can only be used in conjunction with year, make, model and trim query params.
Name
size
Type
string
Description
Optionally request images of size: Small, Medium, Large, Wallpaper or All. By default it returns all sizes.
Name
license
Type
string
Description
Filter images by the following license types: Public, Share, ShareCommercially, Modify or ModifyCommercially. You may leave this field blank to return all images.
Name
format
Type
string
Description
The format of the response. One of json or xml. Defaults to json.
Name
validate
Type
boolean
Description
AI-powered image quality filtering. Defaults to true. When enabled, results are filtered to remove parts listings, renders, and unrelated content — only clean, relevant vehicle photos are returned. Fewer than 10 images may be returned and response time may be slightly longer. Pass validate=false to skip filtering and receive up to 10 unfiltered images at the fastest speed.

Response attributes

Name
query
Type
object
Description
Object detailing the query you made.
Name
images
Type
array
Description
A list of image objects. Each contains a MIME type, full image link, context link, dimensions (height/width), byte size, and thumbnail link.
Name
success
Type
boolean
Description
Whether the images has been retrieved.
Name
error
Type
string
Description
String detailing error if any.

Perguntas frequentes

{ "query": { "year": "2019", "make": "jaguar", "model": "f-pace" }, "images": [ { "mime": "image/jpeg", "link": "https://www.exclusiveautomotivegroup.com/imagetag/3162/main/l/Used-2019-Jaguar-F-PACE-25t-Premium-1657742271.jpg", "contextLink": "https://www.exclusiveautomotivegroup.com/2019-jaguar-f-pace-25t-premium-c-3162/", "height": 1279, "width": 1919, "byteSize": 425535, "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT23lCo9X3qJKNVHaiVfUDLkVibj2sz58LZ5YcrfZoRr5coErPxdLmnrVI&s", "thumbnailHeight": 100, "thumbnailWidth": 150, "hostPageDomainFriendlyName": "", "accentColor": "", "datePublished": "" }, { "mime": "image/jpeg", "link": "https://www.perfectautocollection.com/imagetag/2185/2/l/Used-2019-Jaguar-F-PACE-20d-Prestige-1669673633.jpg", "contextLink": "https://www.perfectautocollection.com/used-vehicle-2019-jaguar-f-pace-20d-prestige-c-2185/", "height": 1277, "width": 1920, "byteSize": 400471, "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRG8MUlww6vvIP_52-2XCh2OPx1n-ix2THTRcevTpRl_-Im_aW8uzATMw&s", "thumbnailHeight": 100, "thumbnailWidth": 150, "hostPageDomainFriendlyName": "", "accentColor": "", "datePublished": "" }, { "mime": "image/webp", "link": "https://static.overfuel.com/photos/306/192683/3f0d5bd91fa1417d983339d61205da10.webp", "contextLink": "https://www.luxmotors.com/used-cars/2019-jaguar-f-pace-s-SADCM2FV6KA360455", "height": 682, "width": 1024, "byteSize": 79808, "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSrIrEKmkRJTbLlv1vsJUOPMOt5tkOYGnEjeWP4YEKC8WeI-Yo7Tql7qmw&s", "thumbnailHeight": 100, "thumbnailWidth": 150, "hostPageDomainFriendlyName": "", "accentColor": "", "datePublished": "" }, { "mime": "image/jpeg", "link": "https://media.production.jlrms.com/alf/images/2019-06/10837707-3ebc-4ad4-8cd6-9897079fb25b/jfpacedrivesglacierwhite30tv6portfolio280416061resizex682.JPG?VersionId=b4hIPF5rZK0TYZCf85TY5bW1GoPR8nhW", "contextLink": "https://archive.jaguar.com/en-us/news/2019/03/technical-press-kit-2019-jaguar-f-pace", "height": 682, "width": 1023, "byteSize": 229820, "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjZwKPOPAqartXvOuqypkuMNv43bRqtS8KaXsVsx62xTeA2es0xJo8jg&s", "thumbnailHeight": 100, "thumbnailWidth": 150, "hostPageDomainFriendlyName": "", "accentColor": "", "datePublished": "" }, { "mime": "image/jpeg", "link": "https://di-uploads-pod10.dealerinspire.com/jaguarofcharleston/uploads/2019/01/2019-Jaguar-F-PACE-side-view.jpg", "contextLink": "https://www.jaguarcharleston.com/2019-jaguar-f-pace-configurations/", "height": 400, "width": 1000, "byteSize": 24570, "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTPNLEnQ7avCKJTdGQZcx95DAuFjuPk0wdYzyRClayQ0yhqMM4F5_oMhKk&s", "thumbnailHeight": 60, "thumbnailWidth": 149, "hostPageDomainFriendlyName": "", "accentColor": "", "datePublished": "" }, { "mime": "image/jpeg", "link": "https://f.hubspotusercontent00.net/hubfs/2684054/car-review-blog/review_337113_1.jpg", "contextLink": "https://www.carpro.com/vehicle-reviews/2019-jaguar-f-pace-svr-review", "height": 480, "width": 640, "byteSize": 96979, "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ8znK5YuzDubqU4InxEjrYscVBsGrSktd5_0LJPfI_wdf8iFolmuaHmYk&s", "thumbnailHeight": 103, "thumbnailWidth": 137, "hostPageDomainFriendlyName": "", "accentColor": "", "datePublished": "" }, { "mime": "image/jpeg", "link": "https://www.exoticmotorsportsok.com/imagetag/2103/main/l/Used-2019-Jaguar-F-PACE-SVR-1714496536.jpg", "contextLink": "https://www.exoticmotorsportsok.com/used-vehicle-2019-jaguar-f-pace-svr-c-2103/", "height": 1440, "width": 1920, "byteSize": 354790, "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXj00nUImgnvD3OdpnwePeXjs5nForTarXOIWCtBCmkxqwsOZzYGFN7A&s", "thumbnailHeight": 113, "thumbnailWidth": 150, "hostPageDomainFriendlyName": "", "accentColor": "", "datePublished": "" }, { "mime": "image/jpeg", "link": "https://www.motorcarspalmbeach.com/imagetag/120/main/l/Used-2019-Jaguar-F-PACE-S-1646175841.jpg", "contextLink": "https://www.motorcarspalmbeach.com/used-vehicle-2019-jaguar-f-pace-s-c-120/", "height": 1200, "width": 1600, "byteSize": 204455, "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRq2UAxnMDe6jsuHXnPMmm7qqV7pHCNaPD3nR_faztO2xrCPfsA-bHhQw&s", "thumbnailHeight": 113, "thumbnailWidth": 150, "hostPageDomainFriendlyName": "", "accentColor": "", "datePublished": "" } ], "success": true, "error": "" }

Vehicle Images API

Required attributesCopiar seção para LLMCopiar link para a seçãoPerguntar à IA sobre esta seção

Optional attributesCopiar seção para LLMCopiar link para a seçãoPerguntar à IA sobre esta seção

Response attributesCopiar seção para LLMCopiar link para a seçãoPerguntar à IA sobre esta seção

Perguntas frequentes

Request

Response

Vehicle Images API

Required attributesCopiar seção para LLMCopiar link para a seçãoPerguntar à IA sobre esta seção

Optional attributesCopiar seção para LLMCopiar link para a seçãoPerguntar à IA sobre esta seção

Response attributesCopiar seção para LLMCopiar link para a seçãoPerguntar à IA sobre esta seção

Perguntas frequentes

Request

Response

Required attributes

Optional attributes

Response attributes

Required attributes

Optional attributes

Response attributes