GetMostWatchedItemsRequest
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 result set. The top 20 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.

Note: The getMostWatchedItems call does not work properly for EBAY-FRCA (eBay Canada, French). Refer to the getMostWatchedItems returns no results for IN, CAFR, CA thread in the eBay Shopping and Merchandising API Production System Announcements board for more information, including an ETA for when this problem will be resolved.

Fields
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.

This document was generated with a customized version of the apireferencedocs tool.

© 2008–2009 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.