How to Authenticate/Re-authenticate SEMRush Projects in Google Sheets & Google Data Studio

This guide gives instructions on how to successfully authenticate SEMRush Analytics. Please note that this data source is available with Google Sheets and Google Data Studio, and not yet with Microsoft Excel.   


Quick links to specific sections: 

Google Sheets

Data Studio

"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 Projects in Google Sheets, please do the following steps:

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

2. Select SEMRush Projects 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. Type to search for selecting projects.


5. Under report configuration select query type.

Note: SEMrush reports cost API units. Check the prices for different report types from here: https://www.semrush.com/api-projects/#prices


Re-authenticating with Google Sheets:

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


Authenticating with Data Studio:

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

1. Click on add data.

2. Search for SEMRush Projects 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. Click on the link below to authenticate your user account. 

With this link, you can also add or delete users.

6. Click on OK, let's continue to continue with that user. If you wish to log in with a different user, click on Add SEMRush Projects user account. Click on remove to remove the user account.

- If your Data Studio account belongs to multiple teams, you will see the option to select the team you wish to use. Go to the link below and select the team name with your license to proceed. (If you only belong to one team, skip to the next step).

7. Select projects, query type and click on next.

Check the prices for different report types from here: https://www.semrush.com/api-projects/#prices

Depending on the query type you choose, there will be additional filters to select. The URL field is mandatory, however, the other fields are optional.

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

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

Re-authenticating with Data Studio:

To re-authenticate SEMRush Projects in Data Studio, 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: "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.


Refreshing tokens 

As a final step, if you wish your tokens to be refreshed, please create a support ticket.


Did you find it helpful? Yes No

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