Skip to main content

The Analytics API provides tools to help sellers analyze their selling performance and identify ways to maintain or improve their seller ratings.

The API is divided into the following tools:

  • Customer service metric – Returns benchmark data, seller data, and seller ratings for Item Not As Described and Item Not Received customer service metrics.
  • Traffic Report – Returns details on the buyer traffic received by a seller's item listings.
  • Seller Standards Profile – Returns the Seller Rating for a seller and the metric data on which the rating is based.

Making use of the Analytics API tools

By strategically using Analytics API tool set, sellers can analyze and determine courses of actions for:

  • Business trends year over year
  • Buyer engagement with seller listings
  • Performance in the Seller Standards program
  • Performance of their customer service efforts

Customer service metric ratings

Sellers can get their customer service ratings for two customer service metrics:

  • ITEM_NOT_AS_DESCRIBED
  • ITEM_NOT_RECEIVED

See Interpreting customer service metric ratings for details on how to retrieve benchmark data and interpret the seller rating results.

Buyer traffic on seller listings

Sellers can run traffic reports at both the beginning and the end of their selling cycles to get a view on listing performance over time.

As described in Traffic report details, traffic reports offer insights that sellers can use to evaluate existing and upcoming sales events.

By running the reports on a periodic basis, seller can see the impacts of any adjustments they've made. For example, you might determine that you can change your listing titles to increase your listing-page views, and you can use the Traffic Report to monitor the result.

Seller profile ratings

Call findSellerStandardsProfile to review a seller's eBay seller rating and the metrics eBay used to establish the rating. Sellers can use this information to help maintain and improve their eBay seller rating and sales effectiveness.

For example, you might find that the Transaction Defect Rate is higher than you expect. To address this, you might decide to better describe your items to lessen your Significantly Not As Described (SNAD) returns.

See Seller standards profile for more details on how to reprieve and interpret standards profiles.

Analytics API Requirements and Restrictions

Each resource, and its associated methods, are supported in distinct marketplaces, as outlined in the following sections: 

customer_service_metric

The customer_service_metric resource has a single method, getCustomerServiceMetric, which is supported by the following eBay marketplaces:

  • Australia (EBAY_AU)
  • Canada (EBAY_CA)
  • France (EBAY_FR)
  • Germany (EBAY_DE)
  • Great Britain (EBAY_GB)
  • Italy (EBAY_IT)
  • Spain (EBAY_ES)
  • United States (EBAY_US)

For more information, see the Service metrics section of the Service metrics policy page.

traffic_report

The traffic_report resource has a single method, getTrafficReport, which is supported by the following eBay marketplaces:

  • Australia (EBAY_AU)
  • France(EBAY_FR)
  • Germany (EBAY_DE)
  • Great Britain (EBAY_GB)
  • Italy(EBAY_IT)
  • Spain(EBAY_ES)
  • United States (EBAY_US)

Use this method for up to a few thousand listings per day; it is not intended to return daily metrics for all your listings. We hope to increase this rate limit In the future.

seller_standard_profile

The methods in the seller_standard_profile resource are supported by the same marketplaces that provide support for the customer_service_metric resource.

Be aware that some fields returned by the methods in the seller_standar_profile resource may be subject to change. This includes future possible updates to the structure of the program, metrics, cycle, and threshold response fields, so please code your applications to gracefully handle any such changes.

Seller-related calls in the Trading API

In addition to the Analytics API, sellers can also use several methods in the Trading API to assess seller status:

  • GetSellerDashboard provides the overall seller-level rating, but not the sub-metrics returned Seller Standards Profile Report, which shows how those metrics contribute to your overall seller level.
  • GetItem provides page-view information, but the values may include visits from bots and the data is limited for only the last 90 days.
  • GetSellerTransactions provides the number of transactions for a seller, but data is limited to only the items sold in the last 90 days.