Search videos
Search your library by title, tag or folder and return video details.
GET https://cotlet.dev/api/v1/vimeo/videos/search
read
Returns videos from your library, newest first, with title, tags, privacy, folder and caption languages. Narrow it with a folder or a tag. Each call returns one page; pass the cursor to continue. It sees what your account sees, so a team member sees the Team library only with access.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Words in the title. |
| tag string | string | Only videos with this tag. |
| folder_id string | string | Folder ID from list_folders. Omit for the whole library; 'none' for videos in no folder. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/vimeo/videos/search \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("vimeo", "search_videos")const result = await cotlet.call('vimeo', 'search_videos');cotlet call vimeo search_videosExample response
{
"videos": [
{
"video_id": "912345601",
"title": "Onboarding 01",
"tags": [
"onboarding"
],
"privacy": "unlisted",
"folder": "Training",
"caption_languages": [],
"duration_seconds": 412,
"uploaded_at": "2026-10-12T08:20:00Z"
},
{
"video_id": "912345611",
"title": "Webinar: Q3 results",
"tags": [
"webinar"
],
"privacy": "private",
"folder": null,
"caption_languages": [
"en"
],
"duration_seconds": 3120,
"uploaded_at": "2026-10-14T14:05:00Z"
}
],
"next_cursor": null
}