---
title: "Backlinks list"
method: POST
path: "/backlinks/list"
---

# Backlinks list

`POST /backlinks/list`

## Request

- Base URL: `https://www.agentseo.dev/api/v1`
- URL: `https://www.agentseo.dev/api/v1/backlinks/list`
- Auth: API key in header `x-api-key`

Return a bounded list of actionable backlinks and classify each one for authority protection, broken-target repair, lost-link reclaim, quality review, or outreach reference. Costs 5 credits per 100 requested backlinks, minimum 5.

## Query parameters

- `sync` boolean

## Headers

- `x-project-id` string
- `x-workflow-id` string

## Request body

- BacklinksListParams
  - `target` string, required: Domain, subdomain, or absolute page URL to analyze.
  - `mode` 'as_is' | 'one_per_domain' | 'one_per_anchor'
  - `limit` integer
  - `offset` integer
  - `backlinks_status_type` 'live' | 'all' | 'lost'
  - `include_subdomains` boolean
  - `include_indirect_links` boolean
  - `exclude_internal_backlinks` boolean
  - `intersection_mode` 'all' | 'partial': Use partial for tighter shared-source intersections, or all for broader scans that may take longer.
  - `dofollow_only` boolean
  - `broken_only` boolean
  - `min_rank` integer
  - `sort_by` 'rank' | 'page_rank' | 'first_seen' | 'lost_date'
  - `rank_scale` 'one_hundred' | 'one_thousand'

## Response `200`

Completed backlinks list workflow with agent_workflow

- BacklinksListResponse
  - `target` string
  - `backlinks_list` object
  - `agent_workflow` AgentWorkflow
    - `summary` string
    - `decision` 'ready' | 'act_now' | 'monitor' | 'blocker'
    - `confidence` number
    - `recommended_actions` AgentWorkflowAction[]
      - `priority` 'critical' | 'high' | 'medium' | 'low'
      - `action` string
      - `why` string
    - `evidence` AgentWorkflowEvidence[]
      - `finding` string
      - `detail` string
      - `severity` 'critical' | 'high' | 'medium' | 'low'
    - `limitations` string[]
    - `next_calls` AgentWorkflowNextCall[]
      - `endpoint` string
      - `reason` string
  - `markdown_summary` string

## Other responses

- `202`: Job queued or still processing

---

[API](https://skmtc.dev/agentseo/apis/agentseo-api.md) · [All operations](https://skmtc.dev/agentseo/apis/agentseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentseo/apis/agentseo-api/revisions/53a62da6f92c?raw)