VehicleSearch

Description

VehicleSearch returns all vehicles that match the specified values for year, make, model, and trim. The request can have one or more of those parameters—the more parameters, the narrower the results. Typically, VehicleSearch requests are repeated, first with the year to get the make, then with the year and make to get the model, and then with the year, make, and model, to get the trim.

The operation can also return all of the vehicle's options, including BedId, BedName, BodyStyleId, BodyStyleName, BrakesId, BrakesName, DriveTypeId, DriveTypeName, EngineId, EngineName, MakeId, and MakeName. (The full list of options follows.) All of these parameters can be used in subsequent requests with the other vehicle operations to narrow results.

Availability

US locale.

Request Parameters

Name	Description	Required
`MakeId`	Identifier that uniquely identifies the make of the car. The make is the car's manufacturer, such as Ford or General Motors. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: With `Year` to get model	Constraint
`ModelId`	Identifier that uniquely identifies the model of the car. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: With `Year` and `MakeId` to get trim	Constraint
`TrimId`	Identifier that uniquely identifies the trim on the car. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: Required when using the VehicleOptions response group	Constraint
`Year`	The year of the car the part works in. Type: String Default: None Valid Values: A four digit year, which is returned by `VehicleSearch` Constraint: Required only if including `MakeId` in request or if you are using `VehicleSearch` to look up a `MakeId`.	Constraint
`ResponseGroup`	Specifies the types of values to return. You can specify multiple response groups in one request by separating them with commas. Type: String Default: VehicleYears Valid Values: VehicleYears \| VehicleMakes \| VehicleModels \| VehicleTrims \| VehicleOptions	No

VehicleSearch also accepts the parameters that all operations can use. For more information, see, Common Request Parameters

Examples

Search for all car makes for the year 2001.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]&
Operation=VehicleSearch
Version=2008-08-19&
Year=2001&
ResponseGroup=VehicleMakes
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

The response to this request is shown in, Response to Sample Request.

Sample Response

The following XML is a snippet of the full response to the first sample request.

<VehicleSearchResponse>
  	<VehicleMakes>
    	<VehicleMake>
      <MakeName>AM General</MakeName>
      <MakeId>44</MakeId>
    </VehicleMake>
    	<VehicleMake>
      <MakeName>Acura</MakeName>
      <MakeId>58</MakeId>
    </VehicleMake>
    	<VehicleMake>
      <MakeName>Aston Martin</MakeName>
      <MakeId>77</MakeId>
    </VehicleMake>
    ...
  </VehicleMakes>
</VehicleSearchResponse>