Introduction

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 provides APIs for several Semrush toolkits:

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

• Available data
• API versions
• API options
• API response formats
• API usage restrictions

Data coverage

Semrush API provides access to a wide range of data, including:

• Organic search: Keyword rankings, traffic estimates, SERP features (including AI-powered ones such as AI Overview), and historical trends.
• Paid search: Ad keywords, ad copies, CPC, and competition data.
• Backlinks: Referring domains, anchor texts, link types, and historical backlink trends.
• Domain analytics: Website traffic and market data, competitor analysis, and keyword gaps.

Country and region coverage

• Global reach: Semrush covers over 140 countries and regions for organic and paid search data.
• Local databases: To retrieve region-level insights, you can specify the database (for example, us, uk, de, fr, etc.) in your API requests.
• Granularity: Certain API methods offer city-level and device-specific tracking, enhancing precision for local SEO and campaign analysis.

Historical data

Semrush offers rich historical data, with SEO data dating back to 2012 and Traffic & Market data from 2017. It supports monthly and daily granularity, enabling in-depth trend analysis and performance benchmarking over time.

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.

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

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 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.

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. It's ideal for marketers who need to check and analyze competitor web traffic, benchmark traffic statistics, and understand user activity across domains.
• Trends Premium API offers everything included in the Trends Basic API, along with 16 additional data types. With this traffic data, you can 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.

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.

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.

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 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 methods have their own restrictions:

• UpdateLocation: You can make up to 5 requests per second per user.
• UpdateLocations: You can make up to 5 requests per minute per user and update up to 50 locations at a time.
• GetLocation and GetLocations: You can make up to 10 requests per second per user.

Learn more about Listing Management API ›