AgentSEO Backlinks List
agentseo_backlinks_listDestructive
Retrieve a bounded list of actionable backlinks and classify each for protection, repair, reclaim, quality review, or outreach reference.
Instructions
Return a bounded list of actionable backlinks and classify each one for protection, repair, reclaim, quality review, or outreach reference. Uses AgentSEO credits; repeating the call can create new charged work.
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": {
"target": "<target>"
},
"name": "agentseo_backlinks_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Backlink grouping strategy: raw rows, at most one row per referring domain, or at most one row per anchor. Type: String. Accepted values: "as_is", "one_per_domain", "one_per_anchor". Default: "one_per_domain". | one_per_domain |
| sync | No | Request a bounded wait for completion when true. The API can still return a pending job; retain its job ID and poll agentseo_job_status instead of repeating this charged call. False returns a queued job without waiting. Type: Boolean. Default: true. | |
| limit | No | Maximum number of backlink rows to return for this page of results. Type: Safe integer. Minimum: 1. Maximum: 100. Default: 25. | |
| offset | No | Zero-based result offset measured in rows; use with limit for pagination. Type: Safe integer. Minimum: 0. Maximum: 20000. Default: 0. | |
| target | Yes | Target domain, subdomain or absolute page URL to analyze; use a hostname or URL, not a business name. Type: String. Minimum: 1 characters. Required. | |
| sort_by | No | Metric used to order returned results; choose one of this tool’s accepted enum values. Type: String. Accepted values: "rank", "page_rank", "first_seen", "lost_date". Default: "rank". | rank |
| min_rank | No | Minimum provider backlink authority score, not a Google search position; use the supported score scale and stated input bounds. Type: Safe integer. Minimum: 0. Maximum: 100. Optional; no client default. | |
| rank_scale | No | Requested provider authority-score scale: one_hundred is 0-100; one_thousand is 0-1000. Individual filter input bounds still apply. Type: String. Accepted values: "one_hundred", "one_thousand". Default: "one_hundred". | one_hundred |
| broken_only | No | Restrict results to backlinks associated with broken target pages when true. Type: Boolean. Default: false. | |
| dofollow_only | No | Restrict results to followed backlinks when true; false does not apply that filter. Type: Boolean. Default: false. | |
| intersection_mode | No | Whether matches must cover every supplied target (all) or a supported subset (partial). Type: String. Accepted values: "all", "partial". Default: "partial". | partial |
| include_subdomains | No | Include links or ranking data for subdomains of the target when true. Type: Boolean. Default: true. | |
| backlinks_status_type | No | Backlink lifecycle filter: live links only, lost links only, or all supported links. Type: String. Accepted values: "live", "all", "lost". Default: "live". | live |
| include_indirect_links | No | Include backlinks that reach the target through supported indirect/redirect link relationships when true. Type: Boolean. Default: true. | |
| exclude_internal_backlinks | No | Exclude links originating within the target’s own site when true. Type: Boolean. Default: true. |