--- title: "Ahrefs connection guide" slug: "ahrefs-connection-guide" description: "Connect your Ahrefs data to Supermetrics with our guide. Learn about permissions, query types, and connection instructions for seamless data integration." updated: 2025-11-12T13:43:36Z published: 2025-11-12T13:43:36Z --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt > Use this file to discover all available pages before exploring further. # Ahrefs connection guide This guide contains all permissions and requirements for connecting your Ahrefs data to Supermetrics. You can connect to data sources from the [Data sources page on the Supermetrics Hub](https://hub.supermetrics.com/token-management). On the Hub, you can also [share an authentication link](https://docs.supermetrics.com/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub#share-authentication-link) to connect to a data source you don't have direct access to. After you connect to the data source on the Hub, you can use the data source connection in [all available destinations](/docs/ahrefs-connection-guide#connection-instructions). > [!NOTE] > Ahrefs and Ahrefs (legacy) > > We introduced a new version of our Ahrefs data source connector in February 2024. We updated this connector on October 29, 2025 to allow customers on any Ahrefs plan to connect using your Ahrefs login details. The Ahrefs (legacy) connector will be fully deprecated and stop working on October 31, 2025. ## Required permissions To connect Supermetrics to Ahrefs, you need: - An **Admin** or **Owner** user role level. See Ahrefs' documentation about [member roles and access levels](https://help.ahrefs.com/en/articles/6791295-access-control-features) and [how to add a new user to your account](https://help.ahrefs.com/en/articles/411099-how-do-i-add-a-new-user-to-my-account). ### Multiple user accounts It's not possible to add multiple user accounts in the same login for Ahrefs. To log in with a different user account, you need to log out from all other Ahrefs accounts in Supermetrics. ### Target URL We support HTTP, HTTPS, and WWW for the Target URL field. ## Query types Query types define what sort of metrics and dimensions are available. You need to select one of the following query types when pulling data: - **Overview**: Pull overview metrics from Backlink profile, Organic search and Paid search. - **Backlinks**: Understand specific referring pages yielding high and/or low traffic and their overall domain rating - **Referring domains**: Shows website domains for which target URL is referring - **Organic keywords**: Shows the organic keywords for which the target URL ranks for - **Top pages**: Shows which pages of the target URL get the most organic search traffic - **Paid pages**: Shows which pages of the target URL get the most paid search traffic - **Keyword explorer: Overview**: Get relevant keyword ideas with search volume, keyword difficulty, and other advanced metrics ## Connection instructions When connecting to Ahrefs, you need to log in to Ahrefs and select the target URL when prompted. 1. Select the Ahrefs data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination. 2. If prompted, choose to make this connection [shared or private](https://docs.supermetrics.com/docs/about-shared-and-private-connections). 3. Click **Start**. 4. Enter your credentials and click **Log in**. 5. In your data destination, select the query type and add the target URL. See detailed instructions on [how to connect to a data source from the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-connect-to-data-sources-from-supermetrics-hub). > [!NOTE] > Ahrefs connections have a maximum lifetime of one year. This means that the connection will expire after a year and you will need to log in again. You can also connect to Ahrefs from these destinations: - Google Sheets: [How to connect to a Supermetrics data source in Google Sheets](https://docs.supermetrics.com/docs/how-to-connect-to-a-supermetrics-data-source-in-google-sheets) - Data Studio: [How to connect data sources to Data Studio](/v1/docs/how-to-connect-data-sources-to-data-studio) - Excel: [How to connect data sources to Excel with Supermetrics](https://docs.supermetrics.com/docs/how-to-connect-data-sources-to-excel-with-supermetrics) - Power BI: [How to create your first Supermetrics query for Power BI](https://docs.supermetrics.com/docs/how-to-create-your-first-supermetrics-query-for-power-bi) - The Supermetrics API: [How to use the Query Manager](https://docs.supermetrics.com/docs/how-to-use-the-query-manager) - Data warehouse and cloud storage (Hub): [How to create a transfer](https://docs.supermetrics.com/docs/how-to-create-a-transfer) - BigQuery (marketplace): [How to create a BigQuery (marketplace) transfer](https://docs.supermetrics.com/v1/docs/how-to-create-a-bigquery-marketplace-transfer) ## More resources - [Ahrefs report building guide](/v1/docs/ahrefs-report-building-guide) - [How to reauthenticate a data source in Google Sheets, Data Studio, Excel, or Power BI](https://docs.supermetrics.com/docs/how-to-reauthenticate-a-data-source-connection-in-google-sheets-looker-studio-excel-power-bi-and-supermetrics-hub) - [How to reauthenticate a data source in data warehouse, API, or cloud storage platform](https://docs.supermetrics.com/docs/how-to-reauthenticate-a-data-source-connection-in-data-warehouse-destinations-or-the-supermetrics-api) - [How to manage data source connections on the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-manage-data-source-connections-on-supermetrics-hub)