USusesapient
Opportunities

List Opportunities

Returns ranked opportunities from stored prompt visibility results.

The default window is the previous 30 days. Each opportunity includes an execution_prompt with the context an AI agent needs to address it. Results are recomputed for the requested window, but this endpoint does not run new prompts.

get/v1/opportunities

Request

  • Base URL
    https://api.lightsage.com
  • Auth
    API key in header X-Lightsage-Api-Key

Query parameters

sincestring

The relative or absolute window start, such as 30d, 72h, or 2026-06-01. Ignored when start_date is set.

start_datestring

Inclusive analysis start date (YYYY-MM-DD).

end_datestring

Inclusive analysis end date (YYYY-MM-DD). Defaults to today.

category'quick_wins' | 'growth' | 'refresh' | 'citations'
opportunity_type'almost_winning' | 'negative_sentiment' | 'lost_wins' | 'competitor_gaps' | 'untapped_topics' | 'platform_blind_spots' | 'content_gaps' | 'declining_visibility' | 'volatile_visibility' | 'citation_gaps' | 'high_citation_sources' | 'listicle_targets'
limitinteger

Response

Successful Response

start_datestring required

Window start actually used, after resolving start_date, since, or the default.

end_datestring required
countinteger required

Capped by limit; not the total available.

summaryobject

Breakdowns of the returned items only; each sums to count.

Changes

No operation changes recorded.