GetSearchResults  

Searches for item listings based on user-defined criteria. It is recommended that you consider using FindItemsAdvanced (in the Shopping API) instead of GetSearchResults because FindItemsAdvanced is easier to use and faster. See the following location for information about the Shopping API:

 Shopping API

Use GetSearchResults to retrieve a list of items matching a set of criteria defined by the application or the application's end user. The properties of the GetSearchResults request object represent a set of criteria used to filter the items returned, the effects of which are cumulative. That is, the more criteria specified, the more refined the search and the fewer matching items that will be included in the result set.

GetSearchResults returns the data for the search into an SearchResultItemArrayType object in the SearchResultItemArray property of the response object. After a call, the SearchResultItemArray property may contain zero, one, or multiple item listings—depending on how many matched the specified search criteria. The data for each item listing returned in SearchResultItemArray is contained in a SearchResultItemType object.

For more details on using GetSearchResults, see Searching for Items by Using a Query. This includes the effects of ending a listing early and more on when it is required to specify a reason for ending the listing.

GetSearchResults Input Fields

GetSearchResults Output Fields

GetSearchResults Details

GetSearchResults Best Practices

Testing GetSearchResults

GetSearchResults Samples

Related Calls

Change History

User-Contributed Notes