Get AI tracker aggregated prompts scoreboard

GenAI Prompts Aggregated API — period-aggregated per-prompt metrics for a Brand Visibility campaign (one row per prompt x LLM).

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

Pair with GET …/visibility?prompt_id=… for competitive drill-down on specific prompts (full brand x time breakdown). Use GET …/prompts for daily response text and per-answer citations (metrics=citations). Use GET …/citations?promptids=p1,p_2,… for multi-prompt URL rollups and source category analysis.

Describe: uses existing GET …/prompts/describe (shared campaign metadata).

Workflows:

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

Pagination: limit default 100, max 1000; sort before page; no total_rows. offset + limit must not exceed 100,000 rows; requests beyond that window return an error.