SEM Rush

Vendor/Partner	SEMRush
Version	Version 3.0
API Documentation	https://www.semrush.com/api-analytics/
Sunset Date	None as of 10/03/2024. Version 4.0 is already available
Channel(s)	SEO
Refresh Time (CST)	4 am
Default backfill	1 day
Alli Data Library

Getting Started

When setting up this datasource you will need to input the API Key from SEMRush, the domain of the website you’d like to investigate, a regional database, and the limit of results you’d like it to output.

Where to find your accounts API Key:

Click the drop down in the upper right corner and go to My Profile
When in My Profile, click on Subscription info on the left side
Once in Subscription info, navigate to the API Units tab under the Subscription info header
Once there, your API Key and API units will be the only things on the page.

Limitations

Due to the response from the server only coming in one format all the Dimensions and Metrics are required except for the date which you can choose to include or not. Also as of August 17th, 2021 PMG’s SEMRush account has 0 API units with no plans to refill for the near future so the datasource is unusable for real data from SEMRush. This will continue being the case until the API units are refilled.

Define your Data

Dimensions

Name	Description
keyword	Keyword bringing users to the website via Google's top 100 organic search results.
date	Either filled by start date of the datasource or if month of end date is ahead of start date it is filled by the 15th of the start date month

Metrics

Name	Description
position	Position a URL gets with a particular keyword in Google's top 100 organic or paid search results.
prevposition	A position a domain gets with a particular keyword in Google's top 100 organic or paid search results.
positiondiff	The difference between the previous position a domain was earning with a particular keyword and its current position.
volume	The average number of times users have searched for a given keyword per month. We calculate this value over the last 12 months.
cpc	Average price in US dollars advertisers pay for a user's click on an ad containing a particular keyword (Google AdWords).
url	The URL of the target page (Backlinks).
traffic	The share of traffic driven to the website with a particular keyword for a specified period.
trafficcost	The percentage of the domain's total traffic cost that is attributed to a particular keyword.
competition	Competitive density of advertisers using the given term for their ads. One (1) means the highest competition.
numofresults	The total number of organic results returned for a given keyword at the last date of collection.
trends	The interest of searchers in a particular keyword during the last 12 months. This metric is based on changes in the number of queries per month.