Ahrefs

Ahrefs é um conjunto de ferramentas de SEO líder para analisar websites, rastrear rankings, monitorar backlinks e pesquisar palavras-chave. Ele fornece insights detalhados sobre seu próprio website, bem como sobre seus concorrentes, ajudando você a tomar decisões baseadas em dados para melhorar sua visibilidade nos mecanismos de busca.

Com a integração do Ahrefs no Zoen, você pode:

  • Analisar Domain Rating & Autoridade: Verifique instantaneamente o Domain Rating (DR) e o Ahrefs Rank de qualquer website para avaliar sua autoridade.
  • Obter Backlinks: Recuperar uma lista de backlinks que apontam para um site ou URL específico, com detalhes como texto âncora, DR da página referenciadora e muito mais.
  • Obter Estatísticas de Backlinks: Acesse métricas sobre os tipos de backlinks (dofollow, nofollow, texto, imagem, redirecionamento, etc.) para um domínio ou URL.
  • Explorar Palavras-chave Orgânicas: Visualize as palavras-chave que um domínio rankeia e suas posições nos resultados de pesquisa do Google.
  • Descobrir as Melhores Páginas: Identifique as páginas de melhor desempenho com base no tráfego orgânico e links.

Essas ferramentas permitem que seus agentes automatizem a pesquisa de SEO, monitorem concorrentes e gerem relatórios – tudo como parte do seu fluxo de trabalho de automação. Para usar a integração do Ahrefs, você precisará de uma assinatura Ahrefs Enterprise com acesso à API.

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

ParameterTypeRequiredDescription
targetstringYesThe target domain to analyze (e.g., example.com)
datestringNoDate for historical data in YYYY-MM-DD format (defaults to today)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
domainRatingnumberDomain Rating score (0-100)
ahrefsRanknumberAhrefs 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

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com"
countrystringNoCountry code for traffic data. Example: "us", "gb", "de"
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
datestringNoDate to report metrics on, in YYYY-MM-DD format (defaults to today)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
metricsobjectOrganic and paid search overview
organicTrafficnumberEstimated monthly organic traffic
organicKeywordsnumberNumber of organic keywords ranked
organicKeywordsTop3numberNumber of organic keywords ranking in positions 1-3
organicCostnumberEstimated monthly cost to replicate organic traffic via ads (USD)
paidTrafficnumberEstimated monthly paid search traffic
paidKeywordsnumberNumber of paid keywords targeted
paidPagesnumberNumber of pages receiving paid traffic
paidCostnumberEstimated monthly paid search spend (USD)

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

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
historystringNoHistorical scope: "live" (currently live backlinks), "all_time" (default, includes lost backlinks), or "since:YYYY-MM-DD" (backlinks found since a date).
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
backlinksarrayList of backlinks pointing to the target
urlFromstringThe URL of the page containing the backlink
urlTostringThe URL being linked to
anchorstringThe anchor text of the link
domainRatingSourcenumberDomain Rating of the linking domain
isDofollowbooleanWhether the link is dofollow
firstSeenstringWhen the backlink was first discovered
lastVisitedstringWhen the backlink was last checked

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

Input

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
datestringNoDate to report metrics on, in YYYY-MM-DD format (defaults to today)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
statsobjectBacklink and referring domain totals
liveBacklinksnumberNumber of currently live backlinks
liveReferringDomainsnumberNumber of currently live referring domains
allTimeBacklinksnumberTotal backlinks ever discovered, including lost ones
allTimeReferringDomainsnumberTotal 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

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
historystringNoHistorical scope: "live" (currently live), "all_time" (default, includes lost domains), or "since:YYYY-MM-DD" (domains found since a date).
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
referringDomainsarrayList of domains linking to the target
domainstringThe referring domain
domainRatingnumberDomain Rating of the referring domain
backlinksnumberTotal number of backlinks from this domain to the target
dofollowBacklinksnumberNumber of dofollow backlinks from this domain
firstSeenstringWhen the domain was first seen linking
lastVisitedstringWhen the domain was last seen linking (null if never re-crawled)

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

