Get video analytics
Read the Engagement table for a date range.
GET https://cotlet.dev/api/v1/vimeo/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. |
Request
curl "https://cotlet.dev/api/v1/vimeo/video-analytics?video_id=912345601&from=2026-09-17&to=2026-10-17" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("vimeo", "get_video_analytics", {"video_id":"912345601","from":"2026-09-17","to":"2026-10-17"})const result = await cotlet.call('vimeo', 'get_video_analytics', {"video_id":"912345601","from":"2026-09-17","to":"2026-10-17"});cotlet call vimeo get_video_analytics --data '{"video_id":"912345601","from":"2026-09-17","to":"2026-10-17"}'Example response
{
"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
}
}
]
}