Ahrefs

Ahrefs is a leading SEO toolset for analyzing websites, tracking rankings, monitoring backlinks, and researching keywords. It provides detailed insights into your own website as well as your competitors, helping you make data-driven decisions to improve your search visibility.

With the Ahrefs integration in AACFlow.io, you can:

Analyze Domain Rating & Authority: Instantly check the Domain Rating (DR) and Ahrefs Rank of any website to gauge its authority.
Fetch Backlinks: Retrieve a list of backlinks pointing to a site or specific URL, with details like anchor text, referring page DR, and more.
Get Backlink Statistics: Access metrics on backlink types (dofollow, nofollow, text, image, redirect, etc.) for a domain or URL.
Explore Organic Keywords (planned): View keywords a domain ranks for and their positions in Google search results.
Discover Top Pages (planned): Identify the highest-performing pages by organic traffic and links.

These tools let your agents automate SEO research, monitor competitors, and generate reports—all as part of your workflow automations. To use the Ahrefs integration, you’ll need an Ahrefs Enterprise subscription with API access.

Usage Instructions

Integrate Ahrefs SEO tools into your workflow. Analyze domain ratings, backlinks, organic keywords, top pages, and more. Requires an Ahrefs Enterprise plan with API access.

Actions

`ahrefs_domain_rating`

Get the Domain Rating (DR) and Ahrefs Rank for a target domain. Domain Rating shows the strength of a website's backlink profile on a scale from 0 to 100.

Input

Parameter	Type	Required	Description
`target`	string	Yes	The target domain to analyze (e.g., example.com)
`date`	string	No	Date for historical data in YYYY-MM-DD format (defaults to today)
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`domainRating`	number	Domain Rating score (0-100)
`ahrefsRank`	number	Ahrefs Rank - global ranking based on backlink profile strength

`ahrefs_metrics`

Get a one-call organic and paid search overview for a target domain or URL: organic traffic, organic keywords, paid traffic, paid keywords, and estimated traffic cost.

Input

Parameter	Type	Required	Description
`target`	string	Yes	The target domain or URL to analyze. Example: "example.com"
`country`	string	No	Country code for traffic data. Example: "us", "gb", "de"
`mode`	string	No	Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
`date`	string	No	Date to report metrics on, in YYYY-MM-DD format (defaults to today)
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`metrics`	object	Organic and paid search overview
↳ `organicTraffic`	number	Estimated monthly organic traffic
↳ `organicKeywords`	number	Number of organic keywords ranked
↳ `organicKeywordsTop3`	number	Number of organic keywords ranking in positions 1-3
↳ `organicCost`	number	Estimated monthly cost to replicate organic traffic via ads (USD)
↳ `paidTraffic`	number	Estimated monthly paid search traffic
↳ `paidKeywords`	number	Number of paid keywords targeted
↳ `paidPages`	number	Number of pages receiving paid traffic
↳ `paidCost`	number	Estimated monthly paid search spend (USD)

`ahrefs_backlinks`

Get a list of backlinks pointing to a target domain or URL. Returns details about each backlink including source URL, anchor text, and domain rating.

Input

Parameter	Type	Required	Description
`target`	string	Yes	The target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
`mode`	string	No	Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
`history`	string	No	Historical scope: "live" (currently live backlinks), "all_time" (default, includes lost backlinks), or "since:YYYY-MM-DD" (backlinks found since a date).
`limit`	number	No	Maximum number of results to return. Example: 50 (default: 1000)
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`backlinks`	array	List of backlinks pointing to the target
↳ `urlFrom`	string	The URL of the page containing the backlink
↳ `urlTo`	string	The URL being linked to
↳ `anchor`	string	The anchor text of the link
↳ `domainRatingSource`	number	Domain Rating of the linking domain
↳ `isDofollow`	boolean	Whether the link is dofollow
↳ `firstSeen`	string	When the backlink was first discovered
↳ `lastVisited`	string	When the backlink was last checked

`ahrefs_backlinks_stats`

Get backlink and referring domain totals for a target domain or URL, both currently live and across all time.

Input

Parameter	Type	Required	Description
`target`	string	Yes	The target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
`mode`	string	No	Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
`date`	string	No	Date to report metrics on, in YYYY-MM-DD format (defaults to today)
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`stats`	object	Backlink and referring domain totals
↳ `liveBacklinks`	number	Number of currently live backlinks
↳ `liveReferringDomains`	number	Number of currently live referring domains
↳ `allTimeBacklinks`	number	Total backlinks ever discovered, including lost ones
↳ `allTimeReferringDomains`	number	Total referring domains ever discovered, including lost ones

`ahrefs_referring_domains`

Get a list of domains that link to a target domain or URL. Returns unique referring domains with their domain rating, backlink counts, and discovery dates.

Input

Parameter	Type	Required	Description
`target`	string	Yes	The target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
`mode`	string	No	Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
`history`	string	No	Historical scope: "live" (currently live), "all_time" (default, includes lost domains), or "since:YYYY-MM-DD" (domains found since a date).
`limit`	number	No	Maximum number of results to return. Example: 50 (default: 1000)
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`referringDomains`	array	List of domains linking to the target
↳ `domain`	string	The referring domain
↳ `domainRating`	number	Domain Rating of the referring domain
↳ `backlinks`	number	Total number of backlinks from this domain to the target
↳ `dofollowBacklinks`	number	Number of dofollow backlinks from this domain
↳ `firstSeen`	string	When the domain was first seen linking
↳ `lastVisited`	string	When the domain was last seen linking (null if never re-crawled)

