Get a backlinks profile
get_backlinks_profileReturns one page of backlink rows for a domain or URL, with filters, sorting, a mode and paging. Every link is live; lost links are not bought. Estimated price: ~$0.06 for 50 rows, ~$0.07 for 200, billed by the rows returned. It is the Backlinks page's own table: a page bought here opens free there and the other way round, while its saved copy is current. Each call may spend up to the workspace's agent spend limit ($2.00 unless changed in Settings) without asking: it holds at most its estimate plus a margin while it runs and is charged what it bought, never more. A call whose maximum is above the limit is refused before anything is bought, with its estimate and maximum: ask the user, then call again with approvedMaxCostUsd set to the amount they approved.
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": {
"projectId": "<projectId>",
"target": "<target>"
},
"name": "get_backlinks_profile"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | one_per_domain (default) returns the strongest link of each linking domain; as_is returns every backlink row. | one_per_domain |
| page | No | ||
| scope | No | Which part of the site to research. One of: exact_url (a single page), subfolder (the path and everything under it), domain (the hostname without subdomains), subdomains (the hostname plus all of its subdomains). Defaults to subdomains for a bare domain and to subfolder when the input includes a path. The earlier name "page" is deprecated; it is read as exact_url. Subfolder counts are derived from filtered backlink totals, so rank, trends and the referring domains breakdown are unavailable for a subfolder. | |
| target | Yes | Domain or URL whose backlinks to list. | |
| filters | No | Narrow the rows: source URL terms to include or exclude, domain rank and link rank ranges, link spam, dofollow or nofollow, hide broken links, or an exact linking domain. | |
| hideSpam | No | Leave out rows whose spam score is above 60. Defaults to false. | |
| pageSize | No | Rows per page: 50, 100, 200. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| sortField | No | firstSeen | |
| sortOrder | No | desc | |
| approvedMaxCostUsd | No | The most, in USD, the user approved for this call after seeing its estimate and maximum. Only needed after a call was refused for costing more than the workspace's agent spend limit; never set it without asking the user. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| meta | No | ||
| scope | Yes | ||
| target | Yes | ||
| backlinks | Yes | ||
| savedResultId | No |