analytics APIv1.0.0

The Analytics API

The Analytics API provides key information about an individual seller’s business performance.

For you to maintain your current business level or grow to new heights, understanding your business health is crucial. The Analytics API calls let you understand how buyers are engaging with your listings (get TrafficReport call) and if you are meeting your buyers’ expectations (getSellerStandardsProfile and findSellerStandardProfiles calls).

Some metrics support reporting changes over time and can have multiple years of available data to work with. This can let you understand seasonal changes in sales or other time based analysis. Refer to the Analytics API Reference for the supported time ranges for those metrics.

This overview covers the following Seller Analytics API topics:

Technical overview

The following are the Analytics API's main objects:

  • Traffic Report
    • dimensionKeys - the report's aggregation method, for example, days
    • metrics - the report's type of data, for example, total listing page views
    • records - the report's individual records, bucketed by dimensionKeys
  • Seller Standards Profile
    • program - marketplace region where a seller conducts business
    • cycle - current or projected evaluation cycle

Business use cases

The following are some of the Analytics API's high-level use cases:

Track buyer engagement with a seller's top listings

Some of your listings may generate the majority of your sales, by volume or profit. It's important to know if links to these listings aren't showing up on eBay as often as they had, or if buyers are starting to view or purchase those items less often.

Benchmark buyer behavior on your listings over the past 2 years

You can compare buyer behavior on your listings over the past 2 years. This could help you understand when particular items are more likely to sell, or let you know that interest in an item has declined steadily over time. For the latter, you might want to run a promotion to either try to revitalize sales or close out your inventory of the item.

Understand the impact of change on buyer engagement

Changes to listings can impact buyer engagement. For example, check if a marketing campaign on some listings successfully led to more people viewing or buying those items.

Correlate eBay standards performance to buyer engagement

Correlate your eBay standards performance to engagement with your listings. For example, if you recently earned Top Rated Seller status, buyers may view or purchase your items more often due to having more reason to think you'll provide excellent customer service.

Monitor your eBay standards performance

Sellers can monitor their performance and see what customer service areas to focus on to maintain or improve their evaluation. For example, you can focus on standards criteria in which you are not performing in the Top Rated Seller level.

Additional Information

More detailed reports on the various metrics can be found on the Seller Standards Dashboard. You may want to add these US program links to your dashboard.

Analytics API requirements and restrictions

The getTrafficReport call should only be used for up to a few thousand listings per day. It is not intended to return metrics every day for every listing on sites with more listings than that. We hope to increase this amount In the future. You can retrieve data for listings created on the US, UK, Germany, or Australia marketplaces.

For the findSellerStandardsProfiles and getSellerStandardsProfile calls, the programs, metrics, cycles, and thresholds are subject to change. Please code your applications to gracefully handle any such changes.