Tasks

•   keywords

  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.

  property
•   storeName

  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.

  property
•   itemFilter

  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.

  property
•   outputSelector

  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.

  property
•   aspectFilter

  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.
  
  
  
  
  Note: If a call that specifies an
  outputSelector value of
  AspectHistogram returns
  aspectHistogramContainer.domainName, this is a sign
  that aspect histogram data might not be returned if you also specify an
  aspectFilter in the next call. To ensure that
  aspect histogram data is returned for the next call, add a
  domainFilter to the call as well.
  

  property
•   domainFilter

  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.

  property
•   categoryId

  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 Shopping API <b
  class=“con”>GetCategoryInfo 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.

  property