Skip to content
API Reference
Ahrefs logo

Ahrefs

Analytics

SEO and marketing intelligence platform

Ahrefs is an SEO and competitive intelligence platform. Connect your AI tools to access backlink analysis, keyword research, organic traffic data, site audits, and rank tracking across the open web. Requires a paid Ahrefs plan (Lite or higher).

Add Ahrefs to your zone and connect it to your MCP client.

  1. In your zone’s Keycard Console, go to Applications -> Add Application -> Explore MCP Servers.

  2. Search for Ahrefs and click Install.

  3. A browser tab opens to Ahrefs’s OAuth consent screen. Sign in and approve the requested permissions.

  4. You’re redirected back. Ahrefs appears on the Applications page with a Keycard MCP Gateway URL.

On the Applications page, click Add to Coding Agent next to Ahrefs and pick how you want to install:

  • Cursor - opens a deeplink that hands the MCP config straight to Cursor. Click Install inside Cursor to finish.
  • Claude Code - opens a dialog with a claude mcp add command. Pick a scope (User, Project, or Local), then copy and run the command in your terminal.
  • Install manually - reveals the Server Name and Server URL to paste into any other MCP-compatible client.

Once connected, Ahrefs’s tools are available to the agent, scoped to whoever signs in to your zone.

What Ahrefs can do once installed.

Ahrefs provides 108 tools:

