What within the World Is API, and How Do I Use It?



Software Programming Interface (API) is a technique of gathering uncooked information from Semrush with out utilizing the usual web site interface.

If the Semrush interface is like strolling by a grocery retailer to select your groceries by hand; an API is like ordering your groceries in bulk from a same-day drone supply. 

Pulling information through an API may be automated, so it is a superb resolution for gathering huge units of knowledge effectively.

You will get information quicker than by utilizing the interface and use it to combine Semrush information into your dashboards and different software program.

Frequent makes use of of APIs embody:

  • Customized dashboards for a digital company’s purchasers

  • Inner firm dashboards for eCommerce, funding corporations, and so forth.

  • Re-selling Semrush information by a software program service

  • Gathering large units of knowledge at a quicker fee in comparison with utilizing the Semrush interface (glorious for intensive key phrase analysis or massive Place Monitoring campaigns)

  • Pulling Visitors Analytics information on all your rivals in a single report

What’s the catch? Effectively, if you’re unfamiliar with APIs, it may be a bit technical. 

However, if you happen to or a teammate or coworker of yours has expertise with an API, the Semrush API ought to be comparatively simple to choose up. 

This publish is for introducing the fundamentals of APIs and the way they are often helpful. We’ll get into the specifics of Semrush APIs as effectively. For an inventory of all of our calls, parameters, and technical particulars, please find (and bookmark!) the Semrush API Documentation.

Who’re APIs for?

An API can be utilized for an infinite variety of functions. Anybody that may program scripts with API and has the necessity to collect digital advertising information could make use of it. 

Particularly, Semrush’s API is well-liked amongst digital companies, information scientists, analysis corporations, SaaS software program builders, enterprise capitalists, and re-sellers of Semrush information. 

How does an API work?

An API operates based mostly on a easy name and response. The weather of an API name (defined additional beneath on this publish) create an HTTP handle and embody parameters (separated by the “&” image) for the precise report you’re requesting, the database, question, any filters, and naturally, your API key. 

Turning the uncooked information into one thing tangible

To make use of an API successfully would require somebody aware of internet improvement to create a script or an identical program that may automate the reception and integration of knowledge.

In laptop science, a script is a doc written in a dynamic programming language (frequent languages embody Python, Perl, Powershell, Tcl) that ship directions to laptop applications to automate duties.

With a script, you’ll be able to work with our API calls to show the .CSV or JSON output into one thing readable like a spreadsheet or dashboard.

Net builders can write scripts to take uncooked information from the Semrush API and combine it into readable tables, dashboards, reviews, and interfaces.

Beneath I’ll discuss in regards to the completely different APIs supplied on Semrush and present an instance of how a script can pull this information and combine it right into a spreadsheet.

In case you are excited by buying a script that works with an API from us, you’ll be able to contact us by telephone or electronic mail or from the Customized Report web page right here.

What APIs does Semrush supply?

Semrush affords two important API packages:

  1. Customary Semrush API, which incorporates:
    1. Analytics API (Area Analytics and Key phrase Analysis)
    2. Initiatives API (Web site Audit, Place Monitoring, and Mission Administration) 
  2. Visitors Analytics API (a separate API for Visitors Analytics information, launched in 2019)

How are you going to get it?

To make use of our Analytics API and Initiatives API, that you must:

  • Subscribe to the Enterprise Semrush plan

  • Buy the API package deal and the variety of API models that can suit your wants 

To make use of Semrush Visitors Analytics API, you first have to have a Semrush subscription plan (it doesn’t need to be a Marketing strategy). The Visitors Analytics API is available in two varieties: Primary and Prolonged. 

  • The Visitors Analytics Primary API enables you to collect information from the Visitors Analytics Overview report. 
  • Visitors Analytics Prolonged API gathers information from the extra in-depth reviews on this instrument: Visitors Sources, Geographic Distribution, Vacation spot Websites, and Subdomains.

For extra particulars, please be happy to confer with Visitors Analytics API documentation.