`ahrefs_broken_backlinks`

Get a list of broken backlinks pointing to a target domain or URL. Useful for identifying link reclamation opportunities.

Input

Parameter	Type	Required	Description
`target`	string	Yes	The target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
`mode`	string	No	Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
`limit`	number	No	Maximum number of results to return. Example: 50 (default: 1000)
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`brokenBacklinks`	array	List of broken backlinks
↳ `urlFrom`	string	The URL of the page containing the broken link
↳ `urlTo`	string	The broken URL being linked to
↳ `httpCode`	number	HTTP status code of the broken target URL (e.g., 404, 410)
↳ `anchor`	string	The anchor text of the link
↳ `domainRatingSource`	number	Domain Rating of the linking domain

`ahrefs_organic_keywords`

Get organic keywords that a target domain or URL ranks for in Google search results. Returns keyword details including search volume, ranking position, and estimated traffic.

Input

Parameter	Type	Required	Description
`target`	string	Yes	The target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
`country`	string	No	Country code for search results. Example: "us", "gb", "de" (default: "us")
`mode`	string	No	Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
`date`	string	No	Date to report metrics on, in YYYY-MM-DD format (defaults to today)
`limit`	number	No	Maximum number of results to return. Example: 50 (default: 1000)
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`keywords`	array	List of organic keywords the target ranks for
↳ `keyword`	string	The keyword
↳ `volume`	number	Monthly search volume
↳ `position`	number	Best ranking position for this keyword
↳ `url`	string	The URL that ranks at the best position for this keyword
↳ `traffic`	number	Estimated monthly organic traffic
↳ `keywordDifficulty`	number	Keyword difficulty score (0-100)

`ahrefs_organic_competitors`

Get domains that compete with a target domain or URL for the same organic keywords, ranked by keyword overlap.

Input

Parameter	Type	Required	Description
`target`	string	Yes	The target domain or URL to analyze. Example: "example.com"
`country`	string	No	Country code for search results. Example: "us", "gb", "de" (default: "us")
`mode`	string	No	Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
`date`	string	No	Date to report metrics on, in YYYY-MM-DD format (defaults to today)
`limit`	number	No	Maximum number of results to return. Example: 50 (default: 1000)
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`competitors`	array	List of organic search competitors ranked by keyword overlap
↳ `domain`	string	The competitor domain
↳ `domainRating`	number	Domain Rating of the competitor
↳ `commonKeywords`	number	Number of keywords the competitor and target both rank for
↳ `targetKeywords`	number	Number of keywords the target ranks for
↳ `competitorKeywords`	number	Number of keywords the competitor ranks for
↳ `traffic`	number	Estimated monthly organic traffic for the competitor

`ahrefs_top_pages`

Get the top pages of a target domain sorted by organic traffic. Returns page URLs with their traffic, keyword counts, and estimated traffic value.

Input

Parameter	Type	Required	Description
`target`	string	Yes	The target domain to analyze. Example: "example.com"
`country`	string	No	Country code for traffic data. Example: "us", "gb", "de" (default: "us")
`mode`	string	No	Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default). Example: "domain"
`date`	string	No	Date to report metrics on, in YYYY-MM-DD format (defaults to today)
`limit`	number	No	Maximum number of results to return. Example: 50 (default: 1000)
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`pages`	array	List of top pages by organic traffic
↳ `url`	string	The page URL
↳ `traffic`	number	Estimated monthly organic traffic
↳ `keywords`	number	Number of keywords the page ranks for
↳ `topKeyword`	string	The top keyword driving traffic to this page
↳ `value`	number	Estimated traffic value in USD

`ahrefs_keyword_overview`

Get detailed metrics for a keyword including search volume, keyword difficulty, CPC, clicks, and traffic potential.

Input

Parameter	Type	Required	Description
`keyword`	string	Yes	The keyword to analyze
`country`	string	No	Country code for keyword data. Example: "us", "gb", "de" (default: "us")
`apiKey`	string	Yes	Ahrefs API Key

Output

Parameter	Type	Description
`overview`	object	Keyword metrics overview
↳ `keyword`	string	The analyzed keyword
↳ `searchVolume`	number	Monthly search volume
↳ `keywordDifficulty`	number	Keyword difficulty score (0-100)
↳ `cpc`	number	Cost per click in USD
↳ `clicks`	number	Estimated clicks per month
↳ `clicksPercentage`	number	Percentage of searches that result in an organic click
↳ `parentTopic`	string	The parent topic for this keyword
↳ `trafficPotential`	number	Estimated traffic potential if ranking #1
↳ `intents`	object	Search intent flags (informational, navigational, commercial, transactional, branded, local)
↳ `informational`	boolean	Query seeks information
↳ `navigational`	boolean	Query seeks a specific site or page
↳ `commercial`	boolean	Query researches a purchase decision
↳ `transactional`	boolean	Query intends to complete a purchase
↳ `branded`	boolean	Query references a specific brand
↳ `local`	boolean	Query seeks local results

Ahrefs

On this page