Esta documentação está sendo aposentada para docs.carsxe.com. Este site será descomissionado em 1º de outubro de 2026.
Ir para a nova documentaçãoAccess 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.
keyYour CarsXE API key.
makeThe vehicle make.
modelThe vehicle model.
yearThe vehicle year.
trimThe vehicle trim.
colorThe vehicle color.
transparentPrioritize images with transparent background. Could be true or false. Defaults to true.
angleThe vehicle's angle. One of front, front three-quarter, side, rear, or rear three-quarter. Omit to return all angles.
photoTypeOptionally request images of either the interior, exterior or engine. Can only be used in conjunction with year, make, model and trim query params.
sizeOptionally request images of size: Small, Medium, Large, Wallpaper or All. By default it returns all sizes.
licenseFilter images by the following license types: Public, Share, ShareCommercially, Modify or ModifyCommercially. You may leave this field blank to return all images.
formatThe format of the response. One of json or xml. Defaults to json.
validateReturn only clean, relevant vehicle photos. Defaults to true. May return fewer than 10 images and take slightly longer. Pass false for up to 10 images at full speed.
queryObject detailing the query you made.
imagesA list of image objects. Each contains a MIME type, full image link, context link, dimensions (height/width), byte size, and thumbnail link.
successWhether the images has been retrieved.
errorString detailing error if any.
We support a wide range of makes and models, from mainstream passenger cars and trucks to motorcycles, RVs, and more. Coverage varies by make, model, and year — popular vehicles typically return more results.
Make sure to pass the proper license type you'd like to use in the API request to make sure you can use the image commercially. Note: vehicle attributes are case sensitive.
We try our hardest to match your request to what's available but if we're unable to find a vehicle in that particular color we pass the next best thing available.
Up to 10 per request. The default may return fewer.
On by default: returns only clean, relevant photos (may be slightly slower). Pass false for full speed.
Yes! The Vehicle Images API is included in the free Sandbox as part of the shared lifetime quota (up to 100 API calls). For more information visit our pricing page.
curl -G https://api.carsxe.com/images \
-d key=CARSXE_API_KEY \
-d year=2019 \
-d make=jaguar \
-d model=f-pace{
"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": ""
}