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: June 3, 2024

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 versions
  • API options
  • 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 .Trends API lets you pull raw data from the .Trends tools.

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

Semrush offers the following API options:

  • Standard API
  • .Trends API
  • Listing Management API

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

Standard API

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

This API is available as an add-on to a Business subscription. Additionally, to make API calls, you need API units that are purchased separately. To learn more, refer to Standard API.

The Analytics API lets you pull data from Domain, Keyword, and Backlink analytics tools, such as:

  • Domain Overview
  • Organic Research
  • Keyword Gap
  • Advertising Research
  • PLA Research
  • Ads history
  • Keyword Overview
  • Keyword Magic Tool
  • Backlink Analytics
  • Backlink Gap

The Projects API lets you manage your Semrush projects and set up and pull data from your Position Tracking and Site Audit campaigns.

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

.Trends API

The .Trends API (version 3) offers two subscription plans tailored to different needs:

  • .Trends Basic API offers access to broad traffic summaries that include website traffic metrics and user behavior data ideal for marketers focused on analyzing competitor web traffic, benchmarking traffic statistics, and understanding user behavior on competitor domains.
  • .Trends Premium API offers everything included in the .Trends Basic API, along with 16 additional data types that allow you to dig deeper into market dynamics, competitor strategies, and web traffic flows.

To learn more about .Trends Basic API and .Trends Premium API, refer to .Trends API subscription plans.

The monthly limit rate included by default is 10,000 requests. This API doesn't use Standard API units. To learn more, refer to .Trends API.

Listing Management API

The Listing Management API (version 4) lets you push data from your tools into Semrush Listing Management. Learn more about the Listing Management API ›

This API is available for all Semrush Local Premium plan users.

API usage restrictions

General restrictions

If you're making requests to any Semrush API method, you must comply with the following:

  • Rate limits: You can make up to 10 requests per second from one IP address.
  • Concurrency limits: You can make up to 10 simultaneous requests per user.
  • Caching timeline: You can't cache the information received via API for more than one month without Semrush's express written consent.

For more details, refer to Semrush Terms of Service, section 3.3.

Note that this article lists some additional restrictions for specific Semrush API methods.

.Trends API

.Trends API has additional restrictions on the number of requests per month, depending on the .Trends API subscription plan you have.

If your monthly limit is 10,000 requests, this is also your daily and hourly limit. This means you can use your monthly limit within 1 hour if needed.

If your monthly limit is over 20,000 requests, your daily and hourly limit is 20,000.

Note that you can make up to 10 requests per second per user.

Learn more about .Trends API ›

Listing Management API

Listing Management API methods have their own restrictions:

Learn more about Listing Management API ›