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:

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

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

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 ›