Description
Finds product listings on Half.com.
Input
The input of this method is the document element ns:FindHalfProductsRequest of type having the structure defined by the following table.
| Element |
Type |
Description |
| ns:MessageID |
xs:string |
If you pass a value in MessageID in a request, we'll return the same value in CorrelationID in the response.
|
| any |
|
|
| ns:IncludeSelector |
xs:string |
Defines standard subsets of fields to return within the response.
|
| ns:AvailableItemsOnly |
xs:boolean |
If true, only retrieve data for products that have been used to pre-fill active listings on the Half.com site. If false, retrieve all products that match the query.
|
| ns:DomainName |
xs:string |
A domain to search in.
|
| ns:ProductID |
ns:ProductIDType |
Use this to retrieve product details for one specific product. Specify the ID as a string, and use the type attribute to indicate the nature of the ID you are specifying.
|
| ns:QueryKeywords |
xs:string |
One or more keywords to search for.
|
| ns:SellerID |
xs:string |
The ID of a specific seller.
|
| ns:ProductSort |
ns:ProductSortCodeType |
Sorts the list of products returned.
|
| ns:SortOrder |
ns:SortOrderCodeType |
Sorts the list of products returned.
|
| ns:MaxEntries |
xs:int |
Specifies the maximum number of products to return per page in a single call.
|
| ns:PageNumber |
xs:int |
Specifies which page of data to return in the current call.
|
Output
The output of this method is the document element ns:FindHalfProductsResponse of type having the structure defined by the following table.
| Element |
Type |
Description |
| ns:Timestamp |
xs:dateTime |
This value represents the date and time when eBay processed the request.
|
| ns:Ack |
ns:AckCodeType |
Indicates whether the call was successfully processed by eBay.
|
| ns:Errors |
ns:ErrorType |
A list of application-level errors or warnings (if any) that were raised when eBay processed the request.
|
| ns:Build |
xs:string |
This refers to the particular software build that eBay used when processing the request and generating the response.
|
| ns:Version |
xs:string |
The release version that eBay used to process the request.
|
| ns:CorrelationID |
xs:string |
If you pass a value in MessageID in a request, we will return the same value in CorrelationID in the response.
|
| any |
|
|
| ns:DomainHistogram |
ns:DomainHistogramType |
A histogram that lists the number of matching products found and the domains in which they were found.
|
| ns:PageNumber |
xs:int |
The number of the page of data returned.
|
| ns:ApproximatePages |
xs:int |
The total number of pages that can be returned, given the same query and filters in the request.
|
| ns:MoreResults |
xs:boolean |
If true, more pages of results are available. That is, PageNumber is less than ApproximatePages.
|
| ns:TotalProducts |
xs:int |
The total number of matching products found. (If more than 2000 products are found, the call fails with an error.)
|
| ns:Products |
ns:HalfProductsType |
An set of Half.com catalog products.
|
| ns:ProductSearchURL |
xs:anyURI |
A URL for product search results that corresponds to your search request.
|