Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

Common ItemSearch Parameters

After you decide on a search index value and check Locale Reference for the Product Advertising API to determine what ItemSearch input parameters are valid for that search index, you should set values for as many valid parameters as you can to increase the accuracy of the search results.

The most commonly used input parameters are the ones that can be used with the most search indices, including:

Availability

Specifies that the item must be available for purchase. The only valid value for the parameter is "Available".

BrowseNode

Enables you to search a specified browse node for associated items

Condition

Enables you to specify the condition of an item. Valid values are "All", "New", "Used", "Collectible", and "Refurbished". The default is "New". Condition does not restrict the total number of items returned. It does, however, restrict the offers returned to those items that are in the specified condition.

Keywords

A word or phrase (words separated by percent-encoded spaces, %20) used as a search criteria. The titles and descriptions of items are searched for keywords.

MaximumPrice

The maximum price that an item can cost.

MinimumPrice

The minimum price that an item can cost.

Title

A word or phrase (words separated by percent-encoded spaces, %20) used as a search criteria. The titles of items are searched for these words.

The definitions for all ItemSearch parameters are in the API Reference. The following sections describe in greater detail some of the commonly-used parameters.