VehiclePartSearch

Product Advertising API: 2009-11-01

previous page next page

VehiclePartSearch

Description

Given a car, VehiclePartSearch returns the parts that work in the car. For example, a 2008 GMC Yukon has a list of parts that can work in it. The more parameters that you supply in the request, the narrower your results.

VehicleSearch has additional, optional parameters to narrow the results, for example BrowseNodeId and Brand. For more information, see Filtering Out Vehicles.

You can page through the vehicles returned using the parameters, Count, PartPageDirection, and FromItemId. For more information, see Paging Through Parts.

Availability

US locale.

Request Parameters

Name	Description	Required
`BedId`	Identifier that uniquely identifies the bed style of a truck. This parameter does not pertain to cars. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`BodyStyleId`	Identifier that uniquely identifies the body style of the car. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`BrakesId`	Identifier that uniquely identifies the brake type on a car. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`Brand`	The brand of the company that made the part. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`BrowseNodeId`	Identifier that uniquely identifies the browsenode to which the part belongs. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`Count`	Controls the number of items returned. Use `Count` with `FitmentPage` to page through the results. Type: nonNegativeInteger Default: 10 Valid Values: 1 - 15 Constraint: None	No
`DriveTypeId`	Identifier that uniquely identifies the type of drive on the car. A drive type, for example, is four wheel drive. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`EngineId`	Identifier that uniquely identifies the type of engine in the car. An engine type would be, for example, the piston displacement, like 409 cu. inches. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`FromItemId`	An ASIN that identifies where to start or end the next page of returned results. If `PartPageDirection` is "Next," the ASIN after this one starts the next set of up to 15 returned results. If `PartPageDirection` is "Previous," the ASIN is one after the previous set of up to fifteen results returned. Type: nonNegativeInteger Default: None Valid Values: A valid `ItemId` Constraint: Required when using `PartPageDirection`	Constraint
`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: None	Yes
`MfrBodyCodeId`	Identifier that uniquely identifies the manufacturer's car body code. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`ModelId`	Identifier that uniquely identifies the model of the car. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	Yes
`PartPageDirection`	Specifies the direction, forward or backward, to go from `FromItemId` in presenting the next set of (up to) fifteen results. Type: String Default: Next Valid Values: Next, Previous Constraint: None	No
`SpringTypesId`	Identifier that uniquely identifies the type of spring shocks in the car. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`SteeringId`	Identifier that uniquely identifies the steering type of the car. A steering type would be power steering. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`TransmissionId`	Identifier that uniquely identifies the transmission type used in the car. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`TrimId`	Identifier that uniquely identifies the trim on the car. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: Required when using one of the following parameters: `BedId, BodyStyleId, BrakesId, DriveTypeId, EngineId, MfrBodyCodeId, SpringTypesId, SteeringId, TransmissionId, WheelbaseId`	Constraint
`WheelbaseId`	Identifier that uniquely identifies the car's wheelbase. Type: nonNegativeInteger Default: None Valid Values: A valid ID Constraint: None	No
`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: None	Yes
`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: VehicleParts Valid Values: PartBrowseNodeBinsSummary \| PartBrandBinsSummary \| HasPartCompatibility \| VehiclePartFit \| VehicleParts	No

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

Examples

Look up a vehicle part specified by MakeId, ModelId, Year, and BrowseNodeId.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]&
Operation=VehiclePartSearch
Marketplace=us&
MerchantId=All&
Year=2001&
MakeId=54&
ModelId=688&
ResponseGroup=PartBrowseNodeBinsSummary&
BrowseNodeId=15857511

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.

<VehiclePartSearchRequest>
  <VehicleParts>
    	<PartBrowseNodeBins>
      	<Bin>
      	  <BinName>Grilles & Grille Guards</BinName>
      	  <BinItemCount>8</BinItemCount>
      	  	<BinParameter>
      	    <Name>BrowseNodeId</Name>
      	    <Value>15735981</Value>
      	  </BinParameter>
      	</Bin>
      		<Bin>
      	  <BinName>Hood Scoops & Vents</BinName>
      	  <BinItemCount>2</BinItemCount>
      	  	<BinParameter>
      	    <Name>BrowseNodeId</Name>
      	    <Value>15736031</Value>
      	  </BinParameter>
      	</Bin>
      		<Bin>
      	  <BinName>Spoilers, Wings & Styling Kits</BinName>
      	  <BinItemCount>1</BinItemCount>
      	  	<BinParameter>
      	    <Name>BrowseNodeId</Name>
      	    <Value>15737061</Value>
      	  </BinParameter>
      	</Bin>
      		<Bin>
      	  <BinName>Towing Products & Winches</BinName>
      	  <BinItemCount>12</BinItemCount>
      	  	<BinParameter>
      	    <Name>BrowseNodeId</Name>
      	    <Value>15737251</Value>
      	  </BinParameter>
      	</Bin>
    </PartBrowseNodeBins>
  </VehicleParts>
</VehiclePartSearchResponse>

Related Operations

previous page start next page