Ahrefs

Connect your AI agents to Ahrefs.

Available Tools

list_backlinks

List backlinks pointing to a target. Returns source URL, anchor text, domain rating, and more. Paginated with offset…

list_refdomains

List referring domains linking to a target. Shows domain rating, backlink count, and first/last seen dates. Paginated…

list_anchors

List anchor text distribution for backlinks to a target. Shows anchor text, backlink count, and referring domains. Pa…

list_broken_backlinks

List broken backlinks pointing to a target (links returning 4xx/5xx). Shows source URL, anchor, and HTTP status. Pagi…

batch_analyze

Analyze up to 100 domains/URLs in a single request. Returns domain rating, backlinks, traffic, and more for each targ…

get_domain_rating_history

Get Domain Rating trend over time for a target. Returns date and DR value pairs. Requires target and date_from. Optio…

get_refdomains_history

Get referring domains count trend over time for a target. Returns date and count pairs. Requires target and date_from…

list_organic_keywords

List organic keywords a target ranks for. Shows position, volume, traffic, difficulty, and URL. Requires target and d…

list_top_pages

List top pages by organic traffic for a target. Shows URL, traffic, keyword count, and top keyword. Requires target a…

list_organic_competitors

List organic search competitors for a target. Shows competitor domain, common keywords, traffic, and domain rating. R…

get_keyword_overview

Get keyword metrics: search volume, difficulty, CPC, clicks, and traffic potential. Pass comma-separated keywords and…

list_matching_terms

Find keyword variations matching seed keywords. Shows volume, difficulty, CPC, and traffic potential. Requires keywor…

list_related_terms

Find related keywords that top-ranking pages also rank for. Shows volume, difficulty, and traffic potential. Requires…

list_search_suggestions

Get Google search autocomplete suggestions for seed keywords. Shows volume, difficulty, and CPC. Requires keywords an…

get_volume_history

Get monthly search volume history for a keyword over time. Requires keyword and country code. Optionally specify date…

list_projects

List Ahrefs projects. Free endpoint (0 API units). Optionally filter by owner email or access type.

create_project

Create a new Ahrefs project for a domain. Free endpoint (0 API units). Requires target URL.

list_project_keywords

List tracked keywords for an Ahrefs project. Free endpoint (0 API units). Use list_projects to find project IDs.

add_project_keywords

Add keywords to track in an Ahrefs project. Free endpoint (0 API units). Use list_projects to find project IDs.

remove_project_keywords

Remove keywords from an Ahrefs project. Free endpoint (0 API units). Use list_project_keywords to see current keywords.

list_project_competitors

List competitors for an Ahrefs project. Free endpoint (0 API units). Use list_projects to find project IDs.

add_project_competitors

Add competitors to an Ahrefs project. Free endpoint (0 API units). Each competitor needs url, mode, and protocol.

remove_project_competitors

Remove competitors from an Ahrefs project. Free endpoint (0 API units). Use list_project_competitors to see current c…

list_keyword_list_keywords

List keywords in a keyword list. Free endpoint (0 API units). Requires keyword_list_id.

add_keyword_list_keywords

Add keywords to a keyword list. Free endpoint (0 API units). Requires keyword_list_id and keywords array.

remove_keyword_list_keywords

Remove keywords from a keyword list. Free endpoint (0 API units). Use list_keyword_list_keywords to see current keywo…

get_domain_rating

Get Domain Rating (DR) for a domain, showing backlink profile strength on a 0-100 scale. Requires target domain and d…

get_backlinks_stats

Get backlink statistics for a target: live backlinks, all-time backlinks, live referring domains, all-time referring …

get_metrics

Get organic and paid search metrics for a target: keyword counts, traffic estimates, traffic value. Use country param…

get_pages_by_traffic

Get traffic distribution by page range for a target. Shows how many pages fall into each traffic bucket (0, 100, 1K, …

get_limits_and_usage

Check current API usage and subscription limits. Free endpoint (0 API units). Shows units consumed, remaining quota, …

validate_credential

Validate Ahrefs API credentials by checking subscription info. Returns success status and message.