Ahrefs report types and quota limitations

This guide covers Ahrefs report types and quota limitations.

Ahrefs API quota limitations


  • Each query done with Supermetrics’ Ahrefs connector consumes the API quota of the connected Ahrefs account.
  • Ahrefs accounts have a monthly quota which defines how much data can be fetched through integrations using Ahrefs API. Size of the monthly quota is presented as Integrations rows, and it is tied to the Ahrefs plan user is currently having.
  • You can check your available quota and usage on Account settings under Limits & usage -page. Look for a row called Integration rows.
  • Integration row consumption does not always exactly correlate with the amount of rows you fetch with our connector, as some report types charge, for example, 5 rows per request + 1 row fetched row. Below you can find a list of report types available in our connector, and a link to Ahrefs API documentation explaining the pricing structure of the report type in question. You can also find more info about API pricing from Ahrefs support site.



Ahrefs report types


Below you can find a list of different report types available in Supermetrics Ahrefs connector. You can also find links to the Ahrefs documentation page, where you can check the amount of Integration rows consumed with that report type. 


SITE OVERVIEW

Report type


Description


Documentation of API endpoint used


Domain rating


Fetches domain rating and Ahrefs rank of the target URL defined in the query


https://ahrefs.com/api/documentation/domain-rating 


URL rating


Fetches URL rating for different URLs related to the target URL defined in the query


https://ahrefs.com/api/documentation/ahrefs-rank 


Site metrics


Contains metrics about the target, such as total number of backlinks, referring pages, etc., that are similar to the Site Explorer Overview page with the addition of stats for total number of HTML pages, internal and external links.


Costs 1 integration row per overall request, no matter how many metrics requested.


https://ahrefs.com/api/documentation/metrics 


Site metrics - extended


Similar as Site metrics report type, but with some additional metrics, such as total number of referring domains, referring class C networks and referring IP addresses.


Costs 1 integration row per requested metric + 1 row per overall request.


https://ahrefs.com/api/documentation/metrics-extended 


Organic search metrics


Contains the estimation of number of keywords, traffic and cost of the target URL.


Reflects Organic keywords, Organic traffic and Traffic value metrics on the Site Explorer Overview page.


https://ahrefs.com/api/documentation/positions-metrics 



BACKLINKS PROFILE

Report type


Description


Documentation of API endpoint used


Backlinks


Returns a list of backlinks and details of the referring pages, such as domain and url ratings, Ahrefs rank, anchor and page title.


Note: ranks and ratings are related to each specific backlink, and not to your target URL defined in the query options.


https://ahrefs.com/api/documentation/backlinks


Backlinks extended


Similar as Backlinks report type, but with additional metrics such as Referring domain count and Linked domain count.


Note: this report type fetches data from multiple API endpoints, which means that 1 returned row will cost more than 1 integration row. 

Multiple endpoints


Backlinks - new & lost


Returns a list of backlinks that you have gained or lost.


Note: A date range cannot be defined, but the app returns all new and all lost backlinks starting from the newest towards oldest until the query row limit is reached.


https://ahrefs.com/api/documentation/backlinks-new-lost 


Backlinks - new & lost count


Returns an amount of new and lost backlinks, which you can split by date or by target URL, and you can order the results based on date or by the amount of new or lost domains.


Note: A date range cannot be defined, but all data is returned based on your ordering until the query row limit is reached.


https://ahrefs.com/api/documentation/backlinks-new-lost-counters 


Backlinks - one per domain


Returns a list of backlinks and details of the referring pages, but limiting results to one backlink per referring domain. The backlink with the highest Ahrefs rank in that domain is returned. 


https://ahrefs.com/api/documentation/backlinks-one-per-domain 


Backlinks - broken


Returns a list of broken backlinks and details of the referring pages, such as anchor and page title.


Note: A date range cannot be defined, but the app returns broken backlinks starting from newest to oldest until row limitation is reached.


https://ahrefs.com/api/documentation/broken-backlinks 


Anchors (backlinks)


Returns the anchor text and the number of backlinks, referring pages and referring domains that have it.


https://ahrefs.com/api/documentation/anchors


Referring domains


Returns referring domains that have backlinks to the target URL.


https://ahrefs.com/api/documentation/refdomains


Referring domains by type


Returns a list of referring domains that have backlinks to the target URL and key metrics for each referring domain. This report type also allows users to configure which type of domains they want to get returned (ie. Gov or Education domains).


https://ahrefs.com/api/documentation/refdomains-by-type 


Referring domains - new & lost


Returns a list of referring domains that you have gained or lost.


Note: A date range cannot be defined, but you can order based on date of event or domain rating, and the app returns all new and all lost referring domains until the query row limitation has been reached. 


https://ahrefs.com/api/documentation/refdomains-new-lost 


Referring domains - new & lost count


Returns an amount of new and lost referring domains, which you can split by date or by target URL, and you can order the results based on date or by the amount of new or lost domains.


Note: A date range cannot be defined, but all data is returned based on your ordering until the query row limit is reached.




OUTGOING LINKS

Report type


Description


Documentation of API endpoint used


Linked domains


Returns a list of external domains the target URL has links to, as well as metrics (domain rating, Ahrefs rank and amount of links from target domain) for these external domains. 


https://ahrefs.com/api/documentation/linked-domains 


Linked domains by type


Similar as Linked domains report type, but contains additional metrics which allows you to drill into link types.


https://ahrefs.com/api/documentation/linked-domains-by-type 


Anchors (outgoing links)


Returns a list of anchors appearing in outgoing links, and the number of links that anchor has.


https://ahrefs.com/api/documentation/linked-anchors 


Broken links


Returns a list of broken links on target URL and details of the referring page, such as anchor text and page title.


https://ahrefs.com/api/documentation/broken-links 



PAGES 

Report type


Description


Documentation of API endpoint used


Pages


Returns the crawled pages in target URL. The result is similar to the crawled pages report found in the raw data export in Ahrefs Site Explorer.


https://ahrefs.com/api/documentation/pages 


Pages extended


Similar to Pages report, but returns additional metrics such as the amount of referring domains, amount of different backlinks by type, etc.


https://ahrefs.com/api/documentation/pages-extended 


Pages info


Similar to Pages report, but contains additional info about page content, such as meta data, subheadings, word count, etc.


https://ahrefs.com/api/documentation/pages-info 



OTHER 

Report type


Description


Documentation of API endpoint used


Subscription info


Returns user subscription information such as Integration row limitation and the amount of rows left.


https://ahrefs.com/api/documentation/subscription-info 



To authenticate the Ahrefs data source, please refer to this guide.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.