Ahrefs
The AgencyAnalytics Ahrefs integration combines backlink data with keyword performance and organic traffic stats. This gives your clients the tools they need to boost their search rankings.
Track Site Explorer data, including organic keywords, Domain and URL strength, backlinks, referring domains, and anchors
Monitor Rank Tracker data for target keyword positions, movement, search volume, and estimated traffic
Review Site Audit data, including your overall crawl health score and page errors or warnings
Research saved keyword lists in Keyword Explorer, including search volume, ranking difficulty, and cost-per-click
See how often your brand appears in AI answers (like ChatGPT and Google AI Overviews) with Brand Radar
Before You Start
To avoid a failed connection or error when connecting Ahrefs to a client, the person connecting must have:
A subscription to a paid Ahrefs plan with API access and API credits (with Ahrefs' V3 API, only Ahrefs' Enterprise plans include API credits)
An Ahrefs email and password
A few other things to know before you connect:
Data syncs every 12 hours
Historical data is not available. Values from before the connection date will back-fill with the data from the date of connection
Available data sections include Site Explorer, Keyword Explorer (requires a Keyword List ID and results in Ahrefs credit usage), AI Visibility (requires a Brand Radar Report ID), Rank Tracker, Site Audit, and Backlinks
Connect Ahrefs
Once you meet the requirements above, follow these steps to connect Ahrefs to a client:
Step 1: Open the client where you'd like to connect Ahrefs, then click the Data Sources tab at the top.
Step 2: Click the blue Connect Data Source button in the upper right corner of the page.
Step 3: Search for Ahrefs in the search bar at the top, then click the Ahrefs card.
Step 4: Click the Authorize button to launch the OAuth window, then follow the prompts to verify and finalize the connection.
After you accept the pop-up prompts, your Ahrefs account is connected. You can now start adding Ahrefs data to your dashboards and reports.
Once Ahrefs is connected, you can add Ahrefs data to any dashboard or report for that client. To pull Keyword Explorer and AI Visibility data specifically, you'll need to update your Ahrefs data source settings first, since these sections require extra configuration.
Set Up Keyword Explorer and AI Visibility
Most Ahrefs sections work as soon as you connect. Site Explorer, Backlinks, Referring Domains, Anchors, Ranking, and Site Audit all automatically find your Ahrefs project.
Two sections need a one-time setup. Keyword Explorer needs a Keyword List ID, and AI Visibility needs a Report ID. Each one is optional, so you can turn them on one at a time. Note: Pulling Keyword Explorer data uses credits on the Ahrefs native platform side.
Step 1: Open the Client and click Integrations on the left sidebar.
Step 2: Click your Ahrefs connection to open its settings.
Step 3: In the Keyword Lists box, add one keyword list per line. Enter the list's ID from Ahrefs, a colon, then a name you'll recognize.
1509936:Core service terms
Step 4: In the AI Visibility Report box, add one report per line. Enter the report's ID from Ahrefs, a colon, then a friendly name.
019e84b2-2248-7634-abc9-596e99f4480b:AI visibility
Step 5: Set your Maximum Items Per Request, then click Save.
đĄ If you don't add these IDs, the section stays empty rather than showing data for the wrong account.
FAQ
How does the Ahrefs integration know which site to pull data for?
We use the Client's URL. Your Ahrefs project, including Rank Tracker and Site Audit, is automatically matched.
Why do Keyword Explorer and AI Visibility need IDs when nothing else does?
We don't have access to Ahrefs' Management API. That means we can't see your saved keyword lists or AI Visibility (Brand Radar) reports on our own. Adding the IDs tells us which ones to pull.
Why is my Keyword Explorer or AI Visibility section empty?
These two sections only show data once you've added an ID in your Ahrefs connection settings. See the setup steps above.
Why is my Rank Tracker or Site Audit section empty?
Both pull from your Ahrefs account, so they need something to pull. Check that you have a Rank Tracker project in Ahrefs and that a Site Audit crawl has run. If neither exists in Ahrefs, the sections stay empty.
Where did my Backlinks and Referring Domains sections go?
They're now grouped under Site Explorer, along with Anchors. Each was rebuilt as a single page with all of its tables together. Nothing was removed; it just moved.
Why doesn't my average position match Ahrefs?
Average Position in Rank Tracker leaves out keywords that aren't currently ranking. If your Ahrefs number includes unranked keywords, the two won't match.
Can I track rankings past position 100?
No. Rank Tracker tracks positions down to the top 100. You can also filter by device, either desktop or mobile.
How far back do new and lost links go?
New and lost backlinks and referring domains cover the last 30 days.
How do I know if I have Ahrefs API credits available on my plan?
Different Ahrefs plans include different credit amounts. Check your Ahrefs account to verify your API access and credits. You can view credit and unit usage in Ahrefs > Account Settings > Limits and Usage.
Why am I using more Ahrefs API credits than before?
Ahrefs moved its API from v2 to v3, which changed how credits are counted. Every request now has a minimum charge of 50 credits, even requests that used to cost under 10. Ahrefs also reduced the total number of credits included in each plan tier. That means you may hit your limit sooner, even if nothing about your usage changed.
We can't say exactly how many credits you'll use, since it depends on how much data you pull. To help, we cache your Ahrefs data for 12 hours per Client. View the same data with the same settings, and no extra credits are used. But each time you change a date range, filter, sort order, or page in an Ahrefs widget, that's a new API call, and credits are charged again.
To keep usage down, try not to adjust filters or date ranges more than necessary.
Does pulling Keyword Explorer data use credits?
Yes. Keyword Explorer data is pulled from Ahrefs, so it uses credits on your Ahrefs account.
What does "Maximum Items Per Request" refer to?
It's the number of results each API call returns. You can request more results, but each call then costs more credits.
What does the Protocol setting refer to?
Protocol refers to HTTP and HTTPS. We recommend setting it to Both so any website is compatible.
Can I see Ahrefs data from before I connected the integration?
No. We back-fill earlier dates with the same values shown on the day you connected.
How often does Ahrefs data update?
Every 12 hours. If something changes in Ahrefs between syncs, it won't appear in AgencyAnalytics until the next sync runs.
â What to Check Out Next
Get your Ahrefs data client-ready by building a report
Make your data match Ahrefs by configuring your URL scope
Automate delivery by setting a report schedule
đŹ Need additional help?
If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help đ
