visibility.md

Visibility

Retrieve visibility metrics, citations, competitors, and prompt reports from the Lightsage CLI.

Visibility commands retrieve computed metrics from stored prompt results. They do not start new prompt runs.

Command	Description
`lightsage visibility current-retrieve`	Retrieve the current visibility score and share of voice.
`lightsage visibility overview-retrieve`	Retrieve the visibility summary, trends, platform breakdown, and competitors.
`lightsage visibility citations-list`	List the most cited URLs.
`lightsage visibility prompts-retrieve`	Retrieve per-topic and per-prompt visibility metrics.

lightsage visibility current-retrieve

Filter by date range:

lightsage visibility current-retrieve \
  --start-date 2026-08-01 \
  --end-date 2026-08-31

The response includes the visibility score, share of voice, platform ranks, and date-range metadata.

lightsage visibility overview-retrieve

The overview adds daily trends, per-platform breakdowns, and competitor comparisons to the current snapshot.

lightsage visibility citations-list

Filter by platform, source type, or limit:

lightsage visibility citations-list \
  --platform chatgpt \
  --source-type owned \
  --limit 50

Source type values: all, owned, external.

lightsage visibility prompts-retrieve

Returns per-topic and per-prompt visibility metrics including score, rank, share of voice, average position, and citation counts.