Ahrefs SEO Analysis

Query and analyze SEO data using the Ahrefs API for backlinks, keywords, rankings, and competitive intelligence.

Prerequisites

API Access

• - Lite: Basic metrics, limited filtering
• Standard: More endpoints, some filtering
• Advanced: Advanced filtering, more data
• Enterprise: Full API access, advanced filtering, high rate limits

Setup

1. 1. Get your API token from Ahrefs Account Settings

1. 2. Configure in OpenClaw:

1. 3. Verify setup:

Plan-Specific Features

All Plans

• - Domain Rating & Ahrefs Rank
• Basic backlinks stats (total counts)
• Organic keywords count
• Organic traffic estimates
• Top pages by traffic

Standard & Above

• - Organic keywords with positions (all positions)
• Keywords in positions 1-3 (via org_keywords_1_3 metric)
• Referring domains list (basic)

Advanced & Enterprise

• - Advanced filtering: Filter keywords by position (1-10 for first page)
• Geographic filtering: Filter backlinks by country/TLD (e.g., .au domains)
• Detailed keyword data: Access to best_position, sum_traffic, INLINECODE5
• Detailed backlink data: Full backlinks list with filtering
• Higher rate limits: Fetch larger datasets (5000+ records)

Core Capabilities

Site Explorer (Domain Analysis)

• - Domain Rating (DR) & URL Rating (UR)
• Organic traffic estimates
• Referring domains & backlinks
• Organic keywords & rankings
• Top pages by traffic
• Historical data & trends
• [Advanced/Enterprise] Filter by country/TLD
• [Advanced/Enterprise] Position-based filtering (first page only)

Keywords Explorer (Keyword Research)

• - Search volume (global & country-specific)
• Keyword difficulty (KD) score
• Cost per click (CPC) estimates
• SERP analysis & features
• Related keywords & questions
• Keyword ideas & suggestions
• Parent topic analysis
• Traffic potential estimates

Rank Tracker (Position Monitoring)

• - Position tracking & visibility
• Competitor rankings comparison
• SERP feature tracking
• Historical position data
• Share of voice metrics
• Note: Requires pre-configured projects in Ahrefs

Site Audit (Technical SEO)

• - Crawl data & site health scores
• On-page issues by severity
• Internal link analysis
• Page performance metrics
• Mobile usability issues
• Note: Requires pre-configured projects in Ahrefs

SERP Overview (Search Results)

• - Top 100 organic results for any keyword
• SERP features present
• Domain metrics for ranking pages
• Keyword difficulty breakdown
• Click-through rate estimates

Batch Analysis (Bulk Processing)

• - Analyze up to 100 domains/URLs per request
• Bulk keyword metrics
• Batch backlink data
• Cost-effective for large datasets

Brand Radar (Brand Monitoring)

• - Brand mention metrics
• Share of voice
• Competitor brand comparison
• Sentiment analysis preparation

Competitor Analysis

• - Side-by-side domain comparison
• Content gap analysis
• Keyword overlaps & differences
• Backlink gap analysis
• Traffic comparison
• [Advanced/Enterprise] Filtered comparisons (first page keywords, local backlinks)

API Structure

Ahrefs API base URL: INLINECODE6

Authentication

Important: Use AHREFS_API_TOKEN, NOT AHREFS_MCP_TOKEN.

Required Parameters

• - date: Current date in format INLINECODE10
• INLINECODE11: Domain (e.g., example.com)

Common Endpoints

For detailed endpoint documentation and parameters, see references/api-endpoints.md.

API Unit Management

Understanding API Units

• - Each API request consumes units from your monthly allowance
• Cost depends on rows returned (minimum 50 units per request)
• Enterprise plans include units; additional units can be purchased
• Track usage at: https://app.ahrefs.com/account/limits-and-usage/web

Cost Optimization Tips

1. 1. Limit rows returned: Use limit parameter to reduce cost
2. Select specific columns: Use select parameter for only needed fields
3. Batch requests: Process multiple targets in one call (up to 100)
4. Cache results: Store frequently accessed data locally
5. Use date ranges: Limit historical data when not needed

Rate Limits

• - 60 requests per minute (default)
• HTTP 429 returned if limit exceeded
• Implement exponential backoff for retries

Usage Examples

Site Explorer - Get Backlinks & Referring Domains

Returns:
CODEBLOCK4

Get Organic Keywords & Traffic

Returns:
CODEBLOCK6

Get Domain Rating

Returns:
CODEBLOCK8

Get Top Pages

Keywords Explorer - Keyword Research

Returns:
CODEBLOCK11

Keywords Explorer - Related Keywords

SERP Overview - Analyze Search Results

Returns top 100 organic results with domain metrics.

Rank Tracker - Get Project Rankings

CODEBLOCK14

Site Audit - Get Project Issues

CODEBLOCK15

Batch Analysis - Multiple Domains

Returns metrics for all domains in one request.

Common Workflows

Keyword Research Workflow

1. 1. Get keyword overview (volume, difficulty, CPC)
2. Fetch related keywords and questions
3. Analyze SERP for top-ranking content
4. Identify keyword difficulty and traffic potential
5. Export prioritized keyword list

Competitive Analysis Workflow

1. 1. Compare domain metrics (DR, traffic, keywords)
2. Analyze competitor backlink profiles
3. Identify content gaps
4. Find keywords competitors rank for but you don't
5. Discover backlink opportunities

Technical SEO Audit Workflow

1. 1. Fetch site health overview
2. Identify critical issues by severity
3. Analyze internal linking structure
4. Review page performance metrics
5. Generate prioritized fix list

Content Strategy Workflow

1. 1. Research target keywords (Keywords Explorer)
2. Analyze top-ranking content (SERP Overview)
3. Identify content gaps vs competitors
4. Plan content based on traffic potential
5. Track rankings over time (Rank Tracker)

Batch Domain Analysis Workflow

1. 1. Compile list of target domains
2. Make batch API request (up to 100 domains)
3. Compare metrics across all domains
4. Identify patterns and opportunities
5. Export comparative analysis

Best Practices

1. 1. Rate Limits: Respect API rate limits (60 req/min default)
2. API Units: Monitor usage and optimize queries (limit rows, select columns)
3. Caching: Cache responses for frequently accessed data
4. Pagination: Use limit and offset parameters for large datasets
5. Batch Requests: Use batch endpoints when analyzing multiple targets
6. Error Handling: Check for 401 (auth), 429 (rate limit), 404 (not found)
7. Project Requirements: Rank Tracker and Site Audit require pre-configured projects

Environment Variables

Load the token from the workspace .env file:
CODEBLOCK17

CODEBLOCK18

Response Format

API responses vary by endpoint but typically return JSON:

Stats endpoints (backlinks-stats, metrics, domain-rating):
CODEBLOCK19

List endpoints (top-pages, backlinks, etc.):
CODEBLOCK20

Troubleshooting

Authentication Errors

• - Verify token is correctly set in INLINECODE18
• Check token hasn't expired
• Ensure Bearer token format in header

Rate Limiting

• - Implement exponential backoff
• Cache responses where appropriate
• Use batch endpoints when available

Data Not Found

• - Verify domain/URL format
• Check if domain exists in Ahrefs index
• Try alternative target formats (with/without www)