site-explorer-domain-rating-history
Get historical domain rating over a date range
site-explorer-organic-competitors
List organic search competitors with SEO metrics
rank-tracker-overview
Get tracked keyword rankings overview by date
brand-radar-mentions-history
Get historical brand mention counts in an LLM
brand-radar-impressions-overview
Get brand impression counts in an LLM with filters
web-analytics-source-channels-chart
Chart visitor time-series by source channel
serp-overview
Get top SERP results for a keyword and country
web-analytics-entry-pages
List entry page stats with visitor and bounce data
site-explorer-refdomains-history
Get historical referring domain counts over time
gsc-metrics-by-country
Get GSC click metrics grouped by country
doc
View Ahrefs API v3 and MCP tools documentation
keywords-explorer-volume-history
Get historical search volume for a keyword
subscription-info-limits-and-usage
Get API subscription limits and usage stats
brand-radar-sov-history
Get historical share of voice for brands in an LLM
web-analytics-languages
List visitors grouped by browser language
rank-tracker-competitors-pages
List competitor pages and keyword metrics by date
brand-radar-cited-pages
List pages cited in AI responses mentioning brands
gsc-performance-by-device
Get GSC metrics broken down by device type
public-crawler-ips
List Ahrefs crawler IP addresses
web-analytics-countries
List visitors grouped by country
web-analytics-exit-pages
List exit page stats with visitor data
site-explorer-pages-by-internal-links
Analyze internal link structure for a site or page
gsc-performance-by-position
Get GSC metrics grouped by position ranges
gsc-page-history
Get GSC performance history for specific pages
site-explorer-outlinks-stats
Get outbound link stats for a URL or domain
web-analytics-cities
List visitors grouped by city
brand-radar-mentions-overview
Get brand mention counts in an LLM with filters
web-analytics-source-channels
List traffic grouped by source channel
site-audit-issues
List all issues from a Site Audit crawl
site-explorer-broken-backlinks
List broken backlinks for a URL or domain
rank-tracker-competitors-stats
Get competitor metrics overview for a project
web-analytics-utm-params-chart
Chart visitor time-series by UTM parameter
web-analytics-referrers-chart
Chart visitor time-series by referrer
web-analytics-continents-chart
Chart visitor time-series by continent
web-analytics-entry-pages-chart
Chart entry page visitor time-series
web-analytics-stats
Get aggregate stats: visitors, bounce rate, sessions
site-explorer-backlinks-stats
Get backlink stats for a URL or domain by date
web-analytics-operating-systems
List visitors grouped by operating system
web-analytics-top-pages
List most visited pages with pageview metrics
brand-radar-ai-responses
Get AI-generated responses mentioning your brand
web-analytics-operating-systems-versions-chart
Chart visitor time-series by OS version
web-analytics-devices-chart
Chart visitor time-series by device type
web-analytics-chart
Chart aggregate analytics time-series data
keywords-explorer-overview
Get keyword metrics: volume, CPC, difficulty, traffic
site-explorer-url-rating-history
Get historical URL rating over a date range
management-keyword-list-keywords
Get keywords from a keyword list
web-analytics-sources-chart
Chart visitor time-series by traffic source
public-crawler-ip-ranges
List Ahrefs crawler IP ranges for allowlisting
site-explorer-metrics
Get SEO performance metrics for a domain or URL
site-explorer-referring-domains
List referring domains linking to a target
gsc-keyword-history
Get GSC performance history for specific keywords
site-explorer-metrics-by-country
Get search metrics by country for a website
site-explorer-all-backlinks
List all backlinks for a URL or domain
web-analytics-exit-pages-chart
Chart exit page visitor time-series
gsc-keywords
List GSC keywords with clicks, impressions, CTR
web-analytics-sources
List traffic sources with visitor metrics
site-explorer-total-search-volume-history
Get historical total search volume for ranked keywords
site-explorer-linked-anchors-external
Get external anchor text data for a domain or URL
management-brand-radar-prompts
Get custom prompts for a brand radar report
site-explorer-linked-anchors-internal
Get internal anchor text data for a site
keywords-explorer-related-terms
Returns keyword metrics and related terms—such as "also rank for" keywords and "also talk about" keywords—for a given...
site-explorer-organic-keywords
List organic keywords with rankings and SERP data
web-analytics-languages-chart
Chart visitor time-series by browser language
web-analytics-browsers
List visitors grouped by browser
keywords-explorer-matching-terms
Find keyword ideas matching input terms
management-project-keywords
List tracked keywords for a Rank Tracker project
brand-radar-sov-overview
Get share of voice for brands in an LLM
management-locations
List locations filtered by country and state
gsc-ctr-by-position
Get GSC CTR data by keyword position
gsc-anonymous-queries
List anonymized GSC queries not reported by Google
gsc-performance-history
Get GSC performance chart data over time
site-audit-page-content
Get HTML and text content from a crawled page
brand-radar-impressions-history
Get historical brand impression counts in an LLM
site-explorer-top-pages
List top-performing pages with SEO metrics
keywords-explorer-search-suggestions
Get keyword search suggestions with metrics
gsc-positions-history
Get GSC keyword counts by position range over time
gsc-pages-history
Get GSC indexed page counts over time
web-analytics-countries-chart
Chart visitor time-series by country
web-analytics-top-pages-chart
Chart top pages visitor time-series
site-explorer-keywords-history
Get historical organic keyword count data
site-explorer-anchors
List anchor text with backlink metrics
site-explorer-metrics-history
Get historical search traffic and cost metrics
rank-tracker-competitors-overview
Get competitor rankings overview for a project
site-explorer-pages-by-backlinks
List pages ranked by referring link count
web-analytics-utm-params
List traffic stats by UTM parameter value
web-analytics-cities-chart
Chart visitor time-series by city
web-analytics-browsers-chart
Chart visitor time-series by browser
site-explorer-domain-rating
Get domain rating and metrics for a domain or URL
site-audit-page-explorer
List crawled pages with metadata and audit details
web-analytics-browser-versions
List visitors grouped by browser version
site-explorer-pages-history
Get historical page data for a domain or section
keywords-explorer-volume-by-country
Get keyword search volume broken down by country
management-projects
List projects with ownership and access details
site-explorer-pages-by-traffic
Get page distribution by organic traffic buckets
rank-tracker-serp-overview
Get SERP overview for a tracked keyword
management-project-competitors
List competitors for a Rank Tracker project
web-analytics-operating-systems-chart
Chart visitor time-series by operating system
web-analytics-operating-systems-versions
List visitors grouped by OS version
web-analytics-devices
List visitors grouped by device type
site-explorer-paid-pages
List pages ranking in paid search with metrics
web-analytics-browser-versions-chart
Chart visitor time-series by browser version
site-audit-projects
List Site Audit projects with health scores
batch-analysis
Analyze multiple URLs for SEO and backlink metrics
brand-radar-cited-domains
List domains cited in AI responses for brands
web-analytics-referrers
List referrer stats with visitor metrics
gsc-pages
List GSC pages with clicks, impressions, CTR
site-explorer-linked-domains
List external domains linked from a target
web-analytics-continents
List visitors grouped by continent

What to do once Ahrefs is installed.

Now do this

  • Confirm the gateway works by asking your AI client to call one of the Ahrefs tools above.

Recommended

  • Decide who can use it - write access policies scoped to the Ahrefs resource so only the right users and agents reach the tools.
  • Watch the calls - every tool call lands in your audit log with user identity, resource, and policy decision.