You’ll be able to add a Visitors Analytics API to your plan instantly out of your Subscription Data web page or you’ll be able to attain out to our gross sales group. We’ll show you how to determine what number of API models you want and give you your API key. 

Your API key may be discovered within the API models tab of the Subscription Data web page

Developing an API Name

To obtain information through Analytics API, that you must construct an API name (also called a request). 

An API name is a request despatched to the server for information from the Semrush database.

The API name is constructed by combining parameters to outline the information that you just wish to obtain. Parameters embody the kind of report, your API key, the area you’re querying, the database, show date, export columns, filters, and extra. 

Beneath is a color-coded breakdown of a Area Overview API name for seobook.com (US database) with 8 columns. 


The parameters on this name are as follows:


Discover the show date is about to January 2018, making this a name for historic information (20180115 represents January 2018 in YYYYMM15 format). Since this name is in our Analytics database, the information will characterize a month-to-month determine. Subsequently, 15 is only a placeholder to make use of for the day in the usual YYYYMMDD format.

Utilizing Initiatives API, if you’re pulling information from a Place Monitoring undertaking, you’ll be able to specify a single date to tug the information for. 

The parameters and variety of strains included in every name will decide the price of the decision in API models. A name that asks for six columns of knowledge for 100 domains will price ten instances the quantity of models in comparison with a name asking for a similar six columns of knowledge for ten domains. 

Examples of all parameters, columns, filters, sorting, and databases can all be discovered within the API Documentation.

Column names, for instance, may be discovered within the “Columns” part of the API Documentation.


Along with the essential parameters, there are additionally parameters for including filters, sorting by metrics, and setting a show restrict to the variety of strains the decision will return. All of those parameters may be discovered within the menu on the API documentation.

API Output

After constructing your API name (or request) and sending it to our server, Semrush will return uncooked information with the column headers and the information. If you happen to kind the decision right into a browser’s handle bar, for instance, it can return the uncooked information within the browser and appear like this: 


This response is 1 line as a result of it’s only reporting information for 1 area. 

This output is technically a .CSV file. The outputs of our APIs are:

Half 1: Analytics API

Now, what may be performed with the Analytics API? This API can be utilized to tug reviews on area analytics, aggressive analysis, key phrase analysis, backlinks, promoting analysis, and extra.

These are the traditional reviews on Semrush used to review the search positions and on-line visibility of your rivals or trade. If aggressive analysis is part of your workflow, utilizing API will speed up the method.

For gathering complete web site site visitors estimations (not simply site visitors from search), you’ll wish to look into the Visitors Analytics API. Visitors Analytics affords a breakdown of site visitors from search, social, direct, paid, and referral, along with complete month-to-month visits, time on web page, bounce fee, pages/session, and extra.

Utilizing a Script with Analytics API

Now, if you happen to had a script that would course of API calls right into a formatted desk, you could possibly make queries in bulk and get super-fast outcomes. For instance, if you happen to had an inventory of ten domains like this:


You possibly can use a script to investigate every thing listed within the spreadsheet. Pictured beneath is a bit of a script written to tug information by the Semrush API and import the strains to a clear spreadsheet on the pc’s desktop.


Discover on the finish of the GIF the time it took to make this name was roughly 1.3 seconds. Now, the file may be discovered on the desktop. 


These are the fundamentals of API. In fact, our instance solely confirmed the method with 10 domains, and it took one second. You should use an identical course of to tug information on a whole lot of 1000’s of domains in solely minutes. 

To familiarize yourselves with our API language and format a name, builders have to learn our API documentation

Half 2: Initiatives API 

The Initiatives API permits customers to create, edit, and handle initiatives utilizing the Web site Audit and Place Monitoring instruments. 

You’ll be able to pull reviews from present initiatives or create a brand new undertaking and configure it with an API name. As a result of the interface makes it simple to configure a Mission with particular settings, folks will generally create their Initiatives within the interface after which use API to tug the information. 

Please notice: Initiatives API shares API models with Analytics API. Visitors Analytics API, nonetheless, is separate from Analytics and Initiatives and doesn’t use API models. 

