Open navigation

Ahrefs: Authentication and reauthentication guide

This guide will walk you through how to authenticate or reauthenticate Ahrefs with Google Sheets, Data Studio, and Microsoft Excel, as well as data warehouse destinations like GoogleCloud Storage, BigQuery, and the Supermetrics API. 

Before you begin

To connect Supermetrics to Ahrefs, you need to meet the following requirements:

Here’s an example of sufficient user permissions:

Multiple user accounts

Please note that with the Ahrefs data source in Supermetrics, it’s not possible to add multiple user accounts in the same login. To log in with a different user account, you need to log out from the previous user account. 

Target URL 

For the field "target URL" we support the following domains: HTTP, HTTPS, and WWW.

Data protection agreement 

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


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 Ahrefs.
  4. Click Start.
  5. Enter your email address and password, and click Sign in.
  6. Click Allow.
  7. Navigate to Report configuration.
  8. Under Query types, select the query type.
  9. Under Target URL, insert the target URL. 


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

Next steps

Learn how to create your first Supermetrics query with Ahrefs.


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