Built-in tool
List Referring Domains
List and rank the domains linking to a website or page, including authority, backlink count, dofollow/nofollow split, spam score, and whether the link is still live.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| targetstring · required | string | required | Domain, subdomain, or absolute page URL to analyze. |
| limitnumber · optional | number | optional | Maximum records to return (1-1000). Defaults to 100. Default: |
| dofollow_onlyboolean · optional | boolean | optional | Only count/return dofollow links. Defaults to false. Default: |
| include_subdomainsboolean · optional | boolean | optional | Include links to subdomains. Defaults to true. Default: |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"elements"
],
"properties": {
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": [
"number",
"null"
]
},
"domain": {
"type": [
"string",
"null"
]
},
"is_live": {
"type": [
"boolean",
"null"
],
"description": "True while this domain still links to the target (i.e. lost_date is empty)."
},
"backlinks": {
"type": [
"number",
"null"
]
},
"lost_date": {
"type": [
"string",
"null"
],
"description": "ISO-8601 timestamp of when the last backlink from this domain was lost. Null means none has been lost — the domain still links here."
},
"first_seen": {
"type": [
"string",
"null"
],
"description": "ISO-8601 timestamp of when the crawler first saw a backlink from this domain."
},
"spam_score": {
"type": [
"number",
"null"
]
},
"referring_pages": {
"type": [
"number",
"null"
]
},
"broken_backlinks": {
"type": [
"number",
"null"
]
},
"dofollow_referring_pages": {
"type": [
"number",
"null"
]
},
"nofollow_referring_pages": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": true
}
},
"returned": {
"type": "number",
"description": "How many rows this run returned, after any Limit was applied."
},
"truncated": {
"type": "boolean"
},
"suggestion": {
"type": "string"
},
"totalCount": {
"type": "number",
"description": "How many records the provider says MATCH in total, independent of Limit — routinely in the millions (spotify.com has 2,583,327 ranking pages). It is a match count, NOT how many this endpoint will serve: Limit caps what one call returns, so do not compare it against the row count to judge completeness and do not paginate towards it. Absent when the provider sent no count."
},
"totalElements": {
"type": "number",
"description": "DEPRECATED — despite the name this is the count RETURNED by this run, not a grand total, so it equals your Limit on a limited run. Kept at that value deliberately: ENG-17058 asked for depth 5 to report 5, and it is a live number in existing flows. Use `returned` for this number or `totalCount` for how many records match."
}
},
"additionalProperties": true
}