Place Monitoring can monitor you and your rivals’ key phrase rankings and uncover native rivals. Our Web site Audit instrument will crawl an internet site and give you an in depth listing of points on the location you could repair to enhance its website positioning. 

These two instruments are particularly nice for consumer reporting. They’ll present overview metrics like the final well being rating of an internet site (Web site Audit) and visibility throughout goal key phrases (Place Monitoring). Because of this, the Initiatives API is a superb resolution for automating client-facing or inner dashboards. 

One other nice purpose to make use of Initiatives API is for the pace. In comparison with the interface, the API will be capable to export information from massive Initiatives at a extra environment friendly fee. 

Beneath is an instance of how it could look utilizing a script to tug information from an present Mission right into a easy spreadsheet. 

Utilizing a Script for Initiatives API

First, let’s say we’ve a Place Monitoring marketing campaign on Semrush. The area is ebay.com, and it’s monitoring 81 key phrases and 20 rivals. The Mission ID (discovered within the URL) is 1565219.


Here’s a script that’s formatted to GET the information from the present Place Monitoring Mission.


Be aware how the script solely took six seconds (Time — 0:00:06.3727)to export 1000’s of rows of data. Beneath is the spreadsheet that the script created — all the key phrases within the marketing campaign together with the competitor’s rating pages.


SERP Options Codes

In case you are pulling information from a Place Monitoring marketing campaign, you will note a column for the SERP Options that the tracked area ranks for. The SERP Options codes as they seem in API are as follows:

  • fsn: Featured snippet

  • geo: Native pack

  • rev: Opinions

  • stl: Web site hyperlinks

  • vid: Video

  • vib: Featured video

  • new: Prime tales

  • rel: Individuals additionally ask

  • img: Photos

  • twt: Twitter

  • knw: Immediate reply

  • kng: Information panel

  • shp: Buying adverts

  • adt: AdWords high

  • adb: AdWords backside

Technical Particulars – Initiatives API

Not like the Analytics API, all Mission API requests function by the next HTTP instructions:

POST: Ship a POST name to create one thing new, e.g., create a brand new undertaking, allow Place Monitoring/Web site Audit instrument. 

PUT: Ship a PUT name whenever you wish to make some modifications to your present initiatives, e.g., change the key phrases or rivals in Place Monitoring, change the crawled web page restrict. 

GET: Ship a GET name to tug some reviews of present initiatives, e.g., every day natural place report, problems with a website audit marketing campaign. 

DELETE: Ship a DELETE name to delete something present, e.g., delete an present undertaking, delete key phrases from an present undertaking.

Half 3: Visitors Analytics API 

The opposite API that’s separate from any Semrush subscription is Visitors Analytics. Visitors Analytics permits you to collect site visitors estimations for an internet site. With the pace of API, you’ll be able to analysis this information extra effectively. 

Visitors Analytics API doesn’t come as part of the principle Semrush API. It must be bought individually from any Semrush subscription, or along with any subscription. 

Please notice that we provide two variations of this API:

  1. Primary API: Visitors Overview report

  2. Prolonged API: Visitors Overview report, Visitors Sources, Visitors Locations, Geographic Distribution, and Subdomains

This API can combine seamlessly with software program like Google Sheets, Excel, Salesforce, Tableau, Energy BI, and extra. 

Visitors Analytics Use Circumstances

Some examples of how you could possibly use this API embody:

  • Qualifying new leads

  • Evaluating new markets 

  • Enhancing an present SaaS providing with site visitors information

  • Offering information on prospects to your gross sales group

  • Evaluating new enterprise companions and prospects 

To qualify new leads, you could possibly take your listing of domains and pull all of their Visitors Overview information to see which leads have the very best web site engagement and which web sites present weak engagement from their guests. The leads with the worst engagement could possibly be the perfect locations to begin if you’re pitching web site companies. 