Input

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
brokenBacklinksarrayList of broken backlinks
urlFromstringThe URL of the page containing the broken link
urlTostringThe broken URL being linked to
httpCodenumberHTTP status code of the broken target URL (e.g., 404, 410)
anchorstringThe anchor text of the link
domainRatingSourcenumberDomain 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

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
countrystringNoCountry code for search results. Example: "us", "gb", "de" (default: "us")
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
datestringNoDate to report metrics on, in YYYY-MM-DD format (defaults to today)
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
keywordsarrayList of organic keywords the target ranks for
keywordstringThe keyword
volumenumberMonthly search volume
positionnumberBest ranking position for this keyword
urlstringThe URL that ranks at the best position for this keyword
trafficnumberEstimated monthly organic traffic
keywordDifficultynumberKeyword 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

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com"
countrystringNoCountry code for search results. Example: "us", "gb", "de" (default: "us")
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
datestringNoDate to report metrics on, in YYYY-MM-DD format (defaults to today)
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
competitorsarrayList of organic search competitors ranked by keyword overlap
domainstringThe competitor domain
domainRatingnumberDomain Rating of the competitor
commonKeywordsnumberNumber of keywords the competitor and target both rank for
targetKeywordsnumberNumber of keywords the target ranks for
competitorKeywordsnumberNumber of keywords the competitor ranks for
trafficnumberEstimated 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

ParameterTypeRequiredDescription
targetstringYesThe target domain to analyze. Example: "example.com"
countrystringNoCountry code for traffic data. Example: "us", "gb", "de" (default: "us")
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: "domain"
datestringNoDate to report metrics on, in YYYY-MM-DD format (defaults to today)
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
pagesarrayList of top pages by organic traffic
urlstringThe page URL
trafficnumberEstimated monthly organic traffic
keywordsnumberNumber of keywords the page ranks for
topKeywordstringThe top keyword driving traffic to this page
valuenumberEstimated traffic value in USD

ahrefs_keyword_overview

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

Input

ParameterTypeRequiredDescription
keywordstringYesThe keyword to analyze
countrystringNoCountry code for keyword data. Example: "us", "gb", "de" (default: "us")
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
overviewobjectKeyword metrics overview
keywordstringThe analyzed keyword
searchVolumenumberMonthly search volume
keywordDifficultynumberKeyword difficulty score (0-100)
cpcnumberCost per click in USD
clicksnumberEstimated clicks per month
clicksPercentagenumberPercentage of searches that result in an organic click
parentTopicstringThe parent topic for this keyword
trafficPotentialnumberEstimated traffic potential if ranking #1
intentsobjectSearch intent flags (informational, navigational, commercial, transactional, branded, local)
informationalbooleanQuery seeks information
navigationalbooleanQuery seeks a specific site or page
commercialbooleanQuery researches a purchase decision
transactionalbooleanQuery intends to complete a purchase
brandedbooleanQuery references a specific brand
localbooleanQuery seeks local results

ahrefs_paid_pages

Get a target domain's pages that receive paid search traffic, sorted by estimated paid traffic. Returns page URLs with their paid traffic, keyword counts, and estimated spend.

Input

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com"
countrystringNoCountry code for traffic data. Example: "us", "gb", "de" (default: "us")
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)
datestringNoDate to report metrics on, in YYYY-MM-DD format (defaults to today)
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
paidPagesarrayList of pages receiving paid search traffic
urlstringThe page URL
trafficnumberEstimated monthly paid search traffic
keywordsnumberNumber of paid keywords the page ranks for
topKeywordstringThe top keyword driving paid traffic to this page
valuenumberEstimated monthly paid traffic cost in USD
adsCountnumberNumber of unique ads shown for this page

ahrefs_anchors

Get the anchor text distribution for a target domain or URL's backlinks, showing how many links and referring domains use each anchor text.

