eBay Finding APIVersion 1.13.0

FindItemsIneBayStoresRequest ( BaseFindingServiceRequest )

Use findItemsIneBayStores to find items listed in eBay stores. Specify storeName in the request to retrieve all listings within a single store. You can combine storeName with keywords to find specific items, or use keywords without storeName to search for items in all eBay stores.

Search results can be filtered by item details or aspects and sorted by a variety of criteria.

Call that uses FindItemsIneBayStoresRequest:


aspectFilter ( AspectFilter ) [0..*]
Aspect filters refine (limit) the number of items returned by a find request. Obtain input values for aspectFilter fields from an aspectHistogramContainer returned in the response of a previous query.

By issuing a series of find queries, you can continually refine the items returned in your responses. Do this by repeating a query using the aspect values returned in one response as the input values to your next query.

For example, the aspectHistogramContainer in a response on Men's Shoes could contain an aspect of Size, along with "aspect values" for the different sizes currently available in Men's Shoes. By populating aspectFilter fields with the values returned in an aspectHistogramContainer, you can refine the item results returned by your new query.
See the Field Index to learn which calls use aspectFilter.

categoryId ( string ) [0..*]
Specifies the category from which you want to retrieve item listings. This field can be repeated to include multiple categories.

If a specified category ID doesn't match an existing category for the site, eBay returns an invalid-category error message. To determine valid categories, use the Trading API GetCategories call.

Up to three (3) categories can be specified.

Category searches are not supported on the eBay Italy site (global ID EBAY-IT) at this time.
See the Field Index to learn which calls use categoryId.

domainFilter ( DomainFilter ) [0..*]
Restricts results to items listed within the specified domain. Domains are a buy-side grouping of items. such as shoes or digital cameras. A domain can span multiple eBay categories.
See the Field Index to learn which calls use domainFilter.

itemFilter ( ItemFilter ) [0..*]
Reduce the number of items returned by a find request using item filters. Use itemFilter to specify name/value pairs. You can include multiple item filters in a single request.
See the Field Index to learn which calls use itemFilter.

keywords ( string ) [0..1]
Specify one or more words to use in a search query for finding items on eBay. By default, queries search item titles only. When running queries, it is best to include complete keywords values--eBay checks words in context with each other. If you are using a URL request and your keyword query consists of multiple words, use "%20" to separate the words. For example, use "Harry%20Potter" to search for items containing those words in any order. Queries aren't case-sensitive, so it doesn't matter whether you use uppercase or lowercase letters.

You can incorporate wildcards in a multi-word search. For example, "ap*%20ip*" returns results for "apple ipod" among other matches. The words "and" and "or" are treated like any other word (and not their logical connotation). Only use "and", "or", or "the" if you are searching for listings containing those specific words.

You must specify keywords when you are searching across all eBay stores. That is, keywords is required if storeName is not specified in the request.
See the Field Index to learn which calls use keywords.

outputSelector ( OutputSelectorType ) [0..*]
Defines what data to return, in addition to the default set of data, in a response.

If you don't specify this field, eBay returns a default set of item fields. Use outputSelector to include more information in the response. The additional data is grouped into discrete nodes. You can specify multiple nodes by including this field multiple times, as needed, in the request.

If you specify this field, the additional fields returned can affect the call's response time (performance), including in the case with feedback data.
See the Field Index to learn which calls use outputSelector.

storeName ( string ) [0..1]
The name of the eBay store to search. Returns all items in the store, or can be used with keywords to search for specific items in an eBay store. If you do not specify keywords, you must specify storeName.

Note: Store names are case sensitive. Also, if the store name contains an ampersand (&), you must use the & character entity (& amp;) in its place. If you do not specify storeName in the request, the search is across all eBay stores. When searching across all stores, you must specify keywords.

The results can be filtered by item listing details or aspects.
See the Field Index to learn which calls use storeName.