Metrics
Ahrefs metrics via API
Your customer connects their Ahrefs account and your product queries 65 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "ahrefs:domain_rating",
"component": "number_v1",
"metrics": [
"domain_rating"
]
}
]
}More Ahrefs request examples
The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).
Chart
Domain Rating over time
How the strength of the site's backlink profile moved across the analyzed period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "ahrefs:domain_rating_over_time",
"component": "chart_v1",
"metrics": [
"domain_rating"
],
"dimensions": [
"date"
]
}
]
}Table
Organic performance by country
Countries where the site earns organic traffic, with the keywords it ranks for in each one.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "ahrefs:traffic_by_country",
"component": "datatable_v1",
"metrics": [
"organic_traffic",
"organic_keywords",
"organic_traffic_value"
],
"dimensions": [
"country"
]
}
]
}Number
Ahrefs Rank
Position of the site among all domains in Ahrefs' index at the end of the analyzed period, ordered by backlink profile strength. Rank #1 is the strongest, so a smaller number is better.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "ahrefs:ahrefs_rank",
"component": "number_v1",
"metrics": [
"ahrefs_rank"
]
}
]
}Numbers
37 metrics
Domain Rating
Strength of the site's backlink profile at the end of the analyzed period, compared with every other site in Ahrefs' index on a 100-point logarithmic scale.
ahrefs:domain_ratingAhrefs Rank
Position of the site among all domains in Ahrefs' index at the end of the analyzed period, ordered by backlink profile strength. Rank #1 is the strongest, so a smaller number is better.
ahrefs:ahrefs_rankURL Rating
Strength of the backlink profile of the target's exact URL at the end of the analyzed period, on a 100-point logarithmic scale.
ahrefs:url_ratingBacklinks
Number of live links from other websites pointing to the site at the end of the analyzed period.
ahrefs:backlinksBacklinks of all time
Number of links Ahrefs has ever found pointing to the site, including those no longer live.
ahrefs:backlinks_all_timeReferring domains
Number of unique domains with at least one live link to the site at the end of the analyzed period.
ahrefs:referring_domainsReferring domains of all time
Number of unique domains that have ever linked to the site, including those no longer linking.
ahrefs:referring_domains_all_timeOrganic traffic
Ahrefs' estimate of the monthly visits the site receives from organic search at the end of the analyzed period.
ahrefs:organic_trafficOrganic traffic value
Estimated cost of buying, through paid search, the traffic the site earns organically at the end of the analyzed period.
ahrefs:organic_traffic_valueOrganic keywords
Number of keywords the site ranks for in Google's first 100 organic results at the end of the analyzed period.
ahrefs:organic_keywordsOrganic keywords in the top 3
Number of keywords the site ranks for among Google's first three organic results at the end of the analyzed period.
ahrefs:organic_keywords_top_3Organic keywords in positions 4-10
Number of keywords the site ranks for between the fourth and the tenth organic result at the end of the analyzed period.
ahrefs:organic_keywords_top_4_10Organic keywords in positions 11-20
Number of keywords the site ranks for between the eleventh and the twentieth organic result at the end of the analyzed period.
ahrefs:organic_keywords_top_11_20Organic keywords in positions 21-50
Number of keywords the site ranks for between the twenty-first and the fiftieth organic result at the end of the analyzed period.
ahrefs:organic_keywords_top_21_50Organic keywords in position 51 or lower
Number of keywords the site ranks for from the fifty-first organic result onwards at the end of the analyzed period.
ahrefs:organic_keywords_top_51_plusRanking pages
Number of pages of the site that rank in Google's first 100 organic results at the end of the analyzed period.
ahrefs:organic_pagesTotal search volume
Sum of the monthly search volume of every keyword for which the site ranks in the top 10 organic results at the end of the analyzed period.
ahrefs:total_search_volumePaid traffic
Ahrefs' estimate of the monthly visits the site receives from paid search at the end of the analyzed period.
ahrefs:paid_trafficPaid traffic cost
Estimated monthly cost of the site's paid search traffic at the end of the analyzed period.
ahrefs:paid_traffic_costPaid keywords
Number of keywords the site bids on in paid search results at the end of the analyzed period.
ahrefs:paid_keywordsPaid pages
Number of pages of the site appearing in paid search results at the end of the analyzed period.
ahrefs:paid_pagesAI citations
Number of times pages of the site were cited in answers generated by AI assistants at the end of the analyzed period — ChatGPT, Google AI Overviews, Google AI Mode, Perplexity, Gemini, Copilot and Grok combined.
ahrefs:ai_citationsPages cited by AI
Number of distinct pages of the site cited in answers generated by AI assistants at the end of the analyzed period.
ahrefs:ai_cited_pagesTracked keywords
Number of keywords tracked in the Ahrefs project.
ahrefs:tracked_keywordsAverage position of tracked keywords
Average of the site's best organic positions across every tracked keyword. A smaller number is a better result.
ahrefs:tracked_average_positionTracked keywords in the top 3
Number of tracked keywords for which the site ranks among the first three organic results.
ahrefs:tracked_top_3Tracked keywords in positions 4-10
Number of tracked keywords ranking between the fourth and the tenth organic result.
ahrefs:tracked_pos_4_10Tracked keywords in positions 11-20
Number of tracked keywords ranking between the eleventh and the twentieth organic result.
ahrefs:tracked_pos_11_20Tracked keywords in positions 21-50
Number of tracked keywords ranking between the twenty-first and the fiftieth organic result.
ahrefs:tracked_pos_21_50Tracked keywords in position 51 or lower
Number of tracked keywords ranking from the fifty-first organic result onwards.
ahrefs:tracked_pos_51_plusTracked keywords not ranking
Number of tracked keywords for which the site does not appear in the results at all.
ahrefs:tracked_not_rankingShare of voice
Share of the organic traffic of every tracked keyword that goes to the site rather than to a competitor.
ahrefs:share_of_voiceShare of traffic value
Share of the estimated traffic value of every tracked keyword that goes to the site rather than to a competitor.
ahrefs:share_of_traffic_valueTraffic from tracked keywords
Estimated monthly visits the site receives from the tracked keywords.
ahrefs:tracked_trafficValue of traffic from tracked keywords
Estimated value of the monthly traffic the site receives from the tracked keywords.
ahrefs:tracked_traffic_valueFeatured snippets
Number of tracked keywords for which the site holds the featured snippet.
ahrefs:featured_snippetsAI Overviews
Number of tracked keywords for which the site appears in Google's AI Overview.
ahrefs:ai_overviews
Charts
16 metrics
Domain Rating over time
How the strength of the site's backlink profile moved across the analyzed period.
ahrefs:domain_rating_over_timeURL Rating over time
How the strength of the target URL's backlink profile moved across the analyzed period.
ahrefs:url_rating_over_timeReferring domains over time
How many domains linked to the site on each day of the analyzed period.
ahrefs:referring_domains_over_timeOrganic traffic over time
How the estimated organic traffic of the site moved across the analyzed period.
ahrefs:organic_traffic_over_timeOrganic traffic value over time
How the estimated value of the site's organic traffic moved across the analyzed period.
ahrefs:organic_traffic_value_over_timeRanking pages over time
How many pages of the site ranked in Google's first 100 results on each day of the analyzed period.
ahrefs:organic_pages_over_timeTotal search volume over time
How the combined search volume of the keywords the site ranks for moved across the analyzed period.
ahrefs:total_search_volume_over_timePaid traffic over time
How the estimated paid search traffic of the site moved across the analyzed period.
ahrefs:paid_traffic_over_timePaid traffic cost over time
How the estimated cost of the site's paid search traffic moved across the analyzed period.
ahrefs:paid_traffic_cost_over_timeKeywords in the top 3 over time
How many keywords the site held among Google's first three results on each day of the analyzed period.
ahrefs:organic_keywords_top_3_over_timeRanking distribution over time
How the keywords the site ranks for are spread across the position ranges, day by day.
ahrefs:rankings_over_timeDistribution of organic keywords by position
How the keywords the site ranks for are spread across Google's position ranges at the end of the analyzed period.
ahrefs:position_distributionDistribution of tracked keywords by position
How the keywords tracked in the Ahrefs project are spread across the position ranges.
ahrefs:tracked_position_distributionPages by traffic range
How the ranking pages of the site are spread across bands of monthly organic traffic.
ahrefs:pages_by_traffic_rangeAI citations by platform
Which AI assistants cite the site, and how often each of them does.
ahrefs:ai_citations_by_platformTracked keywords by SERP feature
SERP features the site occupies for its tracked keywords, such as featured snippets and AI Overviews.
ahrefs:serp_features
Tables
12 metrics
Organic performance by country
Countries where the site earns organic traffic, with the keywords it ranks for in each one.
ahrefs:traffic_by_countryPages with the most organic traffic
Pages of the site that earn the most organic traffic, with the keyword that drives each one.
ahrefs:top_pagesPage details
Traffic, estimated value and backlink strength of the pages that earn the most organic traffic.
ahrefs:top_pages_detailedPages in paid search
Pages of the site appearing in paid search results, with the traffic and the number of ads pointing at each one.
ahrefs:paid_pages_tableKeywords with the most traffic
Keywords that bring the site the most organic traffic, with the position it holds and the page that ranks.
ahrefs:organic_keywords_tableKeyword opportunities
Keywords the site ranks for, with how hard each one is to win and what a click on it costs in paid search.
ahrefs:organic_keywords_difficultyTracked keyword rankings
Position, search volume and ranking URL of each keyword tracked in the Ahrefs project.
ahrefs:tracked_keywords_tableTracked keyword details
Position, traffic, difficulty and tracking location of each keyword tracked in the Ahrefs project.
ahrefs:tracked_keywords_detailedCompetitors in the tracked keywords
How the competitors configured in the Ahrefs project perform against the same tracked keywords.
ahrefs:competitorsTop referring domains
Domains linking to the site, with their own authority and the links gained or lost during the analyzed period.
ahrefs:referring_domains_tableReferring domain details
Authority of each referring domain, how many of its links pass authority, and when the first one was found.
ahrefs:referring_domains_detailedAnchor texts
Words other sites use in the links pointing to this one.
ahrefs:anchors
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
