Marketing
Vimeo in your product and your AI agents, through one API
The Vimeo toolkit covers the videos of the connected account, their folders and their comments. Your product or AI agent can read video details and play counts, update titles and privacy, move videos between folders and reply to comments through Connect, which handles the OAuth connection and logs every execution.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/vimeo_create_folder/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}How it works
From a connected customer to the first Vimeo call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Vimeo account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Vimeo.
Video library inside your product
A SaaS lists the customer's Vimeo videos with name, link, embed code and stats.plays and shows them in its own interface.
Organize client videos
An agency tool creates a folder per client, nests subfolders and moves each video to the right one.
Community reply agent
An AI agent reads the comments of a video and posts a reply as the connected user.
Tools
10 Vimeo tools
- List videosGETLists the videos the connected user uploaded, with uri, name, description, link, duration, privacy, parent_folder, tags, embed code and stats.plays, the play count. The id of a video is the number at the end of its uri. Pagination by page: the list ends when paging.next is null. Send fields to get a smaller answer and twice the rate limit.
- Get videoGETReturns one video: name, description, link, duration, dimensions, privacy, status, parent_folder, tags, embed code, thumbnails and stats.plays, the play count. Send fields to get a smaller answer and twice the rate limit.
- Update videoPATCHUpdates the title, description, privacy or license of a video of the connected user and returns it. Fields left out keep their value. Some privacy options, like password and team, depend on the plan of the account.
- List foldersGETLists the folders of the connected user, with uri, name, link, dates and the number of videos in metadata.connections.videos.total. The id of a folder is the number at the end of its uri. Pagination by page: the list ends when paging.next is null.
- Create folderPOSTCreates a folder for the connected user and returns it with its uri. Without parent_folder_uri it is a top-level folder; folders nest up to 10 levels.
- Update folderPATCHRenames a folder of the connected user and returns it.
- List folder videosGETLists the videos of a folder, with uri, name, description, link, duration, privacy, tags and stats.plays, the play count. Pagination by page: the list ends when paging.next is null. Send fields to get a smaller answer and twice the rate limit.
- Move video to folderPUTPuts a video in a folder of the connected user, who must own the folder. Answers 204 with no body when it works.
- List video commentsGETLists the comments of a video, with uri, text, author, date and the number of replies in metadata.connections.replies.total. The id of a comment is the number at the end of its uri. Pagination by page: the list ends when paging.next is null.
- Create comment replyPOSTReplies to a comment of a video as the connected user and returns the reply, which is public like any comment of the video.
OAuth with your product's app
You register your product's OAuth app once, with POST /api/merchants/credentials/vimeo, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.
Questions about the Vimeo toolkit
Do I need to build against the Vimeo API?
No. Connect ships 10 Vimeo tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Vimeo account?
With the mode the toolkit accepts: OAuth with your product's app. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
