Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
List the domains linking to a target from Ahrefs Site Explorer with Domain Rating, number of links, dofollow links, new and lost links, spam flag and dates
| App | Ahrefs |
| Operation ID | ahrefs_get_referring_domains |
| Type | Action |
| Connection | ahrefs (required) |
| Credits per run | Free |
| Agent / MCP tool | Yes |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
target | string | Yes | - | The domain, subdomain, subfolder or URL to list referring domains for (e.g. example.com). |
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). |
history | string or SelectableOption | No | all_time | ’live’ counts only currently live backlinks; ‘all_time’ also includes lost ones. Ignored when since_date is set. |
since_date | string | No | - | Include backlinks lost since this date (YYYY-MM-DD) in addition to live ones. Overrides history. |
metrics | array of string or SelectableOption | No | - | Columns to return (domain is always included). Available: domain_rating, links_to_target, dofollow_links, new_links, lost_links, first_seen, last_seen, is_spam, is_root_domain, ip_source, traffic_domain, positions_source_domain, dofollow_refdomains, dofollow_linked_domains. Ahrefs API unit cost per row: traffic_domain costs 10 units, dofollow_refdomains 5, the rest 1. Defaults to domain_rating, links_to_target, dofollow_links, first_seen, last_seen, is_spam. |
filters | array of FilterItem | No | - | Filters on the available columns, e.g. domain_rating GREATER_THAN 50 or is_spam EQUALS false. Filter fields count towards the unit cost per row. |
orders | array of OrderItem | No | - | Sort by one or more columns. |
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 referring domain with the selected Ahrefs fields: domain, domain_rating, links_to_target, dofollow_links, new_links, lost_links, first_seen, last_seen, is_spam, is_root_domain, ip_source, traffic_domain, positions_source_domain, dofollow_refdomains, dofollow_linked_domains.
Fields: domain, domain_rating, links_to_target, dofollow_links, first_seen, last_seen, is_spam
Example:
[
{
"domain": "google.com",
"domain_rating": 99.0,
"links_to_target": 326,
"dofollow_links": 127,
"first_seen": "2013-08-19T17:59:53Z",
"last_seen": null,
"is_spam": false
}
]