Find SEO opportunities

Find prioritized keyword and page opportunities for a domain or URL. Costs 3 credits base, plus 2 credits for SERP competitor enrichment and 2 credits for domain competitor discovery.

post/opportunities/find

Request

  • Base URL: https://www.agentseo.dev/api/v1
  • URL: https://www.agentseo.dev/api/v1/opportunities/find
  • 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 or URL to analyze.

locationstring
location_codeinteger

Optional search location code for deterministic geo-targeting.

languagestring
keyword_limitinteger
opportunity_limitinteger
include_serp_competitorsboolean

Adds SERP competitor enrichment and increases request cost by 2 credits.

include_competitor_discoveryboolean

Adds domain competitor discovery and increases request cost by 2 credits.

Response

Completed opportunity finder workflow with priorities and agent_workflow

targetstring
competitorsobject[]
markdown_summarystring

Changes

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