---
title: "Backlinks opportunity finder"
method: POST
path: "/backlinks/opportunity-finder"
---

# Backlinks opportunity finder

`POST /backlinks/opportunity-finder`

## Request

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

Turn supplied backlink prospects, competitor link-gap exports, and owned linkable assets into prioritized safe outreach, reclaim, repair, and digital PR actions. Costs 2 credits and does not call a paid backlink provider directly.

## Query parameters

- `sync` boolean

## Headers

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

## Request body

- BacklinksOpportunityFinderParams
  - `target` string, required: Target domain, brand, or site.
  - `campaign_goal` 'mixed' | 'link_gap' | 'broken_link_building' | 'digital_pr' | 'resource_page' | 'reclaim_lost_links' | 'protect_authority'
  - `prospects` object[], required
    - `source_domain` string, required
    - `source_url` string, uri
    - `title` string
    - `source_type` 'resource_page' | 'article' | 'directory' | 'tool_list' | 'news' | 'partner' | 'unknown'
    - `linked_competitors` string[]
    - `topics` string[]
    - `domain_rank` number
    - `page_rank` number
    - `spam_score` number
    - `broken_link` boolean
    - `lost_link` boolean
  - `owned_assets` object[]
  - `competitor_domains` string[]
  - `existing_backlink_domains` string[]
  - `max_opportunities` integer
  - `min_priority` 'low' | 'medium' | 'high'
  - `max_spam_score` integer
  - `include_outreach_angles` boolean

## Response `200`

Completed backlinks opportunity workflow with agent_workflow

- BacklinksOpportunityFinderResponse
  - `target` string
  - `backlinks_opportunity_finder` 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)