contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

12:00 PM - 5:00 PM (EST/EDT)

Monday - Friday

mobile-menu

Introduction

Basic docs divider Last updated: July 23, 2025

Access SEO and traffic data via Semrush API

Semrush API (Application Programming Interface) is a method of extracting raw Semrush data without manually logging into the platform. It empowers marketers, analysts, and developers to automate insights and seamlessly integrate Semrush data into their own systems and workflows.

More than just an SEO audit API, Semrush API:

  • Provides access to a comprehensive ecosystem of data—from SERP insights, such as keyword rankings and backlinks, to website traffic, including AI search traffic data from AI-powered search engines and assistants like ChatGPT, Gemini, and Copilot.
  • Delivers website audience insights, key traffic channels, and market trends, enabling you to evaluate your domain performance across industries.
  • Supports local listing management, helping you maintain consistent business information across locations and track your location ranking on Google Maps.

Available Semrush APIs

API access is available on paid Semrush plans. Each API request consumes a specific number of API units depending on the endpoint and your plan. For details, refer to the Pricing page or contact our sales representatives.

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

Explore Semrush API tutorials and documentation

Use cases and tutorials

Explore the real-world Semrush API use cases with practical API method examples, and follow the step-by-step Semrush API tutorials to learn how each endpoint works in action.

Supporting documentation

Once you have your API access, review the following Semrush API documentation to ensure a smooth integration process and accurate data flow:

  • Explore the data available through the SEO tools API, Trends API, and Local API. This includes keyword rankings, backlinks, traffic insights, AI search data, and historical data for deeper performance analysis.
  • Review the available Semrush API versions (v3 and v4) to identify compatible endpoints, authentication types, and feature availability for your integration.
  • Learn about supported API response formats, including CSV and JSON outputs, to simplify integration with your BI tools or custom reporting systems.
  • Discover the available Semrush API options, such as the Analytics API, Projects API, Listing Management API, and Map Rank Tracker API, to support your specific SEO and local data use cases.
  • Check the API usage restrictions to ensure stable performance.
background image
Integrate Semrush data into your AI tools

The Semrush MCP server provides AI agents with secure access to Semrush APIs. It enables direct use of SEO metrics, traffic insights, and market trends in AI tools and assistants such as Claude (browser and desktop), Claude Code, Cursor, VS Code, and ChatGPT. For example, in ChatGPT you can use it as a connector to work with Semrush data directly in your chats.

Learn how to set up the Semrush MCP server to simplify your AI workflows.

Available data

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.
  • AI traffic: Traffic from AI-powered search engines and AI assistants like ChatGPT, Gemini, and Copilot.
  • 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.

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

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.
  • Concurrency limits: You can make up to 10 simultaneous requests per account.
  • 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 uses a rate limit service that allows up to 10 requests per second (RPS) per account.

The previous daily and hourly limits have been removed. These fields remain in the API response only for backward compatibility, and their values are no longer used or decreased.

Your monthly request limit depends on your Trends API subscription plan. You can use your entire monthly quota at any pace within the 10 RPS limit.

Learn more about Trends API ›

Listing Management API

Listing Management API methods have their own restrictions:

Learn more about Listing Management API ›