The GetResearchResults API call is used to retrieve basic pre-calculated statistics for a specific set of keywords, along with other filters. Version 2 of this call added new functionality and filters including the ability to sort the returned items.

The following is a complete list of major schema changes between Version 1 and Version 2 of the GetResearchResults call:

• Added Item Sorting Filters, which allow users to sort the returned Items.
• Added additional statistics to Duration and ListingTypes returned fields.
• Added additional statistics to Category results returned.
• Renamed Sellers field to AverageSellersPerDay.
• Moved Pricing Filters from root input node to their own Pricing node.
• Added option to search International Sites, and return results in any Currency.

See Also: GetResearchResults Version 1 Documentation

The GetResearchResults call can take in the following input:

• Keywords
• Date Ranges
• Category Limits
• Price Ranges
• Item Sorting Filters
• Site ID
• Currency
• Listing Promotion Filters
• Listing Type Filters
• Hour of Day Filters

This call has REST Support.

See Also: GetResearchResults Input Schema, GetResearchResults Input Field Reference, GetResearchResults REST Reference

The GetResearchResults call returns the following metrics:

• Total Revenue, Listings, Sucessful Listings, Bids
• Total Items Offered & Sold
• Average Sellers Per Day
• Average, Highest, Lowest and Frequent End Price
• Average, Highest, Lowest and Frequent Start Price
• Revenue, Listings, and Items Sold on a Per-Hour Basis
• Number of Listings Grouped by Listing Promotion usage
• Revenue, Listings, Items, and Bids Grouped by Listing Duration
• Revenue, Listings, and Items Grouped by Listing Type usage
• Price Buckets for Successful Listings
• Revenue, Listings, Bids, Items, and Sellers on a Daily Basis
• Revenue, Listings, items and Bids for Popular Keywords
• Top Categories
• Up to 200 Sorted Sample Items

See Also: GetResearchResults Output Schema, GetResearchResults Output Field Reference