eBay Merchandising APIVersion 1.5.0
 

GetMostWatchedItemsRequest ( BaseMerchandisingServiceRequest )

Retrieves data for items with the highest watch counts for the entire site or for a specific category. The top 20 most watched items, if any, are returned unless maxResults is used to specify a smaller or larger result set. The top items are determined by the watch count totals from the preceding day. Ranking of the most watched items is calculated with the latest watch count information.

Note: Before January 2015, the response returned only auction items that had one or more bids. Now due to an eBay platform change, auction items with and without bids are returned.

Call that uses GetMostWatchedItemsRequest:

Field

categoryId ( string ) [0..1]
Specifies the category from which to retrieve item listings. This field takes the same category ID data as used with other eBay APIs.

Category IDs are site-specific. 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, you can use either the Shopping API or the Trading API. In the Shopping API, use the FindItemsAdvanced call with the CategoryHistogram value in the IncludeSelector field to retrieve matching category information. In the Trading API, use calls like GetCategories and GetCategoryFeatures to determine valid values for the site.
See the Field Index to learn which calls use categoryId.