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:
- Have an Ahrefs paid plan subscription, at least a Lite package. Learn more about all pricing plans in Ahrefs’ documentation.
- Have a valid Admin or Owner user role level. To learn more, please see how to add member roles and access levels, and how to add a new user to your account.
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.
Instructions
- Open a new Google Sheets file.
- Click Add-ons → Supermetrics → Launch to open the sidebar.
- Under Data source, select Ahrefs.
- Click Start.
- Enter your email address and password, and click Sign in.
- Click Allow.
- Navigate to Report configuration.
- Under Query types, select the query type.
- Under Target URL, insert the target URL.
Reauthenticate
Learn how to reauthenticate the data source with Supermetrics in Google Sheets.
Next steps
Learn how to create your first Supermetrics query with Ahrefs.- Open the Supermetrics data source gallery.
- Navigate to Ahrefs and click Try.
- Click Authorize to authorize Supermetrics in Data Studio.
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 to log in to your data source.
- Enter your email address and password, and click Sign in.
- Click Allow.
Navigate to Report configuration.
Under Query types, select the query type and click Next.
Under Target URL, insert the target URL.
- Click Connect on the top right-hand side. This will open a full list of fields available in this connector. You can skip this list.
- Click Create report.
- Click Add to report to complete the authentication steps.
Add or remove a user account
- To add or remove a user account go back to the data source settings. Click on the link at the end of the sentence that starts with “To add more/manage user accounts…”
- Click +Add new account to add a new user account.
- Click the Trash icon to remove that specific user account.
- Click Continue to proceed with that user account.
Reauthenticate
Learn how to reauthenticate the data source with Supermetrics in Data Studio.
Next steps
Learn how to create your first Supermetrics query with Ahrefs.Before you can authenticate the data source in Excel, you need to install the Supermetrics add-on.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select Ahrefs.
- Click Start.
- Enter your email address and password, and click Sign in.
- Click Allow.
- Navigate to Report configuration.
- Under Query types, select the query type.
- Under Target URL, insert the target URL.
Reauthenticate
Learn how to reauthenticate the data source with Supermetrics in Excel.
Next steps
Learn how to create your first Supermetrics query with Ahrefs.Explore our guides to set up data transfers to various destinations.
- Set up BigQuery
- Set up data warehouse and cloud storage (Amazon S3, Google Cloud Storage, Snowflake, Azure Storage, or Azure Synapse)
- Set up 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.