# Integrate Ahrefs with Databox

Ahrefs is a comprehensive SEO and marketing analytics platform designed to help you improve your website's search visibility and performance. It provides in-depth data on backlinks, keywords, and organic rankings, along with competitive analysis tools to identify opportunities and monitor progress. By using Ahrefs, marketers and SEO professionals can make data-driven decisions to increase traffic and strengthen their online presence.

## Connection

### Before you begin

### Step 1: Enter connection details

To connect Ahrefs to your Databox account for the [first time](/add-a-connection), enter the following parameters to define how Databox will pull data from Ahrefs:

1. **Target domain** — Enter the domain or URL you want to analyze.
*Examples: `www.example.com` or `example.com`.*
2. **Mode** — Specify the mode of operation. Available options are:
  - `exact` — For an exact match of the entered URL.
  - `domain` — For the entire domain, excluding subdomains.
  - `subdomains` — For the domain and all its subdomains.
  - `prefix` — For all URLs starting with the specified prefix.
3. **Data limit** — Define how many items (e.g., pages, keywords, backlinks, domains, anchors, or countries) Databox should fetch per metric.
  - Acceptable range: **3–100**
  - Default value: **50**


connection
Since Ahrefs API usage is limited by monthly API units, setting a lower data limit helps manage your usage efficiently.

### Step 2: Sign in to Ahrefs

After entering all parameters, **click Connect**. You'll be redirected to **sign in to your Ahrefs account** and authorize Databox to access your data.

connection
Once authorization is complete, the connection will be established, and your Ahrefs data will be available in Databox.

## Metric Builder

The Ahrefs integration allows you to create custom metrics using the metric builder, ideal for visualizing data not included in the basic metrics offered by the integration.

connection
To create a custom metric, start by selecting a metric from the "Metric" selector. Next, customize your metric by optionally adding a dimension and applying one or more filters.

There are several entities available for custom metric creation: Backlinks, Keywords explorer, Organic keywords, SERP overview, Top pages, Paid pages,and Rank Tracker.

### Backlinks

Analyze backlink data for your target domain or URL, including Ahrefs Rank, Domain Rating, Referring Domains, Traffic, and Link Type. You can further break down metrics by dimensions such as Anchor, Alt Text, Link Type (text, image, redirect, etc.), or Drop Reason to identify lost or broken links.

 **In Ahrefs:** Go to the **Site Explorer → Backlinks** section.

### Keywords explorer

Explore detailed keyword metrics such as Search Volume, Keyword Difficulty, CPC, Clicks, Click Rate (organic or paid), and Traffic Potential. Use dimensions like Keyword, Parent Topic, or SERP Features (e.g., snippet, image, video) to segment data by keyword type or intent.

 **In Ahrefs:** Go to the **Keywords Explorer** tool.

### Organic keywords

View the organic keywords your domain or URL ranks for, including metrics like Keyword Difficulty, Search Volume, Traffic, Best Position, and SERP Features Count. You can analyze positions by Keyword, Language, or Position Kind (e.g., snippet, paid top, organic).

 **In Ahrefs:** Go to the **Site Explorer → Organic Keywords** section.

### SERP overview

Review how pages rank in SERPs for specific keywords. Access metrics such as Ahrefs Rank, Position, Domain Rating, Traffic, and Referring Domains. Dimensions like Title, Top Keyword, and URL help you identify high-performing competitors or ranking opportunities.

 **In Ahrefs:** Go to the **Keywords Explorer → SERP Overview** section.

### Top pages

Identify which pages generate the most organic traffic. Available metrics include Sum Traffic, Top Keyword Volume, Top Keyword Best Position, Value, and Keywords Count. Dimensions such as URL, Top Keyword, and Country provide insights into top-performing pages across regions.

 **In Ahrefs:** Go to the **Site Explorer → Top Pages** section.

### Paid pages

Analyze paid search performance, including Ads Count, Sum Traffic, Top Keyword Best Position, Top Keyword Volume, and Value. Segment your data by Keyword, Country, or Ad Type to understand paid campaign results.

 **In Ahrefs:** Go to the **Site Explorer → Paid Pages** section.

### Rank Tracker

Monitor tracked keywords and ranking progress over time. Access metrics such as Position, Search Volume, Clicks, Traffic, CPC, and Clicks Per Search (CPS). Use dimensions like Keyword, Country, or URL to evaluate performance by region or page.

 **In Ahrefs:** Go to the **Rank Tracker** tool.

## Resources

For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below.

You can track your Ahrefs API credit consumption directly in Ahrefs by visiting the [Limits & usage](https://app.ahrefs.com/account/limits-and-usage/web) page, or in Databox using dedicated API usage metrics.

Available metrics include:

- **Time to API usage reset** — shows when your API usage will reset.
- **Time to API key expiration** — displays when your current key will expire.
- **Workspace API limit** — indicates the total number of API units available in your workspace.
- **Workspace API usage** — tracks how many units have been used so far.
- **API key usage** — monitors usage specific to the connected API key.


These metrics help ensure you stay within your monthly API allocation and manage your data requests efficiently.

 

Ask Genie
Get instant answers or help with your data using the in-app AI assistant.

Talk to an expert
For customers: Get help with your setup, strategy, or making the most of Databox.

Book a demo
New to Databox? See how it works and get guidance on getting started.

Send an email
Reach out to support for help with your account, data, or technical issues.