Backlinks list

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.

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

Query parameters

syncboolean

Open a short inline processing window when supported by the endpoint. If the result is not ready yet, the endpoint may still return 202 with a queued payload that includes poll_url, events_url, and retry_after_seconds.

Headers

x-project-idstring

Optional attribution label for grouping usage and jobs by project.

x-workflow-idstring

Optional attribution label for grouping usage and jobs by workflow or agent run.

Request body

targetstring required

Domain, subdomain, or absolute page URL to analyze.

mode'as_is' | 'one_per_domain' | 'one_per_anchor'
limitinteger
offsetinteger
backlinks_status_type'live' | 'all' | 'lost'
include_subdomainsboolean
include_indirect_linksboolean
exclude_internal_backlinksboolean
intersection_mode'all' | 'partial'

Use partial for tighter shared-source intersections, or all for broader scans that may take longer.

dofollow_onlyboolean
broken_onlyboolean
min_rankinteger
sort_by'rank' | 'page_rank' | 'first_seen' | 'lost_date'
rank_scale'one_hundred' | 'one_thousand'

Response

Completed backlinks list workflow with agent_workflow

targetstring
backlinks_listobject
markdown_summarystring

Changes

No recorded changes to this operation across all 1 revision of this API.