Input

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com" or "https://example.com/page"
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)
historystringNoHistorical scope: "live" (currently live), "all_time" (default, includes lost backlinks), or "since:YYYY-MM-DD" (backlinks found since a date)
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
anchorsarrayAnchor text distribution for the backlink profile
anchorstringThe anchor text
backlinksnumberTotal backlinks using this anchor text
dofollowBacklinksnumberNumber of dofollow backlinks using this anchor text
referringDomainsnumberNumber of unique referring domains using this anchor text
firstSeenstringWhen a link with this anchor was first found
lastSeenstringWhen a backlink with this anchor was last seen (null if still live)

Get keyword ideas related to a seed keyword: terms the same top-ranking pages also rank for ("also rank for") or also discuss ("also talk about"), with volume, difficulty, and CPC.

Input

ParameterTypeRequiredDescription
keywordstringYesThe seed keyword to find related terms for
countrystringNoCountry code for keyword data. Example: "us", "gb", "de" (default: "us")
termsstringNoType of related keywords to return: "also_rank_for", "also_talk_about", or "all" (default: "all")
viewForstringNoWhether to derive related terms from the top 10 or top 100 ranking pages (default: "top_10")
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
relatedTermsarrayRelated keyword ideas for the seed keyword
keywordstringThe related keyword
volumenumberAverage monthly search volume
keywordDifficultynumberKeyword difficulty score (0-100)
cpcnumberCost per click in USD
parentTopicstringThe parent topic for this keyword
trafficPotentialnumberEstimated traffic potential if ranking #1
intentsobjectSearch intent flags (informational, navigational, commercial, transactional, branded, local)
serpFeaturesarraySERP features present in the results

ahrefs_domain_rating_history

Get the historical Domain Rating (DR) trend for a target domain or URL over a date range, grouped daily, weekly, or monthly.

Input

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com"
dateFromstringYesStart date of the historical period, in YYYY-MM-DD format
dateTostringNoEnd date of the historical period, in YYYY-MM-DD format (defaults to today)
historyGroupingstringNoTime interval for grouping data points: "daily", "weekly", or "monthly" (default: "monthly")
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
domainRatingsarrayHistorical Domain Rating data points
datestringThe date of the measurement
domainRatingnumberDomain Rating score (0-100) on this date

ahrefs_metrics_history

Get the historical organic and paid traffic trend for a target domain or URL over a date range: organic traffic/cost and paid traffic/cost at each point in time.

Input

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com"
dateFromstringYesStart date of the historical period, in YYYY-MM-DD format
dateTostringNoEnd date of the historical period, in YYYY-MM-DD format (defaults to today)
volumeModestringNoSearch volume calculation: "monthly" or "average" (default: "monthly")
historyGroupingstringNoTime interval for grouping data points: "daily", "weekly", or "monthly" (default: "monthly")
countrystringNoCountry code for traffic data. Example: "us", "gb", "de" (default: "us")
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
metricsHistoryarrayHistorical organic and paid traffic data points
datestringDate of the metric entry
organicTrafficnumberEstimated monthly organic visits
organicCostnumberEstimated monthly cost to replicate organic traffic via ads (USD)
paidTrafficnumberEstimated monthly paid search visits
paidCostnumberEstimated monthly paid search spend (USD)

ahrefs_refdomains_history

Get the historical referring domains trend for a target domain or URL over a date range, grouped daily, weekly, or monthly.

Input

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com"
dateFromstringYesStart date of the historical period, in YYYY-MM-DD format
dateTostringNoEnd date of the historical period, in YYYY-MM-DD format (defaults to today)
historyGroupingstringNoTime interval for grouping data points: "daily", "weekly", or "monthly" (default: "monthly")
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
referringDomainsHistoryarrayHistorical referring domains count data points
datestringThe date of the data point
referringDomainsnumberTotal number of unique domains linking to the target on this date

ahrefs_keywords_history

Get the historical organic keyword ranking distribution for a target domain or URL over a date range: how many keywords rank in each position bucket at each point in time.

Input

