Skip to content
API Reference
Ahrefs logo

Ahrefs

Analytics

SEO and marketing intelligence platform

Connect your AI tools to Ahrefs and access real SEO data including backlink analysis, keyword research, organic traffic insights, site audits, and competitive intelligence. Requires a Lite plan or higher.

Adding Ahrefs provisions three things in your zone: an upstream resource pointing at https://api.ahrefs.com/mcp/mcp (kept inside Keycard), a Keycard MCP Gateway URL - the downstream resource - that you install in Cursor, Claude Code, or any MCP client, and a provider for token exchange with Ahrefs’s OAuth issuer.

When your AI client makes a tool call, it sends a Keycard-issued access token to the gateway URL. Keycard’s STS exchanges that token for an upstream Ahrefs token, the gateway calls the upstream MCP, and the response is proxied back. Your zone’s identity provider, access policies, and audit log apply to every call - the upstream credential never leaves Keycard. Each call is recorded in the audit log with the user identity, the resource accessed, and the policy decision.

Tools the upstream server exposes through the Keycard MCP Gateway.

Ahrefs exposes 108 tools through the gateway:

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

Add Ahrefs to your zone and install the gateway URL into Cursor, Claude Code, or any MCP client.

  1. Open the catalog

    In your zone’s Keycard Console, go to ApplicationsAdd ApplicationExplore MCP Servers.

  2. Find and install Ahrefs

    Search for Ahrefs in the catalog and click Install.

  3. Connect your development tool

    Once installed, Ahrefs appears on the Applications page with a Keycard MCP Gateway URL. Use the Install dropdown to add it to Cursor, Claude Code, or any MCP-compatible client.