Method: FindItems

Description

Finds items based on the given search criteria.

Action

Style

Document

Input (Literal)

The input of this method is the document element ns:FindItemsRequest of type having the structure defined by the following table.

Element	Type	Occurs	Description
		1..1
ns:MessageID	xs:string	0..1	If you pass a value in MessageID in a request, we'll return the same value in CorrelationID in the response.
any		0..*
ns:QueryKeywords	xs:string	0..1	A query that specifies a string for searching titles of items on eBay.
ns:ItemSort	ns:SimpleItemSortCodeType	0..1	Sorts search results based on the value you specify.
ns:SortOrder	ns:SortOrderCodeType	0..1	Sorts search results in ascending or descending order, in conjunction with the value you specify in ItemSort.
ns:MaxEntries	xs:int	0..1	Specifies the maximum number of entries to return in a single call.
ns:PostalCode	xs:string	0..1	Specifies the postal code where the buyer is located.
ns:SellerID	xs:string	0..*	The ID of a specific seller.
ns:SellerIDExclude	xs: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.
ns:HideDuplicateItems	xs:boolean	0..1	Specifies whether or not to remove duplicate items from search results.

Output (Literal)

The output of this method is the document element ns:FindItemsResponse of type having the structure defined by the following table.

Element	Type	Occurs	Description
		1..1
ns:Timestamp	xs:dateTime	0..1	This value represents the date and time when eBay processed the request.
ns:Ack	ns:AckCodeType	0..1	Indicates whether the call was successfully processed by eBay.
ns:Errors	ns:ErrorType	0..*	A list of application-level errors or warnings (if any) that were raised when eBay processed the request.
ns:Build	xs:string	0..1	This refers to the particular software build that eBay used when processing the request and generating the response.
ns:Version	xs:string	0..1	The release version that eBay used to process the request.
ns:CorrelationID	xs:string	0..1	If you pass a value in MessageID in a request, we will return the same value in CorrelationID in the response.
any		0..*
ns:Item	ns:SimpleItemType	0..*	Contains summary data for an item listing.
ns:TotalItems	xs:int	0..1	Indicates the total number of items on eBay that match the query.
ns:ItemSearchURL	xs:anyURI	0..1	A URL equivalent to your FindItems search query.
ns:DuplicateItems	xs:boolean	0..1	Indicates whether there are duplicated items not returned by this response when HideDuplicateItems is true in the request.

---