ParameterTypeRequiredDescription
targetstringYesThe target domain or URL to analyze. Example: "example.com"
dateFromstringYesStart date of the historical period, in YYYY-MM-DD format
dateTostringNoEnd date of the historical period, in YYYY-MM-DD format (defaults to today)
historyGroupingstringNoTime interval for grouping data points: "daily", "weekly", or "monthly" (default: "monthly")
countrystringNoCountry code for search results. Example: "us", "gb", "de" (default: "us")
modestringNoAnalysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
keywordsHistoryarrayHistorical organic keyword ranking distribution
datestringDate of the record
top3numberKeywords ranking in top 3 organic results
top4To10numberKeywords ranking in positions 4-10
top11To20numberKeywords ranking in positions 11-20
top21To50numberKeywords ranking in positions 21-50
top51PlusnumberKeywords ranking in position 51 and beyond

ahrefs_batch_analysis

Get bulk SEO metrics (Domain Rating, backlinks, referring domains, organic traffic, and more) for multiple domains or URLs in a single request. Useful for comparing many competitors at once.

Input

ParameterTypeRequiredDescription
targetsstringYesComma-separated list of domains or URLs to analyze. Example: "example.com,competitor.com"
modestringNoAnalysis mode applied to every target: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)
protocolstringNoProtocol applied to every target: "both" (default), "http", or "https"
countrystringNoCountry code for traffic data. Example: "us", "gb", "de" (default: "us")
volumeModestringNoSearch volume calculation: "monthly" or "average" (default: "monthly")
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
resultsarrayBulk metrics for each analyzed target, in submission order
urlstringThe analyzed target URL or domain
indexnumberIndex of the target in the submitted list
domainRatingnumberDomain Rating score (0-100)
ahrefsRanknumberAhrefs Rank (global ranking)
backlinksnumberTotal backlinks to the target
referringDomainsnumberUnique domains linking to the target
organicTrafficnumberEstimated monthly organic traffic
organicKeywordsnumberNumber of organic keywords ranked (top 100)
paidTrafficnumberEstimated monthly paid search traffic
errorstringError message if this target could not be analyzed

ahrefs_site_audit_page_explorer

Get crawled pages from an Ahrefs Site Audit project with health and SEO metrics: HTTP status, title, link counts, backlinks, indexability, and traffic. Optionally filter to pages affected by a specific issue.

Input

ParameterTypeRequiredDescription
projectIdnumberYesThe Site Audit project ID (found in the project URL in Ahrefs)
datestringNoCrawl date in YYYY-MM-DDThh:mm:ss format (defaults to the most recent crawl)
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
offsetnumberNoNumber of results to skip, for pagination
issueIdstringNoOnly return pages affected by this issue ID
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
auditPagesarrayList of crawled pages with health and SEO metrics
urlstringThe crawled page URL
httpCodenumberHTTP status code returned by the URL
titlearrayPage title tag(s)
internalLinksnumberNumber of internal outgoing links
externalLinksnumberNumber of external outgoing links
backlinksnumberNumber of incoming external links to the page
compliantbooleanWhether the page is indexable (200 status, no canonical/noindex)
trafficnumberEstimated monthly organic traffic to the page

ahrefs_rank_tracker_overview

Get ranking overview metrics for the keywords tracked in an Ahrefs Rank Tracker project: position, search volume, keyword difficulty, and estimated traffic. This endpoint is free and does not consume API units.

Input

ParameterTypeRequiredDescription
projectIdnumberYesThe Rank Tracker project ID (found in the project URL in Ahrefs)
datestringYesDate to report rankings for, in YYYY-MM-DD format
devicestringYesRankings device type: "desktop" or "mobile"
dateComparedstringNoComparison date in YYYY-MM-DD format, to compute position/traffic deltas
volumeModestringNoSearch volume calculation: "monthly" or "average" (default: "monthly")
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
overviewsarrayRanking overview for each tracked keyword
keywordstringThe tracked keyword
positionnumberTop organic search position
volumenumberAverage monthly search volume
keywordDifficultynumberKeyword difficulty score (0-100)
urlstringTop-ranking URL
trafficnumberEstimated monthly organic visits
serpFeaturesarraySERP features present in the results
bestPositionKindstringType of the top position (organic, paid, or SERP feature)

ahrefs_rank_tracker_serp_overview

