Class FindPopularItemsRequestType

class FindPopularItemsRequestType

Find popular items Summary: Searches for popular items based on a category or keyword. Returns WatchCount in addition to item information. RelatedCalls: FindPopularSearches

Defined in com/ebay/shoppingservice/FindPopularItemsRequestType.js

Property Summary

Array categoryID

Specify CategoryID to restrict your query to a specific category.

Array categoryIDExclude

Specify this value if you want search results to be filtered so that the popular items returned do not include items that belong to a specific category.

Number maxEntries

Specifies the maximum number of entries to return in a single call.

String queryKeywords

A query that specifies a string for searching titles of items on eBay.

Properties inherited from AbstractRequestType

messageID

Constructor Summary

FindPopularItemsRequestType(Object props)

Property Details

property Array categoryID

Specify CategoryID to restrict your query to a specific category. Up to 10 categories may be specified. If you are using a URL, and you want to specify more than one CategoryID, separate the values with a comma. For example, to specify Fiction Books and Children's Books, specify CategoryID=377,279.

If the specified category ID doesn't match an existing category for the site, an invalid-category error message is returned. To determine valid categories:
Use the FindItemsAdvanced CategoryHistogram value in the IncludeSelector field to retrieve matching categories. Then make another FindItemsAdvanced call with the ID of a matching category.

CategoryID can be used in combination with QueryKeywords and CategoryIDExclude. To retrieve the most popular items across all categorys, do not submit a CategoryID.

property Array categoryIDExclude

Specify this value if you want search results to be filtered so that the popular items returned do not include items that belong to a specific category.

CategoryIDExclude is an unbounded field. If you are using a URL, you can separate multiple values with a comma. For example, if you want to specify Records and SuperAudio CDs, specify CategoryIDExclude=306,46354.

If you use CategoryIDExclude, it must be used in with QueryKeywords or CategoryID. The CategoryIDExclude input field need not be used if you specified the CategoryID input field.

property Number maxEntries

Specifies the maximum number of entries to return in a single call.

property String queryKeywords

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. QueryKeywords can be used in combination with CategoryID and CategoryIDExclude.

Constructor Details

constructor FindPopularItemsRequestType

FindPopularItemsRequestType(Object props)

Parameters:

props