Prompts

Returns prompt-level metrics for a Brand Visibility campaign, period-aggregated (one row per prompt x LLM).

Use for weekly scoreboards, prompt monitoring, and competitive prompt analysis.

Workflows:

1. Weekly scoreboard (flat metrics only, agent-friendly): GET …/prompts/aggregated?campaign_id={id}&metrics=visibility,competitors_avg_visibility,pop_change&sort=visibility&asc=false
2. Competitor gap analysis (nested brand detail): GET …/prompts/aggregated?campaign_id={id}&metrics=visibility,brand_visibility,competitors_avg_visibility&sort=visibility&asc=true
3. Win/lose classification (flat only): GET …/prompts/aggregated?campaign_id={id}&metrics=visibility,competitors_avg_visibility
4. Competitive drill-down (identify, then drill into visibility endpoint): GET …/prompts/aggregated?campaign_id={id}&metrics=visibility,brand_visibility,pop_change&sort=visibility&asc=true (then GET …/visibility?campaign_id={id}&prompt_id={id} for brand x time breakdown)
5. Multi-LLM pivot: GET …/prompts/aggregated?campaign_id={id} (omit llms; pivot by llm_source)

Pagination: limit default 100, max 1000; sort before page; no total_rows.

Complementary End-points

Use GET …/prompts for daily response text and per-answer citations (metrics=citations).

Use GET …/prompts/describe for shared campaign metadata.