contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

10:00 AM - 6:00 PM (EST/EDT)

Monday - Friday

mobile-menu

How to get API

Basics docs divider Last updated: September 15, 2021

Standard API package

1) Upgrade to Business subscription

This will give you an opportunity to buy API units and generate an API key.

pricing-1

2) Buy suitable amount API units according to your needs


Go to the Account tab -> Subscription info -> API Units

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

pricing-2.1 (1).png

How many API units do you need?

We distinguish between three types of requests made via 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. One dollar is equal to approximately 20,000 API units.

For example, one line of results in the Organic Keywords 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 you to calculate your API request limit before purchasing an API package. You can increase your request limit by purchasing API units.

3) Generate your API key

pricing-2 (1).png

Traffic Analytics API package

1) Upgrade to any paid subscription plan

This will give you an opportunity to buy Traffic Analytics API package and get an API key.

pricing-1

2) Buy package that suits your needs

Go to the bottom of Subscription info page, choose your plan, and click Get access +10k units.

Traffic Analytics API comes in all paid subscriptions in 2 plans:

  • Basic: provides only traffic summary data
  • Extended: provides traffic summary data and extended information about the website traffic
The monthly limit rate included by default is 10,000 requests. This API does not use any 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.

pricing-3.png

3) Get your API key

After the purchase is made you’ll receive your API key via customer support specialist.

background image
Custom API package

Custom packages and pricing are available when you contact a sales representative at sales@semrush.com