Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Find the domains (or pages, with an exact URL target) competing with a target in Google organic search according to Ahrefs, with common and unique keyword counts, share, Domain Rating, traffic and …
| App | Ahrefs |
| Operation ID | ahrefs_get_organic_competitors |
| Type | Action |
| Connection | ahrefs (required) |
| Credits per run | Free |
| Agent / MCP tool | Yes |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
target | string | Yes | - | The domain or URL to find organic search competitors for (e.g. example.com). Use mode ‘exact’ with a page URL to get competing pages (competitor_url) instead of competing domains. |
mode | string or SelectableOption | No | subdomains | How to interpret the target: ‘subdomains’ (domain and all subdomains, default), ‘domain’ (the exact host only), ‘prefix’ (every URL starting with the target), or ‘exact’ (the exact URL only). |
country | string or SelectableOption | No | us | Two-letter country code (e.g. us, gb, de). Required by Ahrefs for this report; defaults to us. |
date | string | No | - | Report date in YYYY-MM-DD format. Defaults to today (latest data). |
date_compared | string | No | - | Optional earlier date in YYYY-MM-DD format to compare against; enables the *_prev and *_diff metrics. |
metrics | array of string or SelectableOption | No | - | Metrics to return. Available: competitor_domain, competitor_url (pages mode), domain_rating, keywords_common, keywords_competitor, keywords_target, share, pages, pages_prev, pages_diff, traffic, traffic_prev, traffic_diff, value (USD), value_prev, value_diff. Ahrefs API unit cost per row: traffic, traffic_prev, value and value_prev cost 10 units, the rest 1. Defaults to competitor_domain, domain_rating, keywords_common, keywords_competitor, keywords_target, share, pages, traffic, value. |
filters | array of FilterItem | No | - | Filters on the available metrics, e.g. keywords_common GREATER_THAN 100 or domain_rating GREATER_THAN 40. Filter fields count towards the unit cost per row. |
orders | array of OrderItem | No | - | Sort by one or more metrics. |
limit | integer | No | 100 | Maximum number of rows to return. Defaults to 100. Your Ahrefs plan caps rows per request (Lite 100, Standard 250, Advanced 500). |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
field | string or SelectableOption | Yes | - | The field to filter on, must be one of the current selected metrics or dimensions. |
operator | string | Yes | - | The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer|holiday).’ |
value | string | Yes | - | The value to filter by, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
field | string or SelectableOption | Yes | - | The field to sort by. must be one of the current selected metrics or dimensions. |
direction | string | Yes | - | The order to sort by, must be one of ‘ASC’, ‘DESC’ |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
List[Dict]
Returns one row per competitor with the selected Ahrefs fields: competitor_domain or competitor_url, domain_rating, keywords_common, keywords_competitor, keywords_target, share, pages, traffic, value (USD) and *_prev / *_diff comparison fields.
Fields: competitor_domain, domain_rating, keywords_common, keywords_competitor, keywords_target, share, pages, traffic, value
Example:
[
{
"competitor_domain": "backlinko.com",
"domain_rating": 90.0,
"keywords_common": 3436,
"keywords_competitor": 8279,
"keywords_target": 21303,
"share": 10.4,
"pages": 460,
"traffic": 274945,
"value": 901517.59
}
]