Developer
Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
How to get API
Basics docs
Last updated: September 15, 2021
Last updated: September 15, 2021
Intro
Semrush offers two main API options:
- Standard API package
- Traffic Analytics API
Standard API package
1) Upgrade to Business subscription
This will give you an opportunity to buy API units and generate an API key.
2) Buy a 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.
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
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.
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.
3) Get your API key
After the purchase is made you’ll receive your API key via customer support specialist.
Custom API package
Custom packages and pricing are available when you contact a sales representative at sales@semrush.com