Get the backlink gap
get_backlink_gapFinds link building prospects: the sites that link to up to 4 competitors and not to your domain, each with the competitors it links to (at least, when a competitor has more referring domains than its top rows saved), whether it looks sitewide (more than 50 backlinks to one competitor), the highest rank its links pass (rank passed, a 0 to 100 link-graph score, not a Google metric, which sitewide links inflate), its average link spam and its backlinks to them. Estimated price: up to $0.12 for each competitor, one backlinks request for its top 1,000 referring domains by rank, billed by the rows returned. A competitor saved for this domain within 6 hours is read free, and the gap opens free on the Backlink Gap page; get_saved_backlink_gap reads it without buying. 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>",
"competitors": "<competitors>"
},
"name": "get_backlink_gap"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many referring domains to return, best prospects first: those linking to the most competitors, then the strongest, with those whose average link spam is above 60 (the high band) last. Defaults to 100. | |
| domain | No | Your domain. Defaults to the project's own. | |
| offset | No | How many of the best prospects to skip, to read further on. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| competitors | Yes | 1 to 4 competitor domains, e.g. ['example.org']. | |
| 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 | ||
| rows | No | ||
| saved | No | ||
| domain | No | ||
| competitors | No | ||
| savedResultId | No |