Vehicle Images from Description

Powered by EVOX

Enhance your website or app with high quality vehicle images.  

Consistent images are the hallmark of a quality website, and EVOX are meticulous in their attention to detail ensuring images are identical in all key aspects: shot angles, lighting and post-production.  

This powerful descriptive search delivers the closest matching vehicle image,  in the correct manufacturer colour (where provided) and is included for free with all EVOX Vehicle Image Licences to enable easy mapping of car images in your website or app.

Key features:

 

  • Search by make, model and year

  • Search by generic, or manufacturer colour name

  • Identifies the closest matching variant from an extensive library of images

  • Returns links for a 3-angle set of images in manufacturer colours

  • Free with all EVOX Vehicle Images Licences 

 

Pricing

PAYG
free
Per Use

Sample Response

Documentation

Introduction

This endpoint returns high quality vehicle images, in multiple angles and all manufacturer colours.

Header

When making calls to our API, include the following header:

x-api-key:your-api-key-here

Example Request

https://api.oneautoapi.com/evox/colourimagesetfromdescription/?manufacturer_desc=Mini&model_range_desc=Countryman&image_specification=D&number_doors=5&oem_model_year=2021&generic_colour_desc=Black&derivative_desc=Cooper&body_type_desc=Estate&oem_colour_desc=Midnight Black Metallic

Example Sandbox Request

https://sandbox.oneautoapi.com/evox/colourimagesetfromdescription/?manufacturer_desc=Mini&model_range_desc=Countryman&image_specification=D&number_doors=5&oem_model_year=2021&generic_colour_desc=Black&derivative_desc=Cooper&body_type_desc=Estate&oem_colour_desc=Midnight Black Metallic

Request Parameters

manufacturer_desc
mandatory, string, e.g. Mini
Manufacturer description
model_range_desc
mandatory, string, e.g. Countryman
Model range description
image_specification
mandatory, string, e.g. D
The size and type of images to be returned (JPEG) - A (320X240), B (480X360), C (680X480), D* (680X480), E (1280X960), F (2400X1800), G (2400X1800) *transparent background
number_doors
optional, string, e.g. 5
The number of doors
oem_model_year
optional, string, e.g. 2021
The OEM model year
generic_colour_desc
optional, string, e.g. Black
The generic colour description
derivative_desc
optional, string, e.g. Cooper
The derivative description
body_type_desc
optional, string, e.g. Estate
The body type description
oem_colour_desc
optional, string, e.g. Midnight Black Metallic
The OEM's colour description

Sample Response

{
  "success": true,
  "result": [
    {
      "vehicle_desc": "Mini Cooper S",
      "number_doors": 3,
      "body_type_desc": "hatchback",
      "oem_model_year": 2021,
      "image_library_source": "EU",
      "is_best_match": true,
      "oem_colour_desc_list": [
        "Alpine White",
        "Black Sapphire Metallic",
        "Sunset Orange Metallic",
        "Arctic Grey",
        "Tanzanite Blue Metallic"
      ],
      "images": [
        {
          "oem_colour_desc": "Midnight Black Metallic",
          "generic_colour_desc": "Black",
          "side_image_url": "https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_001/MY2013/cc1234_001_A94.jpg",
          "rear_image_url": "https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_002/MY2013/cc1234_001_A94.jpg",
          "front_image_url": "https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_003/MY2013/cc1234_001_A94.jpg"
        }
      ],
      "end_user_licence_agreement_url": "https://www.evox.com/20181025/eula/EVOX_sublicensee_EULA.pdf"
    }
  ],
  "error": "If there is an error the message would go here"
}

Response Parameters

success
e.g. true
Whether the api call was successful
vehicle_desc
e.g. Mini Cooper S
The Vehicle description
number_doors
e.g. 3
Number of doors.
body_type_desc
e.g. hatchback
The body type description
oem_model_year
e.g. 2021
The OEM's model year
image_library_source
e.g. EU
The EVOX image library source
is_best_match
e.g. true
Boolean identifying the closest matching image
oem_colour_desc
e.g. Midnight Black Metallic
The OEM's colour description
generic_colour_desc
e.g. Black
The generic colour description
side_image_url
e.g. https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_001/MY2013/cc1234_001_A94.jpg
The side image URL
rear_image_url
e.g. https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_002/MY2013/cc1234_001_A94.jpg
The rear image URL
front_image_url
e.g. https://a1bcdefghij2kl.example.net/3mn456o11q1r2131rs41tu/color_1234_003/MY2013/cc1234_001_A94.jpg
The front image URL
end_user_licence_agreement_url
e.g. https://www.evox.com/20181025/eula/EVOX_sublicensee_EULA.pdf
Theend user licence agreement
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call

Status Codes

200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com

Also Available From EVOX Images

One Auto API Limited
Terms Privacy Policy