eBay Trading API
Call Reference Version 579

Can be returned if the request specifies that ExpandSearch is true. Provides additional search results when a small result set would have been returned with the original search. For example, on the US site (site ID 0), if a search would normally result in fewer than 10 items, and ExpandSearch is true, the search results are expanded to include (if matching the query) the AllCategoriesExpansionArray container for items, as well as other containers. The AllCategoriesExpansionArray container contains items available if category filters are removed.

Contains URLs and other information about relevant buying guides (if any), as well as the site's buying guide hub. Unavailable in the Sandbox environment. Buying guides are useful to buyers who do not have a specific product in mind. For example, a digital camera buying guide could help a buyer determine what kind of digital camera is right for them. Only returned for product finder searches (using SearchRequest.SearchAttributes) and for searches that retrieve matching categories along with item data (using Categories.CategoriesOnly=false).

Shows the distribution of items across each category. Consists of statistical information about categories that contain items that match the query, if any. Returns empty if no matches are found or when the Categories filter was not passed in the request. (For categories associated with specific items, see items returned in each search result.) You must use fields within the Categories input container if you want the CategoryArray response container to be returned.

Can be returned if the request specifies that ExpandSearch is true. Provides additional search results when a small result set would have been returned with the original search. For example, on the US site (site ID 0), if a search would normally result in fewer than 10 items, and ExpandSearch is true, the search results are expanded to include (if matching the query) the FilterRemovedExpansionArray container for items, as well as other containers. The FilterRemovedExpansionArray container contains items that would be returned if filters such as PriceRangeFilter are removed.

Indicates whether there are more items, not yet returned, that match the search criteria.

Can be returned if the request specifies that ExpandSearch is true. Provides additional search results when a small result set would have been returned with the original search. For example, on the US site (site ID 0), if a search would normally result in fewer than 10 items, and ExpandSearch is true, the search results are expanded to include (if matching the query) the InternationalExpansionArray container for items, as well as other containers. The InternationalExpansionArray container contains items available from international sellers.

Indicates the maximum number of items that can be returned in a SearchResultItemArray for any given call.

Indicates the page of data returned by the current call. For instance, for the first set of items can be returned, this field has a value of one.

Indicates the results of the pagination, including the total number of pages of data that can be returned and the total number of items that can be returned.

Container for keywords related to the original keywords in the request. Can be returned if the request specified more than zero in the MaxRelatedSearchKeywords field.

Contains the returned item listings, if any. The data for each listing is returned in an ItemType object.

Suggestion for a different spelling of the search term or terms, along with the number of matching items that would have been returned if the suggestions had been used. The suggestions are given in Text tags and the suggestion for the first word is given before the suggestion for subsequent words. Suggestions are based on correctly-spelled terms in items, so suggestions vary over time and depend on whether a word or word combination is in one or more items.

Contains items listed in the Store Inventory Format, if the request specifies that ExpandSearch is true.