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"
      ]
    }
  ]
}
Example: "Domain Rating" in October, compared to September.

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_rating
  • 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.

    ahrefs:ahrefs_rank
  • URL 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_rating
  • Backlinks

    Number of live links from other websites pointing to the site at the end of the analyzed period.

    ahrefs:backlinks
  • Backlinks of all time

    Number of links Ahrefs has ever found pointing to the site, including those no longer live.

    ahrefs:backlinks_all_time
  • Referring domains

    Number of unique domains with at least one live link to the site at the end of the analyzed period.

    ahrefs:referring_domains
  • Referring domains of all time

    Number of unique domains that have ever linked to the site, including those no longer linking.

    ahrefs:referring_domains_all_time
  • Organic traffic

    Ahrefs' estimate of the monthly visits the site receives from organic search at the end of the analyzed period.

    ahrefs:organic_traffic
  • Organic 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_value
  • Organic keywords

    Number of keywords the site ranks for in Google's first 100 organic results at the end of the analyzed period.

    ahrefs:organic_keywords
  • Organic 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_3
  • Organic 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_10
  • Organic 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_20
  • Organic 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_50
  • Organic 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_plus
  • Ranking 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_pages
  • Total 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_volume
  • Paid traffic

    Ahrefs' estimate of the monthly visits the site receives from paid search at the end of the analyzed period.

    ahrefs:paid_traffic
  • Paid traffic cost

    Estimated monthly cost of the site's paid search traffic at the end of the analyzed period.

    ahrefs:paid_traffic_cost
  • Paid keywords

    Number of keywords the site bids on in paid search results at the end of the analyzed period.

    ahrefs:paid_keywords
  • Paid pages

    Number of pages of the site appearing in paid search results at the end of the analyzed period.

    ahrefs:paid_pages
  • AI 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_citations
  • Pages 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_pages
  • Tracked keywords

    Number of keywords tracked in the Ahrefs project.

    ahrefs:tracked_keywords
  • Average 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_position
  • Tracked keywords in the top 3

    Number of tracked keywords for which the site ranks among the first three organic results.

    ahrefs:tracked_top_3
  • Tracked keywords in positions 4-10

    Number of tracked keywords ranking between the fourth and the tenth organic result.

    ahrefs:tracked_pos_4_10
  • Tracked keywords in positions 11-20

    Number of tracked keywords ranking between the eleventh and the twentieth organic result.

    ahrefs:tracked_pos_11_20
  • Tracked keywords in positions 21-50

    Number of tracked keywords ranking between the twenty-first and the fiftieth organic result.

    ahrefs:tracked_pos_21_50
  • Tracked keywords in position 51 or lower

    Number of tracked keywords ranking from the fifty-first organic result onwards.

    ahrefs:tracked_pos_51_plus
  • Tracked keywords not ranking

    Number of tracked keywords for which the site does not appear in the results at all.

    ahrefs:tracked_not_ranking
  • Share of voice

    Share of the organic traffic of every tracked keyword that goes to the site rather than to a competitor.

    ahrefs:share_of_voice
  • Share 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_value
  • Traffic from tracked keywords

    Estimated monthly visits the site receives from the tracked keywords.

    ahrefs:tracked_traffic
  • Value of traffic from tracked keywords

    Estimated value of the monthly traffic the site receives from the tracked keywords.

    ahrefs:tracked_traffic_value
  • Featured snippets

    Number of tracked keywords for which the site holds the featured snippet.

    ahrefs:featured_snippets
  • AI 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_time
  • URL Rating over time

    How the strength of the target URL's backlink profile moved across the analyzed period.

    ahrefs:url_rating_over_time
  • Referring domains over time

    How many domains linked to the site on each day of the analyzed period.

    ahrefs:referring_domains_over_time
  • Organic traffic over time

    How the estimated organic traffic of the site moved across the analyzed period.

    ahrefs:organic_traffic_over_time
  • Organic traffic value over time

    How the estimated value of the site's organic traffic moved across the analyzed period.

    ahrefs:organic_traffic_value_over_time
  • Ranking 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_time
  • Total 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_time
  • Paid traffic over time

    How the estimated paid search traffic of the site moved across the analyzed period.

    ahrefs:paid_traffic_over_time
  • Paid 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_time
  • Keywords 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_time
  • Ranking distribution over time

    How the keywords the site ranks for are spread across the position ranges, day by day.

    ahrefs:rankings_over_time
  • Distribution 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_distribution
  • Distribution of tracked keywords by position

    How the keywords tracked in the Ahrefs project are spread across the position ranges.

    ahrefs:tracked_position_distribution
  • Pages by traffic range

    How the ranking pages of the site are spread across bands of monthly organic traffic.

    ahrefs:pages_by_traffic_range
  • AI citations by platform

    Which AI assistants cite the site, and how often each of them does.

    ahrefs:ai_citations_by_platform
  • Tracked 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_country
  • Pages with the most organic traffic

    Pages of the site that earn the most organic traffic, with the keyword that drives each one.

    ahrefs:top_pages
  • Page details

    Traffic, estimated value and backlink strength of the pages that earn the most organic traffic.

    ahrefs:top_pages_detailed
  • Pages 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_table
  • Keywords 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_table
  • Keyword 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_difficulty
  • Tracked keyword rankings

    Position, search volume and ranking URL of each keyword tracked in the Ahrefs project.

    ahrefs:tracked_keywords_table
  • Tracked keyword details

    Position, traffic, difficulty and tracking location of each keyword tracked in the Ahrefs project.

    ahrefs:tracked_keywords_detailed
  • Competitors in the tracked keywords

    How the competitors configured in the Ahrefs project perform against the same tracked keywords.

    ahrefs:competitors
  • Top referring domains

    Domains linking to the site, with their own authority and the links gained or lost during the analyzed period.

    ahrefs:referring_domains_table
  • Referring domain details

    Authority of each referring domain, how many of its links pass authority, and when the first one was found.

    ahrefs:referring_domains_detailed
  • Anchor 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.