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.

Only active items are returned. Auction items are returned only when they have one or more bids.

Call that uses GetMostWatchedItemsRequest:

getMostWatchedItems

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.