Open navigation

Semrush Projects: Authentication guide

This guide will walk you through how to authenticate or reauthenticate Semrush Projects in Supermetrics with Google Sheets, Data Studio, and Excel.

Before you begin

To connect Supermetrics to Semrush Projects, you need an API account with Semrush and a Semrush subscription for API request units. Learn more about Semrush accounts and API request units.

Each API call has a cost, and the cost of requests is measured in API units. Units are determined by the type of report or request retrieved from the Semrush API, and fetching historical data requires more units than live data. One US dollar is equal to approximately 20,000 API units. 


Google Sheets Data Studio Excel
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 Projects.
  4. Enter your API key and click Start.
  5. Select the project.
  6. Navigate to Report configuration.
  7. Select the query type.


  • 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.