Open navigation

Semrush Analytics: Authentication and reauthentication guide

This guide will walk you through how to authenticate or reauthenticate Semrush Analytics with Google Sheets, Data Studio, and Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and API.    

Before you begin

To connect Supermetrics to Semrush Analytics, you need:


Here’s an example of sufficient user permissions:


Data protection agreement

If you have any questions about how Supermetrics handles and secures your data, read our policy on data privacy and security.


Query Types

The Semrush data source supports 5 main types of queries — Domain, Keyword, URLs, Display Ads, and Backlinks — for a total of 35 different query types. 

  • The data source uses the same structure as the API Reports with the same names, so you can check the Semrush Analytics API documentation to find out what specific reports are available and what fields you can pull from them.

Instructions


Google Sheets Data Studio  Excel Data integrations
Before you can authenticate the data source in Google Sheets, you need to install the Supermetrics add-on.
  1. Open a new Google Sheets file. 
  2. Click Add-ons → Supermetrics → Launch to open the sidebar.
  3. Under Data source, select Semrush Analytics.
  4. Enter your API key, and click Start.
  5. Navigate to Report configuration.
  6. Under Query type, select the query type.

    Insert the Domain/s. To select multiple domains, please separate them with commas. 

    As an additional filter, you can select the Display date.


Reauthenticate 
Learn how to reauthenticate the data source with Supermetrics Google Sheets.

Next steps
Learn how to create your first Supermetrics query with Semrush Analytics.


Troubleshooting

  • If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide
  • If you encounter a permission error such as “user permission denied” or similar, follow this guide.

Did you find it helpful? Yes No

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