[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Weekly Vimeo video performance report

> Pull views, average percent watched and completion for your Vimeo videos and see where viewers drop off. Weekly report from your agent, hosted.

Source: https://cotlet.dev/integrations/vimeo-api-mcp-server/report-video-performance

You want to know which videos hold attention. The numbers sit in the Engagement tab, behind date and video filters, and you export a CSV by hand each time.

Cotlet does it in your own Vimeo account with search\_videos and get\_video\_analytics, called by your AI agent, an n8n workflow or a script.

[Sign up free](https://cotlet.dev/app/signup?app=vimeo) [All Vimeo tools](https://cotlet.dev/integrations/vimeo-api-mcp-server.md)

Hosted · nothing to install or maintain

## Can Vimeo do this on its own?

Vimeo shows engagement in the app and says the Engagement analytics are not currently available through the public API (checked 17 Oct 2026). The official MCP server can pull analytics on a Pro plan or above, in beta. Scheduled reports of this table are the gap.

## How you do it in Vimeo today

1. Go to Analytics in the main navigation and select the Engagement tab.
2. Filter by date and by video.
3. Read the table: Views, Average % watched, Average completion rate and views at the 1%, 25%, 50%, 75% and 100% points.
4. For one video, open it from your Library and select the Analytics icon in the navigation on the right to see the retention graph.
5. Export the table as a CSV if you want it elsewhere, and repeat next week.

## How to weekly Vimeo video performance report

Prompt

```
Pull engagement for my Vimeo videos for the last 30 days. Show views, average percent watched and completion rate, and name the three videos where viewers drop off earliest.
```

1. 01  
### Pick the videos  
search\_videos returns the videos you named or the most recent ones, with their IDs, so the report covers the library you mean.
2. 02  
### Read the Engagement table  
get\_video\_analytics reads the table for your date range: views, average percent watched, completion rate and the views at each point of the video.
3. 03  
### Find the drop-off  
The agent compares views at 1% and at 25%. A video that loses the most viewers by the first quarter goes to the top of the early drop-off list.
4. 04  
### Report with the caveats  
The report says that engagement counts views, not unique viewers, so a replayed segment counts again.

### What you get back

Example data

```
Last 30 days, 3 videos
- Onboarding 01: 420 views, 58% average watched, 31% completion
- Pricing walkthrough: 310 views, 64% watched, 40% completion
- Admin training part 1: 190 views, 35% watched, 12% completion
Earliest drop-off: Admin training part 1 (190 views at 1%, 88 at 25%)
```

### Other ways to ask

- Compare this month with last month for my five most viewed videos.
- Show only videos with a completion rate under 20%.
- Every Monday, send me the table for videos published in the last 90 days.

## What Vimeo allows, and what to know first

- Completion rate counts a view as finished if it played to within 2 seconds of the end.
- Viewers who watch under 30 seconds and do not finish are not counted as engaged views, so the retention peak can sit below total views.
- Impressions are loads of the video, views are starts of playback, and view rate is views divided by impressions.
- The per-video analytics panel needs a paid plan and shows the past 30 days.

Every tool here only reads, so it can run weekly from n8n, Make, Zapier or cron without waiting for your OK.

Sources: [Vimeo Help: About engagement analytics](https://help.vimeo.com/hc/en-us/articles/44934439084561-About-engagement-analytics) · [Vimeo Help: Video Settings analytics panel](https://help.vimeo.com/hc/en-us/articles/46427311287313-Video-Settings-analytics-panel) · [Vimeo Help: About viewer retention stats](https://help.vimeo.com/hc/en-us/articles/21137121658897-About-viewer-retention-stats)

## Call get\_video\_analytics from a script

curl

```
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"
```

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
}
}
]
}
```

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is vimeo\_read → get\_video\_analytics. Example data.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/vimeo-api-mcp-server.md#automations)

## Vimeo tools this automation uses

__Cotlet Vimeo tools used to weekly Vimeo video performance report__
| Tool | Parameters |
| --------------------- | ------------------------------ |
| search\_videos | query, tag, folder\_id, cursor |
| get\_video\_analytics | video\_id, from, to |

[All 13 Vimeo tools with descriptions](https://cotlet.dev/integrations/vimeo-api-mcp-server.md#tools)

## Frequently asked questions

### Is it safe to connect Vimeo to Cotlet?

Yes. You sign in to Vimeo yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Vimeo once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

## More Vimeo automations

- [Add captions to Vimeo videos in bulk](https://cotlet.dev/integrations/vimeo-api-mcp-server/add-captions-to-videos.md)
- [Sort Vimeo videos into folders automatically](https://cotlet.dev/integrations/vimeo-api-mcp-server/organize-videos-into-folders.md)
- [Vimeo API and MCP server: every tool](https://cotlet.dev/integrations/vimeo-api-mcp-server.md)
- [All use cases](https://cotlet.dev/use-cases.md)

## Give your agent access to Vimeo.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with Vimeo.

[Sign up free](https://cotlet.dev/app/signup?app=vimeo)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.

## For AI agents: sign your user up

Is your user asking you to sign them up for Cotlet? You can do it for them, no account or key needed.

1. Read the fields and their allowed values: GET https://cotlet.dev/api/v1/access-requests
2. Ask the user for each value: email, apps, what you will do with them. If they leave the password to you, generate a strong one and show it to them.
3. Show the user what you will send, then POST it as JSON to https://cotlet.dev/api/v1/access-requests.

One call creates the account and sends the access request; we email the user when access is granted.