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

How to get API

Basic docs divider Last updated: April 4, 2024

Standard API

1. Upgrade to Business subscription

Upgrade to the Business subscription to buy API units and generate an API key.

Business.png
Note that after upgrading to the Business subscription the number of units will still be zero.

2. Buy API unit package

Now you can buy API units according to your needs:

  1. Click the icon at the top right of the Semrush interface to access your account.
  2. Select Subscription info and go to the API Units tab.
  3. Select an API unit package and click Buy more.
Buy API units

background image
How many API units do you need?

We distinguish between three types of requests made via the Semrush API: lines, calls, and keywords.

  • A line request involves the uploading of data from different reports.
  • A call request should be used when you want to create, update, or delete a project.
  • You should apply a keyword request when you need to add new search terms to your tracking campaign. In this case, you will be charged additionally for each new added keyword.

The cost of requests is measured in units. Units are determined by the type of report or request. Delivering historical data requires more units than live data.

For example, one line of response in the Organic Results report costs 10 units for live results and 50 units for historical data. If you’d like to list 1,000 organic keywords for 100 domains, you will be charged for 1,000,000 and 5,000,000 units, respectively (1,000 keywords * 10 API units for live data * 100 domains = 1,000,000 units; 1,000 keywords * 50 API units for historical data * 100 domains = 5,000,000 units).

We recommend calculating your API request limit before purchasing an API unit package. You can increase your request limit by purchasing API units.

Note that you don't need to buy API units to use the Listing Management API. It's available for all Semrush Local Premium Plan users.

3. Copy API key

Once you have purchased API units, copy your API key to use it in your API requests:

Copy API key

Traffic Analytics API

1. Upgrade to paid subscription

Upgrade to any paid subscription plan to be able to buy access to the Traffic Analytics API and obtain your API key.

Pricing.png

2. Get API units

The Traffic Analytics API comes in all paid subscriptions in two plans:

  • The Basic plan provides only traffic summary data.
  • The Extended plan provides traffic summary data and extended information about the website traffic.

To get API units according to your needs:

  1. Click the icon at the top right of the Semrush interface to access your account.
  2. Select Subscription info and go to the Summary tab.
  3. Choose your plan and click Get access +10K units:
Traffic analytics API.png
The monthly limit rate included by default is 10,000 requests. The Traffic Analytics API doesn't use any standard API units.
You can always upgrade your plan from Basic to Extended or increase your limits by choosing the corresponding option on the Subscription info page.

3. Get API key

After the purchase is made, our custom support specialist will send you the API key.

background image
Custom API options

To learn about custom API options and pricing available to you, contact our sales representative at sales@semrush.com