# Get video insights (`get_insights`)
> Pulls a workspace-level dashboard for one metric, such as KPIs, top videos, views over time, geography, or conversions.
- Area: [Analytics & insights](https://mcp.dadan.io/tools/analytics.md)
- Access: Read-only
- AI credits: no
- Available on read-only connections: yes
- Status: limited data (see limitations)

## Example prompt
"Show me my top videos this month"

## Parameters
- `metric` (string, required): Which dashboard: kpi, top_videos, views_over_time, retention, geo, conversions, or traffic_sources.
- `from` (string): Optional start of the date range (ISO-8601). Omit for the default period.
- `to` (string): Optional end of the date range (ISO-8601).

## Description for AI assistants
Get a workspace-level analytics dashboard for one metric across all videos. metric is one of: 'kpi' (headline totals), 'top_videos', 'views_over_time', 'retention', 'geo' (by country), 'conversions', 'traffic_sources'. Optionally scope to a date range with from/to. Returns the metric's data; use it to answer 'how is my whole library performing' questions.


## Known limitations

- Unreliable in testing: calls to the kpi and top_videos segments both failed outright on 2026-08-01 rather than returning data. Prefer analyze_library, which covers top performers and library-level analysis and is verified working.
- Workspace-level and plan-gated; a gated call returns upgrade_required.
- Per-video rows are filtered to videos the caller can actually access, so an account whose videos aren't on the platform-wide leaderboard can honestly get an empty list.
Canonical page: https://mcp.dadan.io/tools/get-insights
