API

This API is available as an add-on to a Business subscription. The standard API package comes with three main APIs; Analytics, Projects, and Accounts APIs. When you add API to your subscription you will have a limited amount of API units that you can use to make calls. Whenever you run out of units, you can buy more from the Subscription Info page or by contacting us. 

• Analytics API allows you to pull data from Analytics reports including:

  • Domain Analytics 

  • Organic Research 

  • Advertising Research 

  • Keyword Gap Analysis 

  • Keyword Analytics 

  • Backlink Analytics 

  • Display Advertising 

• Projects API can pull data from Position Tracking and Site Audit campaigns created in Projects. Analytics and Projects API calls each have a cost in API units, which you will have a budget for when you purchase access to this API. 
   

• Accounts API can pull data such as your API export history, queries, and API unit balance. These calls will not charge you any API units. 

See the full list of SEMrush reports that API can pull here. Your API key can be found on your Subscription Info page. 

Traffic Analytics API is available at a monthly price and can be purchased separately from any SEMrush product - you don’t need to have an existing SEMrush subscription  to get this API. 
 

This API gives you access to pulling any website’s traffic data such as visitors, visitor engagement and behavior, traffic sources, geographic traffic distribution, mobile/desktop traffic and more for any domain in our database.  
 

This API does not use any API units associated with the standard SEMrush API for Business subscriptions. It is available as its own monthly or annual subscription. 
 

If you are interested in our Traffic Analytics API please contact sales@semrush.com and we’ll provide you with a quote that fits your needs. To test out the Traffic Analytics API, check out the demo tool we created to visualize what you could do with this API. 
 

 When you purchase Traffic Analytics API, we will create a custom SEMrush account for you if you didn’t already have one. 
 

Your API key will be sent to you via your account representative when you purchase the API plan.

The API Documentation pages below will be key for working with the API as every call will be broken down and explained for you there. The proper formatting will be displayed as well so that you are able to correctly structure your API calls. These calls can be made by pasting your API call in a web browser.
 

Please use the following documentation links to find help on API:

• API Summary

• API Terms of Use

• Analytics API (Domain Analytics, Keyword Analytics, Backlinks, Display Advertising, etc)

• Projects API (Position Tracking, Site Audit)

• Accounts API (queries, exports, api unit balance)

• Traffic Analytics API Documentation

• Exporting Traffic Analytics API to Google Sheets

Please note that in section 2.3 of our terms of service we ask that you not call more than 10 inquiries per second from our API:

If you subscribe to the SEMrush API, in addition to the restrictions set forth above, you agree (i) not to forward more than 10 inquiries per 1 second from one unique IP address or more than 10 simultaneous inquiries from 1 User; and (ii) not to cache the information received from the Services for more than one (1) month without the express written consent of SEMrush. You may not use the Services if you are legally prohibited from receiving or using the Services under the laws of the country in which you are resident or from which you access or use the Services.