CAcarsxe
Images

Vehicle Images

Changed on

Retrieve images of a vehicle by make, model and other filters.

Credit plans: 2 credits per successful billable lookup. Failed lookups and no-data errors do not use credits. See https://carsxe.com/pricing.md for billing units.

get/images

Request

Query parameters

makestring required

The vehicle make.

modelstring required

The vehicle model.

yearstring

The vehicle year.

trimstring

The vehicle trim.

colorstring

The vehicle color.

transparentboolean

Prioritize images with transparent background. Defaults to true.

angle'front' | 'side' | 'back'

The angle to show the car in.

photoType'interior' | 'exterior' | 'engine'

Request images of the interior, exterior or engine. Can only be used in conjunction with year, make, model and trim query params.

size'Small' | 'Medium' | 'Large' | 'Wallpaper' | 'All'

Request images of a given size. Defaults to all sizes.

licensestring
Example:ModifyCommercially

Filter images by usage-rights labels supplied by the hosting site. This does not grant a license; confirm each image's contextLink before reuse. Presets: Public (public domain only); Share (free to use or share, including NonCommercial and NoDerivatives); ShareCommercially (free to share commercially; excludes NonCommercial, includes NoDerivatives); Modify (free to modify; excludes NoDerivatives, includes NonCommercial); ModifyCommercially (free to modify commercially; public domain, attribution, and ShareAlike only). Or pass specific tokens as a comma-separated list: cc_publicdomain (public domain), cc_attribute (attribution; commercial use and modification, with credit when shared), cc_sharealike (ShareAlike; shared adaptations use the same license), cc_noncommercial (NonCommercial), cc_nonderived (NoDerivatives). Prefix a token with - to exclude it. At least one included token is required. Leave blank to return all images.

format'json' | 'xml'

The format of the response. One of json or xml.

Response

Images retrieved.

successboolean
errorstring
queryobject

Changes

  • 149df30e396aRevision changes
    • breaking

      removed the enum value Modify from the query request parameter license

    • breaking

      removed the enum value ModifyCommercially from the query request parameter license

    • breaking

      removed the enum value Public from the query request parameter license

    • breaking

      removed the enum value Share from the query request parameter license

    • breaking

      removed the enum value ShareCommercially from the query request parameter license