Skip to content
Try for free
On this page

Integrations

Ahrefs

SEO analysis with Ahrefs

Use Ahrefs in Sim to retrieve domain and backlink metrics, organic keywords, top pages, and ranking data for SEO research and reports. Connect an Ahrefs API key with access to the endpoints you need. API v3 is available on Lite and higher plans; API units and per-request row limits depend on the plan.

Use the block

Analyze domain ratings, backlinks, organic keywords, top pages, and more. Requires an Ahrefs API key with access to the selected endpoints; API v3 is available on Lite and higher plans.

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.

Inputs and outputs

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.

Inputs and outputs

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)

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.

Inputs and outputs

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

Ahrefs Backlinks Stats

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

Inputs and outputs

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.

Inputs and outputs

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)

Ahrefs Broken Backlinks

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

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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)

Ahrefs Related Terms

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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 Referring Domains History

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

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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.

Inputs and outputs

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
Was this helpful?
Suggest an edit