To consider a brand new market, you could possibly collect an inventory of domains available in the market you wish to find out about, after which make an API name to tug their site visitors information. An Overview name would can help you see the typical qualities of the market, corresponding to web site visits, cell vs. desktop site visitors, time on web page, pages per session, and extra. 

If you happen to already supply a SaaS platform for folks to review web sites or companies, including Semrush Visitors Analytics information to your providing would give highly effective insights into this enterprise’s on-line presence — excellent information for aggressive evaluation. 

The Visitors Analytics API may additionally combine with a gross sales prospecting software program to provide your gross sales group further information about every alternative. Which suggests they will at all times carry information to their gross sales pitch. 

If that you must consider new enterprise companions and prospects, this API may combine along with your present data and supply perception into their strengths and weaknesses on-line. 

Utilizing Visitors Analytics API with a Script

Once more, this API can simply combine right into a script. Let’s take the next ten domains from a spreadsheet: 


Use a script to tug the information: 


And the ensuing information on these domains populates into this spreadsheet: 


Calculating API Models Utilization

As you propose your Analytics and Initiatives API calls, you will want to estimate what number of API models you’ll be spending. 

Consider: Visitors Analytics API doesn’t use API models, and subsequently you gained’t have to calculate models, and Accounts API calls are free. Calculating API Models is simply related for Analytics and Initiatives API calls. 

Every Analytics and Initiatives name has its personal value, and for historic information, the value will go up. The API documentation will inform you the value in models per line of every name. 


To estimate your finances, you will want to estimate a number of issues:

  • If the API is getting used internally or externally

  • What sort of information is getting used (which reviews you’ll use & if you would like dwell or historic information)

  • How a lot information you will want (what number of calls you’ll be making each month)

To calculate the price of a name, you would want to multiply the price per line by the variety of strains within the name. 

What’s a line?

Effectively, if you happen to consider the response as a .csv file, every row of knowledge within the response is a line. Every line may characterize metrics for a selected key phrase, area, or URL relying in your report. Be aware within the picture beneath how the decision has a display_limit parameter of 25 and subsequently returns 25 strains. 


One other instance could be if you wish to pull the highest 100 key phrases for a website utilizing dwell information; you’ll use the “domain_organic” name, which prices 10 API models per line for dwell information, or 50 API models per line for historic information. 


In fact, calculating API models utilization will probably be extra difficult than that as you utilize API extra extensively, however the fundamental logic stays the identical. You can be charged API models for each line of knowledge that you just request. 

To view your API models stability, go to your Semrush Profile – Subscription information – API models.

Integrating with Google Sheets

Utilizing API with Google Sheets is without doubt one of the easiest methods to combine API with one other platform. 

Very similar to Microsoft Excel, Google Spreadsheets helps a big selection of capabilities.

By utilizing capabilities like IMPORTDATA, TRANSPOSE, and SPLIT, you’ll be able to enter your API calls right into a cell and populate the spreadsheet with formatted information.

For instance, a Area Overview report request instance utilizing IMPORTDATA would look just like the next:

(importdata(” https://api.semrush.com /kind=domain_rank&key=abcdefghijklm0pqrstuv123&export_columns=Dn,Rk,Or,Ot,Oc,Advert,At,Ac&area=seobook.com&database=us“)

The outcomes of the decision will populate into the cell that you just entered the system.


We have now an article in our Information Base that exhibits you use Visitors Analytics API in Google Sheets.


If you wish to collect extra information at a quicker tempo than the interface, Semrush API is your excellent resolution.

Including the usual API to your subscription is offered after subscribing to the Enterprise degree and can grant you entry to our Analytics API, Initiatives API, and Accounts API. These APIs will allow you to pull analysis information in your competitor’s search efficiency, key phrase analysis, and construct superior progress dashboards. 

Request API entry right here

Anybody should purchase Semrush Visitors Analytics API – with or with no Semrush subscription. This API is superb for evaluating markets and potential enterprise companions and investments.

Phrases of Use

Earlier than utilizing our API, that you must learn and comply with our phrases of use. If you happen to want to resell our information through API, a separate settlement have to be made. Full phrases of use may be discovered right here.