contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

10:00 AM - 5:00 PM (EST/EDT)

Monday - Friday

mobile-menu

Introduction

Basic docs divider Last updated: September 16, 2021

Intro

Application Programming Interface (API) is a method of extracting raw Semrush data without having to manually log into the software.

Once you get your API key, you can start integrating with Semrush API.

Below you will find information about

  • API versioning&changelog
  • API packages
  • List of available product APIs
  • Useful links about API

API versions

Two Semrush API versions are available: version 3 and version 4.

The main difference between versions is the authorization method, availability of major changes inside the feature APIs, and list of available feature reports.

Each version consists of product groups, products themselves, and product reports.

What is a Semrush product?

A Semrush product is a set of tools that solves particular user problems. Once you log in to semrush.com, you can access the complete list of Semrush products from the left menu.

chevron API version 3

This is an older and more comprehensive API version. Its peculiar properties:

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

Version 3 is practically unchangeable and consists of three product groups:

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

Each product group includes plenty of products. For a detailed list, refer to the API documentation.

chevron API version 4

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

Its peculiar properties:

  • Supports authorization with the OAuth 2.0 flow.
  • No API key.
  • Backward compatibility.
  • A unified authentication and response format for all products.
  • No product grouping.

Version 4 consists of:

  • The Projects API.
  • The Listing Management API (available for all Semrush Local Premium Plan users).

API options

An API option is a set of available reports that you will receive by fulfilling the conditions.

Semrush offers two API options:

  • Standard API
  • Traffic Analytics API

To learn how to start using the API, refer to How to get API.

Standard API

Standard API consists of the Analytics and Projects APIs (version 3 and version 4).

This API is available as an add-on to a Business subscription. When you add the API to your subscription, you will have a limited number of API units that you can use to make calls. To learn more, refer to Standard API package.

The Analytics API lets you pull data from Analytics reports, including:

  • Domain Analytics
  • Organic Research
  • Advertising Research
  • Keyword Gap Analysis
  • Keyword Analytics
  • Backlink Analytics

The Projects API can pull data from the Position Tracking and Site Audit campaigns created in Projects.

While using Standard API, your API key will be placed on your Subscription Info page.

Traffic Analytics API

Semrush Traffic Analytics API comes in two subscription plans based on the level of data supplied:

  • Basic: provides only traffic summary data.
  • Extended: provides traffic summary data + eight distinct reports.
The monthly limit rate included by default is 10,000 requests. This API doesn't use Standard API units. To learn more, refer to Traffic Analytics API package.
chevron Basic level

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.

chevron Extended level

Extended level offers 16 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).
  • Subfolders: the top subfolders of an analyzed domain getting the most traffic.
  • Age and Sex Distribution: distribution of the domain audience by age and sex.
  • Household Distribution: distribution of the domain audience by household.
  • Income Distribution: distribution of the domain audience by income.
  • Education Distribution: distribution of the domain audience by education.
  • Occupation Distribution: distribution of the domain audience by occupation.
  • Audience Interests: distribution of the domain audience by interest.
  • Social Media: distribution of the domain audience by social media.

This data will show you more in-depth details of a website’s traffic coming from all angles.