Actions

Actions are prompt-level work items Lightsage derives from Visibility data. Use them to inspect cited pages and opportunities found from existing prompt results. The response contains two sections:

opportunities: content, competitor, sentiment, visibility, and citation opportunities.
cited_pages: pages cited in AI answers, with citation counts and page metadata.

Command

Command	Description
`lightsage prompts actions list`	List prompt actionables.

List actionables

List both sections:

lightsage prompts actions list --tag all --limit 25

Return only opportunities:

lightsage prompts actions list \
  --tag opportunities \
  --category quick_wins \
  --opportunity-type citation_gaps

Return only cited pages:

lightsage prompts actions list \
  --tag cited_pages \
  --prompt-ids prompt_123,prompt_456 \
  --cited-pages-limit 50

Filter by date window:

lightsage prompts actions list \
  --start-date 2026-05-01 \
  --end-date 2026-05-23

Example response:

{
  "start_date": "2026-05-01",
  "end_date": "2026-05-23",
  "tag": "all",
  "opportunities": [
    {
      "id": "opp_123",
      "type": "citation_gaps",
      "category": "citations",
      "priority": "high",
      "title": "Improve citations for API authentication docs",
      "description": "Competitor docs are cited more often for authentication prompts.",
      "action": "Add clearer authentication examples and troubleshooting guidance.",
      "impact_score": 87.5,
      "created_at": "2026-05-23T00:00:00Z"
    }
  ],
  "opportunity_count": 1,
  "cited_pages": [
    {
      "url": "https://docs.example.com/authentication",
      "domain": "docs.example.com",
      "title": "Authentication",
      "is_company_link": true,
      "citation_count": 14
    }
  ],
  "cited_page_count": 1,
  "summary": {
    "by_category": {
      "citations": 1
    }
  }
}

Useful filters:

Flag	Description
`--tag`	Return `cited_pages`, `opportunities`, or `all`. Defaults to `all`.
`--since`	Relative lookback window such as `7d` or `72h`.
`--start-date`	Inclusive start date.
`--end-date`	Inclusive end date.
`--category`	Opportunity category, such as `quick_wins`, `growth`, `refresh`, or `citations`.
`--opportunity-type`	Opportunity type, such as `citation_gaps` or `competitor_gaps`.
`--topic-id`	Restrict results to one topic.
`--prompt-ids`	Comma-separated prompt IDs.
`--include-cited-pages`	Include cited page details when `--tag all` is used.
`--limit`	Maximum opportunities to return.
`--cited-pages-limit`	Maximum cited pages to return.

CLI Reference

Prompts

API Performance

Command

List actionables

​Command

​List actionables

Command

List actionables