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: May 12, 2025

Intro

What's API?

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

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

Semrush APIs

Semrush provides APIs for several Semrush toolkits:

Toolkit API API version
SEO Analytics API v3
Projects API v3, v4
Traffic & Market Trends API v3
Local Listing Management API v4
Map Rank Tracker API v4
Show all

Before you start the integration process, review the following information:

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 tools 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 SEO Toolkit products with analytics reports.
  • The Projects API lets you pull data from the Position Tracking and Site Audit campaigns created in SEO Projects and manage your projects.
  • The Trends API lets you pull raw data from the Traffic & Market Toolkit.

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:

API response formats

Semrush APIs return data in different formats depending on their version and purpose.

API version Endpoint type Data format
v3 Trends API, Analytics API CSV
v3 Projects API JSON
v4 All methods JSON

API options

Semrush offers the following API options:

  • Standard API
  • Trends API
  • Listing Management API
  • Map Rank Tracker 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 Pro and Business plan users.

Map Rank Tracker API

The Map Rank Tracker API (version 4) lets you access critical data related to your campaigns, keywords, and competitors. Learn more about Map Rank Tracker API ›

This API is available for all Semrush users. You don't need to purchase API units or have a special subscription to access it.

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 ›