• Welcome
• Introduction to API
• Vehicle Data
• Approved Content

Accessing Vehicle Data

This section of the API allows any authenticated user to fetch information about any vehicle we have information on.

Currently we have information on Subaru vehicles only, but will be updating the system with Isuzu data very soon.

See accessing the data for more details.

Available Data

Data includes features, specifications, prices, variations, images and associated files

The API currently contains data on the following vehicles:

• Subaru:
  • Forester (forester-2008)
  • Impreza (impreza-2007)
  • WRX Sti (wrx-sti-2008)
  • Justy (justy-2007)
  • Legacy Saloon (legacy-saloon-2003)
  • Legacy Sports Tourer (legacy-sports-tourer-2003)
  • Legacy Tourer – new for 2010 (legacy-tourer-2010)
  • Old Forester (forester-2002)
  • Outback (outback-2003)
  • Outback – new for 2010 (outback-2010)
  • Tribeca (tribeca-2006)
• Isuzu:
  
  
  
  • Single Cab (single-cab-2009)
  • Denver (denver-2009)
  • Denver Max (denver-max-2009)
  • Denver Max LE (denver-max-le-2009)
  • Rodeo LE Sport (rodeo-le-sport-2009)

Accessing the Data

The URL structure differs depending upon what information you want, but the simplest request would be:

http://your_token.imwww.co.uk/cars/model/model_ident.xml

NOTE: All models have their model_ident listed next to them inside ().

Listing all Models

In certain situations you might want to return data on all vehicles; simply use this:

http://your_token.imwww.co.uk/cars/all.xml

Listing Models by Brand

You can fetch all models of a particular brand by simply asking for them in your query. To fetch only Subaru models you would do something like this:

http://your_token.imwww.co.uk/cars/brand/brand_ident.xml

Currently the supported brands are:

• Subaru (subaru)
• Isuzu (isuzu)

NOTE: As with models brands have a unique identifier (brand_ident); this is inside the () next to their name in the list above.

Returned Data

The data that is returned for each vehicle contains the following information:

• id – unique numerical model_ident
• last_updated – last time the model was updated (YYYY/mm/dd H:i:s)
• name – the english name
• url – the model_ident
• brand – the numeric identifier for the brand
• status – the numeric identifier for the vehicles status (1 is available, 0 not available)
• price_from – the starting price of this model range in £ GBP
• price_to – the highest price of this model range in £ GBP
• year_start – year this model started
• year_end – year this model ended (blank if still in production)
• introduction – simple introduction copy about the model range
• overview – more detailed copy about the model range
• order_by – the advised position of this model (eg 0 would be first, 100 being last)
• similar – the id of a vehicle that is similar to this one (eg Impreza is similar to WRX STi)
• files – list of all files for this model (used for galleries, brochure downloads etc), these are categorised by a category field
• variations – list of all variations for this model – so 1.5 R, 2.0D etc for an Impreza
• accessories – list of all accessories available for that model (we are working to improve this data, it is rough and ready at the moment)
• colours – list of all colours available for that model

NOTE: the resize_url property of a file is present on images; it takes a number for the last part of the URL. This number is the largest dimensions maximum value so if your image is long and thin then it will be the width; if it’s tall and narrow then it will be the height.

Minimal Data

A standard query to the car API (like the one above) returns quite a large amount of data (including all model variations, files and images); if you only want the basic data about each model you can add the minimal parameter into your query:

http://your_token.imwww.co.uk/cars/all/minimal.xml

The data returned by a minimal for each model is:

• name – the english name
• last_updated – last time the model was updated (YYYY/mm/dd H:i:s)
• url – the model_ident
• brand – the numeric identifier for the brand
• status – the numeric identifier for the vehicles status (1 is available, 0 not available)
• price_from – the starting price of this model range in £ GBP
• price_to – the highest price of this model range in £ GBP
• introduction – simple introduction copy about the model range
• overview – more detailed copy about the model range
• similar – the id of a vehicle that is similar to this one (eg Impreza is similar to WRX STi)
• order_by – the advised position of this model (eg 0 would be first, 100 being last)

Comparing Models

If you want to fetch data about specific models (say to compare model_a to model_b) you can do this in a single call:

http://your_token.imwww.co.uk/cars/model/model_a/model_b.xml

To reduce the amount of data being transferred you can pass along the minimal parameter.