Skip to main content
GET
List Opportunities

Authorizations

X-Lightsage-Api-Key
string
header
required

Query Parameters

since
string

Relative or absolute start date for opportunity analysis, such as 30d, 72h, or 2026-06-01. Ignored when start_date is provided.

start_date
string

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

end_date
string

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

category
enum<string>

Filter opportunities to a high-level category.

Available options:
quick_wins,
growth,
refresh,
citations
opportunity_type
enum<string>

Filter opportunities to a specific opportunity type.

Available options:
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
limit
integer
default:50

Maximum number of ranked opportunities to return.

Required range: 1 <= x <= 200

Response

Successful Response

start_date
string
required
end_date
string
required
count
integer
required
data
PublicPromptOpportunity · object[]
summary
Summary · object