get_referring_domains
The domains linking to a client's site, from the workspace's STORED DataForSEO answer (no new request, no charge), each with DataForSEO Rank, backlinks, first seen by DataForSEO, lost date, spam score, follow state and whether AI engines cited the domain in this client's own measured answers (citedByAI: answers of answersTotal in the window). Filters work on the rows that were pulled (rows of totalAtDataForSeo). Reads the stored answer of the asked status only (live links by default, lost links with status "lost"): lost links are never shown as current, and the result names its status. With no stored answer it says so; run_link_lookup buys one.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"clientId": "<clientId>"
},
"name": "get_referring_domains"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows returned, default 50. | |
| domain | No | Domain to read. Default: the client's own. | |
| follow | No | Only domains whose links are all follow, all nofollow, or mixed. | |
| status | No | Which stored answer to read: live links (default) or lost links. They are different lookups; the result says which it is. | |
| minRank | No | Only domains with DataForSEO Rank at least this. | |
| clientId | Yes | Client id (from list_clients). | |
| aiCitedOnly | No | Only domains AI engines cited in this client's answers. | |
| firstSeenFrom | No | Only domains first seen by DataForSEO on or after this day (YYYY-MM-DD). |