Get video analytics
Read the Engagement table for a date range.
MCP tool vimeo_read → get_video_analytics
read
Returns the Engagement table: views, average percent watched, average completion rate and the views reached at 1%, 25%, 50%, 75% and 100% of the video. It counts views, not unique viewers. The per-video panel needs a paid plan, so on a Free plan the call returns an error that says so.
Parameters
| Name | Type | Description |
|---|---|---|
| video_id string | string | One video from search_videos. Omit for all videos. |
| from string | string | Start date, YYYY-MM-DD. |
| to string | string | End date, YYYY-MM-DD. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "vimeo_read",
"arguments": {
"operation": "get_video_analytics",
"arguments": {
"video_id": "912345601",
"from": "2026-09-17",
"to": "2026-10-17"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"from": "2026-09-17",
"to": "2026-10-17",
"videos": [
{
"video_id": "912345601",
"title": "Onboarding 01",
"views": 420,
"average_percent_watched": 58,
"average_completion_rate": 31,
"views_at": {
"p1": 420,
"p25": 300,
"p50": 210,
"p75": 150,
"p100": 130
}
}
]
},
"isError": false
}