FindItemsRequestType
Searches for items based on a query or seller ID. If you use keywords, this call returns items that contain the keywords in the title. A maximum of 50 items is returned.

If you are not using the BestMatch search option, the API search results may not match the search results returned by the eBay website.
Fields
HideDuplicateItems ( boolean )
ItemSort ( SimpleItemSortCodeType )
MaxEntries ( int )
PostalCode ( string )
QueryKeywords ( string )
SellerID ( string )
SellerIDExclude ( string )
SortOrder ( SortOrderCodeType )

HideDuplicateItems ( boolean ) [0..1]
Specifies whether or not to remove duplicate items from search results. When set to true, and there are duplicate items for an item in the search results, the subsequent duplicates will not appear in the results. Item listings are considered duplicates in the following conditions:
  • Items are listed by the same seller
  • Items have exactly the same item title
  • Items have similar listing formats
    • Auctions: Auction Items, Auction BIN items, Multi-Quantity Auctions, and Multi-Quantity Auctions BIN items
    • Fixed Price: Fixed Price, Multi-quantity Fixed Price, Fixed Price with Best Offer, and Store Inventory Format items
    • Classified Ads

For Auctions, items must also have the same price and number of bids to be considered duplicates.
Filtering of duplicate item listings is not supported on all sites.
See the Field Index to learn which calls use HideDuplicateItems.

ItemSort ( see SimpleItemSortCodeType for possible values ) [0..1]
Sorts search results based on the value you specify. See the SortOrder field for values that specify whether results are returned in ascending or descending order. (By default, results are returned in descending order.)
See the Field Index to learn which calls use ItemSort.

MaxEntries ( int ) [0..1]
Specifies the maximum number of entries to return in a single call. If the number of entries that can be returned is less than the value you specify, the lower number is returned.
See the Field Index to learn which calls use MaxEntries.

PostalCode ( string ) [0..1]
Specifies the postal code where the buyer is located.
See the Field Index to learn which calls use PostalCode.

QueryKeywords ( string ) [0..1]
A query that specifies a string for searching titles of items on eBay. If you are using a URL, then to search for multiple words, use "%20". For example, use Harry%20Potter to search for items containing those words in any order. You can incorporate wildcards into a multi-word search, as in the following: ap*%20ip*. The words "and" and "or" are treated like any other word. Only use "and", "or", or "the" if you are searching for listings containing these words. FindItems requires that you specify either QueryKeywords, SellerID, or both.
See the Field Index to learn which calls use QueryKeywords.

SellerID ( string ) [0..*]
The ID of a specific seller. Specify this value if you want search results to be filtered so that the items returned are only items sold by a specific seller or by specific sellers. SellerID is an unbounded field. If you are using a URL, and you want to specify multiple values, use a comma. For example, to specify FavSellerBlue and FavSellerGreen, specify SellerID=FavSellerBlue,FavSellerGreen. The value you specify in SellerID is ignored if it is invalid. You can specify a maximum of 100 sellers.
See the Field Index to learn which calls use SellerID.

SellerIDExclude ( string ) [0..*]
Specify this value if you want search results to be filtered so that the items returned do not include items sold by a specific seller or by specific sellers. The SellerIDExclude input field need not be used if you specified the SellerID input field. SellerIDExclude is an unbounded field. If you are using a URL, and you want to specify multiple values, use a comma. For example, if you want to specify FavSellerBlue and FavSellerGreen, specify SellerIDExclude=FavSellerBlue,FavSellerGreen. You can specify a maximum of 100 sellers.
See the Field Index to learn which calls use SellerIDExclude.

SortOrder ( see SortOrderCodeType for possible values ) [0..1]
Sorts search results in ascending or descending order, in conjunction with the value you specify in ItemSort. The default is descending order. For example, in the case of the (default) ItemSort value of BestMatch, the most relevant items are returned first, because the default SortOrder value is Descending. If you specify an ItemSort value of EndTime (to sort items by end time), and a SortOrder value of Ascending, then items ending in less time (from the time of the call) are returned before items ending in more time.
See the Field Index to learn which calls use SortOrder.

This document was generated with a customized version of the apireferencedocs tool.

© 2006–2009 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.