HOW TO
- Connect Ahrefs Enterprisd to Databox
- Use the Metric Builder for Ahrefs Enterprise
- Additional Information
How to connect Ahrefs Enterprise to Databox
IN THIS SECTION
- How to connect Ahrefs Enterprise to Databox
- What’s the maximum amount of historical data initially available when you use a new Ahrefs Enterprise Metric in Databox?
- What time zone does Ahrefs Enterprise data sync in?
- How often does Ahrefs Enterprise data sync?
How to connect Ahrefs Enterprise to Databox
To connect an Ahrefs Enterprise Account in Databox, go to Data Manager > + New connection. Type Ahrefs Enterprise in the search bar and click on the green Connect button. Next, click the green Connect now button.
This will open the Authorization window, which is where you will be prompted to enter your Ahrefs Enterprise API Key, target domain, mode and data limit and authorize the Databox app.
Pro Tip: Each Ahrefs Enterprise Account must be connected as a separate Data Source in Databox (1 Account = 1 Data Source). Learn more here.
To successfully connect your Ahrefs Enterprise Account with Databox, you will need to add your API Key, Target Domain, Mode and Data limit in the connect process.
-
API Key: To generate your API key, log in to your Ahrefs Enterprise Account. You can create an API Key under the Account settings / API keys page. Learn more about creating API key's here.
Pro Tip: Only workspace owners and admins can create and manage API keys.
- Target Domain: Enter domain or URL. Examples: "www.example.com" or "example.com".
- Mode: Enter mode of operation. Possible values: "exact", "domain", "subdomains" or "prefix".
- Data Limit: Since Ahrefs API usage is monitored and limited with the monthly API units, you can choose how many items/rows (pages, keywords, backlinks, domains, anchors, countries, etc.) you will get with each metric. Please choose a number between 3 and 100.
What's the maximum amount of historical data initially available when you use a new Ahrefs Enterprise Data Source Metric in Databox?
Pro Tip: In order to start syncing data for a Metric, you can add it to your Metrics screen, use it in a Scorecard, set a Goal around it, create an Alert for it, or add it to a Databoard. Learn more here.
The amount of historical data you're able to access in Databox is dependent on your Databox plan. Learn more here.
What time zone does Ahrefs Enterprise data sync in?
Ahrefs Enterprise data is synced in the UTC time zone.
How often does Ahrefs Enterprise data sync?
All Ahrefs Enterprise Data Sources will sync every hour with Databox.
How to use the Metric Builder for Ahrefs Enterprise
With the Metric Builder for Ahrefs Enterprise, you can create Custom Metrics using a combination of Metrics, Dimensions, and Filters. The Metric Builders for Ahrefs Enterprise allow you to create Custom Metrics based on Backlinks, Keywords explorer, Organic explorer, SERP overview, Top pages or Paid pages related data.
Learn more about the Metric Builder for Ahrefs Enterprise here.
Metric Considerations
As of April 2025, due to architectural and product changes, some dimensional metrics have been restructured and are now available as dimensions within a new placeholder metric. The list of affected metrics is provided below.
| Old Metric Name | New Metric | New Dimension (Breakdown by) |
| Pages Breakdown | Range Breakdown (Pages & Traffic) | Pages Breakdown |
| Traffic Breakdown | Range Breakdown (Pages & Traffic) | Traffic Breakdown |
Since Ahrefs API usage is monitored and limited with the monthly API units, you can choose how many items/rows (pages, keywords, backlinks, domains, anchors, countries, etc.) you will get with each metric.
We have introduced the Data limit setting that can be set during the connection. This way you will have more control over how much of the API credits will each sync use. You can choose between 3 and 100 (items/rows). This applies to all basic metrics.
Your credit usage can be monitored in Ahrefs by checking the Limits & usage page, or Databox, using metrics like:
- Time to API usage reset
- Time to API key expiration
- Workspace API limit
- Workspace API usage
- API key usage.