Get the full SERP (search engine results page) for a keyword tracked in an Ahrefs Rank Tracker project, including every ranking URL with its position, title, and authority metrics. This endpoint is free and does not consume API units.

Input

ParameterTypeRequiredDescription
projectIdnumberYesThe Rank Tracker project ID (found in the project URL in Ahrefs)
keywordstringYesThe tracked keyword to retrieve SERP data for
countrystringYesCountry code for the tracked keyword. Example: "us", "gb", "de"
devicestringYesRankings device type: "desktop" or "mobile"
topPositionsnumberNoNumber of top organic positions to return (defaults to all available)
datestringNoTimestamp to return the last available SERP Overview at, in YYYY-MM-DDThh:mm:ss format
locationIdnumberNoLocation ID of the tracked keyword, if tracked at a specific location
languageCodestringNoLanguage code of the tracked keyword
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
positionsarrayEvery ranking result on the SERP for the tracked keyword
positionnumberPosition of the result in the SERP
urlstringURL of the ranking page
titlestringPage title
typearrayThe kind of the position: organic, paid, or a SERP feature
domainRatingnumberDomain Rating of the ranking domain
urlRatingnumberURL Rating of the ranking page
backlinksnumberTotal backlinks to the ranking domain
refdomainsnumberUnique referring domains
trafficnumberEstimated monthly organic search traffic
valuenumberEstimated monthly traffic value (USD)
topKeywordstringHighest-traffic keyword ranking for this page
topKeywordVolumenumberMonthly search volume for the top keyword
updateDatestringDate the SERP was last checked

ahrefs_rank_tracker_competitors_overview

Get competitor rankings for the keywords tracked in an Ahrefs Rank Tracker project: each tracked keyword's volume and difficulty alongside every competitor's position, traffic, and traffic value. This endpoint is free and does not consume API units.

Input

ParameterTypeRequiredDescription
projectIdnumberYesThe Rank Tracker project ID (found in the project URL in Ahrefs)
datestringYesDate to report rankings for, in YYYY-MM-DD format
devicestringYesRankings device type: "desktop" or "mobile"
dateComparedstringNoComparison date in YYYY-MM-DD format, to compute position/traffic deltas
volumeModestringNoSearch volume calculation: "monthly" or "average" (default: "monthly")
limitnumberNoMaximum number of results to return. Example: 50 (default: 1000)
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
competitorKeywordsarrayTracked keywords with competitor ranking data
keywordstringThe tracked keyword
volumenumberAverage monthly search volume
keywordDifficultynumberKeyword difficulty score (0-100)
serpFeaturesarraySERP features present in the results
competitorsListarrayRanking data for each tracked competitor on this keyword
urlstringThe competitor's ranking URL
positionnumberCurrent ranking position
bestPositionKindstringType of the best position achieved
trafficnumberEstimated traffic to the competitor
valuenumberEstimated traffic value (USD)

ahrefs_rank_tracker_competitors_stats

Get aggregate competitor stats for an Ahrefs Rank Tracker project: each competitor's traffic, traffic value, average position, and share of voice across all tracked keywords. This endpoint is free and does not consume API units.

Input

ParameterTypeRequiredDescription
projectIdnumberYesThe Rank Tracker project ID (found in the project URL in Ahrefs)
datestringYesDate to report metrics for, in YYYY-MM-DD format
devicestringYesRankings device type: "desktop" or "mobile"
volumeModestringNoSearch volume calculation: "monthly" or "average" (default: "monthly")
apiKeystringYesAhrefs API Key

Output

ParameterTypeDescription
competitorsStatsarrayAggregate stats for each tracked competitor
competitorstringThe competitor's URL
trafficnumberEstimated monthly organic visits
trafficValuenumberEstimated monthly organic traffic value (USD)
averagePositionnumberAverage top organic position across tracked keywords
pos1To3numberKeywords ranking in top 3 positions
pos4To10numberKeywords ranking in positions 4-10
shareOfVoicenumberOrganic traffic share percentage
shareOfTrafficValuenumberOrganic traffic value share percentage

On this page