New260+ blocks and 240+ tools are now fully documented
DocumentationReferenceTool IntegrationsAnalytics & Monitoring
Tool

Ahrefs

Retrieve SEO metrics, backlinks, and keyword rankings from Ahrefs Site Explorer

Pull domain authority scores, backlink profiles, organic keyword rankings, and top-traffic pages directly from Ahrefs Site Explorer. Use this integration when you need programmatic SEO data inside an automated workflow — competitor analysis, link-building research, content audits, and rank-tracking pipelines.

Overview

PropertyValue
Typeahrefs
CategoryTool — SEO / Web Analytics
AuthAPI Key (Bearer token)

Operations

OperationTool IDDescription
Domain Ratingahrefs_domain_ratingGet the Domain Rating (0–100) and global Ahrefs Rank for a target domain
Backlinksahrefs_backlinksList backlinks pointing to a target domain or URL with anchor text, DR, and dofollow status
Organic Keywordsahrefs_organic_keywordsList keywords a domain or URL ranks for in Google, including volume, position, and difficulty
Top Pagesahrefs_top_pagesList the highest-traffic pages on a domain sorted by estimated organic traffic
Referring Domainsahrefs_referring_domainsList unique domains that link to a target with their DR and backlink counts

Configuration

SettingTypeRequiredDescription
apiKeystring (secret)YesAhrefs API key. Passed as a Bearer token. Store as {{AHREFS_API_KEY}}.
targetstringYesDomain or URL to analyze. Examples: example.com or https://example.com/page.
modestringNoScope of analysis: domain (full domain), subdomains (all subdomains), prefix (URL prefix), exact (exact URL). Defaults to domain. Not used by Domain Rating.
datestringNoHistorical snapshot date in YYYY-MM-DD format. Defaults to today.
limitnumberNoMaximum number of rows to return. Default: 100. Not used by Domain Rating.
offsetnumberNoNumber of rows to skip for pagination. Not used by Domain Rating.
countrystringNoTwo-letter country code for search-locale data (e.g. us, gb, de). Default: us. Used by Organic Keywords and Top Pages only.
selectstringNoComma-separated list of fields to return. Default: url,traffic,keywords,top_keyword,value. Used by Top Pages only.

Outputs

Domain Rating (ahrefs_domain_rating)

FieldTypeDescription
domainRatingnumberDomain Rating score on a scale of 0–100
ahrefsRanknumberGlobal Ahrefs Rank based on backlink profile strength (lower = stronger)
FieldTypeDescription
backlinksarrayList of backlink objects (see sub-fields below)
backlinks[].urlFromstringURL of the page containing the backlink
backlinks[].urlTostringURL being linked to
backlinks[].anchorstringAnchor text of the link
backlinks[].domainRatingSourcenumberDomain Rating of the linking domain
backlinks[].isDofollowbooleanWhether the link passes link equity (dofollow)
backlinks[].firstSeenstringISO date when the backlink was first discovered
backlinks[].lastVisitedstringISO date when the backlink was last crawled

Organic Keywords (ahrefs_organic_keywords)

FieldTypeDescription
keywordsarrayList of keyword objects (see sub-fields below)
keywords[].keywordstringThe keyword text
keywords[].volumenumberEstimated monthly search volume
keywords[].positionnumberCurrent ranking position in Google
keywords[].urlstringThe page that ranks for the keyword
keywords[].trafficnumberEstimated monthly organic traffic from this keyword
keywords[].keywordDifficultynumberKeyword difficulty score (0–100)

Top Pages (ahrefs_top_pages)

FieldTypeDescription
pagesarrayList of top-page objects (see sub-fields below)
pages[].urlstringPage URL
pages[].trafficnumberEstimated monthly organic traffic
pages[].keywordsnumberNumber of keywords the page ranks for
pages[].topKeywordstringPrimary keyword driving traffic to this page
pages[].valuenumberEstimated traffic value in USD

Referring Domains (ahrefs_referring_domains)

FieldTypeDescription
referringDomainsarrayList of referring domain objects (see sub-fields below)
referringDomains[].domainstringThe referring domain
referringDomains[].domainRatingnumberDomain Rating of the referring domain
referringDomains[].backlinksnumberTotal backlinks from this domain
referringDomains[].dofollowBacklinksnumberNumber of dofollow backlinks from this domain
referringDomains[].firstSeenstringISO date when this domain was first seen linking
referringDomains[].lastVisitedstringISO date when this domain was last checked

Example

[Starter] → [Ahrefs: Domain Rating] → [Ahrefs: Referring Domains] → [Agent: Analyze link-building opportunities]

Set {{starter.domain}} as the target for both blocks, and pass your key as {{AHREFS_API_KEY}}. The Domain Rating block returns a DR score and global rank for a quick authority snapshot; the Referring Domains block then retrieves every unique linking domain with its own DR. Feed both outputs to an Agent block to identify high-DR sites worth pursuing for outreach, or flag newly discovered low-DR links for disavowal review.

Tips

  • Domain Rating is the fastest check — use it as a qualifying step before running the heavier Backlinks or Referring Domains calls to avoid burning API credits on low-authority targets.
  • mode controls scopedomain covers all pages, exact targets a single URL. For content-level analysis (which blog post earns the most links?) use exact or prefix; for site-wide authority checks use domain.
  • Paginate large datasets with limit and offset inside a Loop block. Ahrefs returns up to 1,000 rows per call; use offset increments equal to limit until the returned array length is less than limit.
  • Historical snapshots — pass a date in YYYY-MM-DD format to compare link profiles or keyword rankings over time. Omit date to always fetch the most current data.