Introduction

This is an older and more comprehensive API version. It`s peculiar properties:

• Authorization via API key
• No major changes — methods, fields, errors and etc. can only be added and not deleted
• No changelog
• Amount of feature reports exceeds the version 4 (but only for now). In the closer future version 4 will become the main version and more expanded.

Version 3 practically unchangeable and consists of three product groups:

• Analytics API - allows you to pull data from products with analytics reports
• Projects API - can pull data from Position Tracking and Site Audit campaigns created in Projects
• Traffic Analytics API - allows you to pull raw data from the Traffic Analytics tool in Semrush

Each product group includes plenty of products, you can find detailed list in API documentation.

This is the latest API version which we will expand and develop.

It`s peculiar properties:

• Supports authorization with the Oauth2 flow
• No API key
• Backward compatibility
• General for all products Authentication and Response format
• Without product grouping

Version 4 consists of :

• Basic docs common for all products
• Products with list of reports

Traffic Overview data will be able to show you estimates of a website's visitor behavior. These include monthly visits, unique visits, pages per visit, average visit duration, mobile vs. desktop traffic %, and bounce rate.

In the same way, the Traffic Analytics Overview report can compare up to 5 domains at a time, you can pull this data for up to 200 domains in a single request using the Summary reports. This data gives you a quick look into the general level of interaction between a website and its visitors.

The extended API offers 8 distinct reports in addition to the Traffic Overview from the Basic API:

• Traffic Sources: the website traffic broken down into direct, referral, search, social, and paid traffic;
• Traffic Destinations: where users are going after visiting the domain you are looking at;
• Geographic Distribution: the countries, regions, or subcontinents where a website gets most of its visitors;
• Subdomains: the subdomains of the website that are responsible for acquiring the most traffic;
• Top Pages: the number of unique page views, unique visitors, entrances, and traffic sources for up to a site’s top 1000 pages based on traffic;
• Domain Rankings: top websites in the target location for the target period sorted by traffic;
• Audience Insights: additional visited domains, unique audience, shared audience %, and shared audience for the domains you entered;
• Data Accuracy: the estimated accuracy of the report based on the size of the domain and any filters you have applied (historical data, location, device).
• This data will show you more in-depth details of a website’s traffic for a more comprehensive study of a domain’s traffic coming from all angles.

You’ll be able to analyze traffic by source (search, social, paid, referral, and direct) and geographic location - including the top social network sites and search engines sending traffic to a site. This will tell you where a domain’s predominant market comes from online.

Subdomains will give insight into how a domain structures its website to attract visitors, and traffic destinations will show you what sites these people visit most often directly after the queried site.