How to Authenticate/Re-authenticate SEMRush Analytics in Google Sheets, Google Data Studio & Microsoft Excel

This guide gives instructions on how to authenticate SEMRush Analytics with Google Sheets, Google Data Studio, and Microsoft Excel. 


Quick links to specific sections: 

Google Sheets

Data Studio

Excel

"If everything fails..." 

Data Source Access Requirements:

The SEMRush connector requires you have set up an API account with SEMrush and have purchased a subscription with them for API request units. Supermetrics does not include this with the connector. If you have not done so already, please visit this site to get started with your SEMrush account https://www.semrush.com/api-use/ and follow this guide SEMRush API units


Authenticating with Google Sheets

To authenticate SEMRush Analytics in Google Sheets, please do the following steps:

1. Open up the Supermetrics sidebar in your Google Sheets. 

2. Select SEMRush Analytics in the sidebar, under data source.

3. Insert your SEMrush API key and click on login

If you don't have an API key and a SEMRush subscription, please see https://www.semrush.com/api-use/

4. Select the query type and insert the domain/s. To select multiple domains, please separate them with commas. To learn more on domain/s, please see Special Formatting Requirement for "Domain vs. Domain" Query Type

As an additional filter, you can select the display date. To learn more, please see Using the 'Display Date' Option for SEMrush Analytics

5. You have completed all the steps. You can now go back to the sidebar and select your SEMRush account under data source.

Re-authenticating with Google Sheets:

To re-authenticate SEMRush Analytics in Google Sheets, please go to this guide.


Authenticating with Data Studio:

To authenticate SEMRush Analytics in Google Data Studio, please do the following steps:

1. Click on add data.

2. Search for SEMRush by Supermetrics and click on it.

3. Click on Authorize. If you wish to learn more about data security and data privacy, please see this page.

4. Insert your SEMrush API key and click on login

If you don't have an API key and a SEMRush subscription, please see https://www.semrush.com/api-use/


5. Select query type and click on next.


6. Insert the domain/s. To select multiple domains, please separate them with commas. To learn more on domain/s, please see Special Formatting Requirement for "Domain vs. Domain" Query Type

As additional filters you can:

7. Click on add on the bottom right side to continue. 

8. As a final step, click on add to report.



Adding additional user accounts or removing old ones with Data Studio


1. Click on the link below to add additional user accounts or to remove old user accounts. If you don't need to add/remove user accounts, you can skip this step.


2. If you wish to add a user account, click on Add SEMrush Analytic user account. If you wish to remove a user account, click on remove. To continue with the same user account, click on Ok, let's continue.



Team management with Data Studio


From the link below, you can access your team management page, where you can change assigned users on your licenses, add new team members, etc. For more details, please see Team Management Basics


Re-authenticating with Data Studio:

To re-authenticate SEMRush Analytics in Data Studio, please go to this guide.


Authenticating with Excel:

To authenticate SEMRush Analytics in Excel, please do the following steps:

1. Click on data and open up the Supermetrics sidebar in Excel.

2. Select SEMRush Analytics in the sidebar under data source.

2. An automatic popup will open up, insert your SEMRush API key and click on start.

If you don't have an API key and a SEMRush subscription, please see https://www.semrush.com/api-use/

3. Select query type and insert the domain/s. To select multiple domains, please separate them with commas. To learn more on domain/s, please see Special Formatting Requirement for "Domain vs. Domain" Query Type


As additional filters, you can:

-Choose the number of rows per item.

-Select the display date. To learn more, please see Using the 'Display Date' Option for SEMrush Analytics


4. You have completed all the steps. You can now go back to the sidebar and select your SEMRush account under data source.

Re-authenticating with Excel:

To re-authenticate SEMRush Analytics in Excel, please go to this guide.


Common errors:

If you encounter any of the following errors below, please see the guide linked after the error message.

  • Error: "Authentication failed" & "You need to re-authenticate at X and then run the query again.", please see this guide
  • Error: "This was a reauthorization request for user X but logged in as user Y", please see this guide
  • Error: "You're not allowed to run queries with this license #12345. This is because you have not been assigned to the license as a valid user." please see this guide.
  • Error: "This action is not supported when you are signed into multiple accounts". please see this guide.
  • If you no longer see a specific account/page/etc. when logging in, please see this guide
  • If you haven't managed to authenticate you might be affected by an issue at Google account management. For more information, please see this guide.

Forcing a refresh per account data & removing a data source:

To force a refresh per data source, please see this guide.

To remove a data source from Google Sheets, please see this guide.

To remove a data source from Data Studio, please see this guide.

To remove a data source from Excel, please see this guide.


Further assistance 

If you followed all the above steps and you still encounter an authentication error, please create a new support request with the details of the issue and we will assist you.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.