This guide will walk you through how to authenticate or reauthenticate Semrush Analytics in Supermetrics with Google Sheets, Data Studio, and Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and the Supermetrics API.
Before you begin
To connect Supermetrics to Semrush Analytics, 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.
Query types
Semrush Analytics 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 use the Semrush Analytics API documentation to find out what specific reports and fields are available.
Instructions
- Open a new Google Sheets file.
- Click Add-ons → Supermetrics → Launch to open the sidebar.
- Under Data source, select Semrush Analytics.
- Enter your email and password, and click Log in.
- Click Approve.
- Navigate to Report configuration.
- Under Query type, select the query type.
- Enter one or more domains. Separate them with commas.
- Open the Supermetrics data source gallery.
- Navigate to Semrush Analytics and click Try.
- Click Authorize.
- If you're authenticating the data source for the first time, log in with the Google Account you use with Supermetrics. Click Allow.
- Click Authorize.
- Enter your email and password, and click Log in.
- Click Approve.
- Select the query type, and click Next.
- Enter one or more domains. Separate them with commas.
- Click Connect on the top right-hand side.
- Click Create report.
- Click Add to report.
When you're ready, learn how to create your first Supermetrics query with Semrush Analytics.
Add or remove a user account in Data Studio
- Click the edit icon next to the data source's name in the Data Studio sidebar.
- At the top left of the connection pane, click Edit connection.
- Scroll down to Parameters.
- Browse team, account, and license management options in the section beginning "To add more/manage accounts..."
Connections
If you use Excel and no other Supermetrics products, you’ll be able to connect accounts to data sources and share these connections with your team. You can manage connections either within the add-in sidebar or via the Supermetrics Team Site. Learn more about shared connections.
Before you can authenticate the data source in Excel, you need to install the Supermetrics add-in.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select Semrush Analytics.
Enter your email and password, and click Log in.
Choose to make this connection shared or private.
Click Approve.
- Under Query type, select the query type.
- Enter one or more domains. Separate them with commas.
- As an additional filter, you can select the Display date.
Explore our guides to set up data transfers to various destinations.
- BigQuery
- Data warehouses and cloud storage (Amazon S3, Google Cloud Storage, Snowflake, Azure Storage, or Azure Synapse)
- The Supermetrics API
Reauthenticate the data source
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.