---
type: "firecrawl-provider"
description: "Public Vimeo video data: the full spoken transcript or caption track of a video as WebVTT cues (human-uploaded and Vimeo's auto-generated tracks, with provenance), the list of text tracks a video carries, video detail (title, description, duration, dates, plays, likes, comments, tags, categories, content rating, privacy), keyword search over public videos, and the videos of a channel or a user. Transcripts come from the player embed's inline playerConfig and the signed WebVTT files it points to; everything else uses Vimeo's own API 3.4 with the anonymous public-scope token vimeo.com issues to every visitor. No login, no cookies."
use_when: "Public Vimeo video data: the full spoken transcript or caption track of a video as WebVTT cues (human-uploaded and Vimeo's auto-generated tracks, with provenance), the list of text tracks a video carries, video detail (title, description, duration, dates, plays, likes, comments, tags, categories, content rating, privacy), keyword search over public videos, and the videos of a channel or a user. Transcripts come from the player embed's inline playerConfig and the signed WebVTT files it points to; everything else uses Vimeo's own API 3.4 with the anonymous public-scope token vimeo.com issues to every visitor. No login, no cookies."
categories: "Social"
capabilities: 6
credits_per_call: 5
---
# Vimeo on Firecrawl Alexandria

Public Vimeo video data: the full spoken transcript or caption track of a video as WebVTT cues (human-uploaded and Vimeo's auto-generated tracks, with provenance), the list of text tracks a video carries, video detail (title, description, duration, dates, plays, likes, comments, tags, categories, content rating, privacy), keyword search over public videos, and the videos of a channel or a user. Transcripts come from the player embed's inline playerConfig and the signed WebVTT files it points to; everything else uses Vimeo's own API 3.4 with the anonymous public-scope token vimeo.com issues to every visitor. No login, no cookies.

- Categories: Social
- Category index: [Social category](https://alexandria.firecrawl.dev/agents/categories/social)
- Provider key: `vimeo-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/vimeo-com)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/openapi.json)

## Capabilities

- [Get video](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/get_video): Detail of one public Vimeo video from Vimeo API 3.4 (api.vimeo.com/videos/{id}) with the anonymous public token: title, description, canonical link, duration, dimensions, spoken language, created/release/modified times, content rating, license, privacy (view/embed/download), thumbnails, tags, categories, play count (null when the owner hides it), like and comment totals, text track count and the owner. An unknown video id is not_found; private videos are not visible to the anonymous token and also answer not_found.
- [Get video transcript](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/get_video_transcript): The complete transcript of one public Vimeo video as timed WebVTT cues plus the joined plain text. Loads the player embed page (player.vimeo.com/video/{id}), reads the inline playerConfig, picks the text track for the requested language (or the track the player marks default, else the first track), downloads its signed WebVTT file and parses the cues (formatting tags stripped). Reports the chosen track's id, language, label, kind (subtitles/captions) and provenance (user_uploaded or ai_generated) and lists every other track. A video with no text tracks succeeds with an empty cue list and a warning; an unknown or removed video id is not_found.
- [List channel videos](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/list_channel_videos): Videos of one public Vimeo channel (Vimeo API 3.4 api.vimeo.com/channels/{channel}/videos, anonymous public token), by channel name (staffpicks) or numeric id (927), newest additions first by default. Same video summary rows as search_videos, with `total`, `next_page` and `continuation`. An unknown channel is not_found.
- [List user videos](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/list_user_videos): Public videos uploaded by one Vimeo user (Vimeo API 3.4 api.vimeo.com/users/{user}/videos, anonymous public token), by vanity name (staff) or numeric user id (152184), newest first by default. Same video summary rows as search_videos, with `total`, `next_page` and `continuation`. An unknown user is not_found.
- [List video text tracks](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/list_video_text_tracks): Every caption or subtitle track of one public Vimeo video, from the player embed's inline playerConfig: track id, language code, label, kind and provenance (user_uploaded or ai_generated), plus the video's title, duration and owner. The signed download URLs themselves are not returned because they expire within the hour; call get_video_transcript for the content. A video with no tracks returns an empty list; an unknown video id is not_found.
- [Search videos](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/search_videos): Keyword search over public Vimeo videos through Vimeo API 3.4 (api.vimeo.com/videos?query=) with the anonymous public token. Sort by relevance, date, alphabetical, plays, likes, comments or duration; optionally restrict to videos with closed captions. Each hit carries id, URL, title, description, duration, created and release times, plays (null when hidden), likes, comments, the largest thumbnail and the owner. Pages of up to 50; `continuation` reports whether another page exists and `next_page` is its number. A query that matches nothing succeeds with an empty list. Vimeo caps search at 15 requests per anonymous token; a fresh token is minted per call.

## 1. Choose this provider when

Public Vimeo video data: the full spoken transcript or caption track of a video as WebVTT cues (human-uploaded and Vimeo's auto-generated tracks, with provenance), the list of text tracks a video carries, video detail (title, description, duration, dates, plays, likes, comments, tags, categories, content rating, privacy), keyword search over public videos, and the videos of a channel or a user. Transcripts come from the player embed's inline playerConfig and the signed WebVTT files it points to; everything else uses Vimeo's own API 3.4 with the anonymous public-scope token vimeo.com issues to every visitor. No login, no cookies.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "vimeo-com",
  "capability": "videos/get_video",
  "options": {
    "video_id": "76979871"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `video_id` (string, required): Numeric Vimeo video id or a vimeo.com / player.vimeo.com video URL containing it. Example: `<video_id>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "vimeo-com",
    capability: "videos/get_video",
    options: {
      video_id: "76979871",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "vimeo-com",
  "capability": "videos/get_video",
  "options": {
    "video_id": "76979871"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "vimeo-com",
    "capability": "videos/get_video",
    "options": {
      "video_id": "76979871"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'vimeo-com/videos/get_video' \
  --options '{"video_id":"76979871"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "vimeo-com",
  "capability": "videos/get_video",
  "options": {
    "video_id": "76979871"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "vimeo-com",
  "capability": "videos/get_video",
  "options": {
    "video_id": "76979871"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "categories": [],
  "comments": 60,
  "content_rating": [
    "safe"
  ],
  "country": "US",
  "created_time": "2013-10-15T18:08:29+00:00",
  "description": "It may look (mostly) the same on the surface, but under the hood we totally rebuilt our player. Here’s a quick rundown of some of the coolest new features:\n\n• Lightning fast playback\n• Redesigned Share screen\n• Closed caption and subtitle compatible\n• HTML5 by default\n• Purchase-from-player functionality for embedded Vimeo On Demand trailers\n• More responsive than ever (go ahead, resize it, we dare you!!!)\n\nWe’re really proud of these updates. So proud that we made a spiffy new page to showcase all the reasons why we have the best video player in the galaxy. Check it out here: http://vimeo.com/player\n\nIn short, this is a player that even haters can love.",
  "duration_seconds": 62,
  "height": 720,
  "language": "en",
  "license": null,
  "likes": 2369,
  "modified_time": "2026-11-08T12:48:05+00:00",
  "observed_at_ms": 1794149048733,
  "owner": {
    "name": "Vimeo",
    "url": "https://vimeo.com/staff",
    "user_id": "152184"
  },
  "plays": null,
  "privacy": {
    "download": false,
    "embed": "public",
    "view": "anybody"
  },
  "release_time": "2013-10-15T18:08:29+00:00",
  "tags": [],
  "text_track_count": 4,
  "thumbnail_url": "https://i.vimeocdn.com/video/452001751-8216e0571c251a09d7a8387550942d89f7f86f6398f8ed886e639b0dd50d3c90-d_1920x1080?&r=pad&region=us",
  "title": "The New Vimeo Player (You Know, For Videos)",
  "uri": "/videos/76979871",
  "url": "https://vimeo.com/staff/player",
  "video_id": "76979871",
  "width": 1280
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Get video

- Capability: `videos/get_video`
- Description: Detail of one public Vimeo video from Vimeo API 3.4 (api.vimeo.com/videos/{id}) with the anonymous public token: title, description, canonical link, duration, dimensions, spoken language, created/release/modified times, content rating, license, privacy (view/embed/download), thumbnails, tags, categories, play count (null when the owner hides it), like and comment totals, text track count and the owner. An unknown video id is not_found; private videos are not visible to the anonymous token and also answer not_found.
- Instructions: You have a Vimeo video id or URL and need its metadata and stats. Use get_video_transcript for what is said in it.
- Cost: 5 credits per call
- Capability file: [Get video](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/get_video)

Accepted options:
- `video_id` (string, required): Numeric Vimeo video id or a vimeo.com / player.vimeo.com video URL containing it. Example: `<video_id>`

Response schema example:
```json
{
  "categories": [],
  "comments": 60,
  "content_rating": [
    "safe"
  ],
  "country": "US",
  "created_time": "2013-10-15T18:08:29+00:00",
  "description": "It may look (mostly) the same on the surface, but under the hood we totally rebuilt our player. Here’s a quick rundown of some of the coolest new features:\n\n• Lightning fast playback\n• Redesigned Share screen\n• Closed caption and subtitle compatible\n• HTML5 by default\n• Purchase-from-player functionality for embedded Vimeo On Demand trailers\n• More responsive than ever (go ahead, resize it, we dare you!!!)\n\nWe’re really proud of these updates. So proud that we made a spiffy new page to showcase all the reasons why we have the best video player in the galaxy. Check it out here: http://vimeo.com/player\n\nIn short, this is a player that even haters can love.",
  "duration_seconds": 62,
  "height": 720,
  "language": "en",
  "license": null,
  "likes": 2369,
  "modified_time": "2026-11-08T12:48:05+00:00",
  "observed_at_ms": 1794149048733,
  "owner": {
    "name": "Vimeo",
    "url": "https://vimeo.com/staff",
    "user_id": "152184"
  },
  "plays": null,
  "privacy": {
    "download": false,
    "embed": "public",
    "view": "anybody"
  },
  "release_time": "2013-10-15T18:08:29+00:00",
  "tags": [],
  "text_track_count": 4,
  "thumbnail_url": "https://i.vimeocdn.com/video/452001751-8216e0571c251a09d7a8387550942d89f7f86f6398f8ed886e639b0dd50d3c90-d_1920x1080?&r=pad&region=us",
  "title": "The New Vimeo Player (You Know, For Videos)",
  "uri": "/videos/76979871",
  "url": "https://vimeo.com/staff/player",
  "video_id": "76979871",
  "width": 1280
}
```

### Get video transcript

- Capability: `videos/get_video_transcript`
- Description: The complete transcript of one public Vimeo video as timed WebVTT cues plus the joined plain text. Loads the player embed page (player.vimeo.com/video/{id}), reads the inline playerConfig, picks the text track for the requested language (or the track the player marks default, else the first track), downloads its signed WebVTT file and parses the cues (formatting tags stripped). Reports the chosen track's id, language, label, kind (subtitles/captions) and provenance (user_uploaded or ai_generated) and lists every other track. A video with no text tracks succeeds with an empty cue list and a warning; an unknown or removed video id is not_found.
- Instructions: You need what is said in a Vimeo video: a transcript, captions or subtitles, optionally in a specific language. Call list_video_text_tracks first if you need to know which languages exist.
- Cost: 5 credits per call
- Capability file: [Get video transcript](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/get_video_transcript)

Accepted options:
- `language` (string): Text track language code as Vimeo labels it (en, de, es, fr, en-x-autogen for auto-generated English). Case-insensitive; a bare primary language (en) also matches regional and autogen variants when no exact track exists. Omitted: the player's default track, else the first track. Example: `<language>`
- `video_id` (string, required): Numeric Vimeo video id (e.g. 76979871) or a vimeo.com / player.vimeo.com video URL containing it. Example: `<video_id>`

Response schema example:
```json
{
  "available_tracks": [
    {
      "default": false,
      "id": "170",
      "kind": "subtitles",
      "label": "Deutsch",
      "language": "de",
      "provenance": "user_uploaded"
    },
    {
      "default": false,
      "id": "171",
      "kind": "subtitles",
      "label": "Español",
      "language": "es",
      "provenance": "user_uploaded"
    },
    {
      "default": true,
      "id": "140662",
      "kind": "subtitles",
      "label": "English",
      "language": "en",
      "provenance": "user_uploaded"
    },
    {
      "default": false,
      "id": "4678937",
      "kind": "subtitles",
      "label": "Français",
      "language": "fr",
      "provenance": "user_uploaded"
    }
  ],
  "country": "US",
  "cue_count": 14,
  "cues": [
    {
      "end_ms": 8043,
      "start_ms": 5237,
      "text": "Here at Vimeo, there's always one thing on our minds:"
    },
    {
      "end_ms": 11022,
      "start_ms": 8043,
      "text": "how to make your videos look amazing, wherever they appear."
    },
    {
      "end_ms": 14921,
      "start_ms": 11448,
      "text": "The quality of our player was already the best in the galaxy,"
    },
    {
      "end_ms": 17359,
      "start_ms": 14921,
      "text": "but we wanted to make the best thing about Vimeo"
    },
    {
      "end_ms": 20571,
      "start_ms": 17359,
      "text": "even better, so we put our best developers and designers"
    },
    {
      "end_ms": 24014,
      "start_ms": 20571,
      "text": "on the job. They threw around a few ideas, and a lot of words,"
    },
    {
      "end_ms": 27344,
      "start_ms": 24014,
      "text": "words like \"future-ready,\" \"better sharing,\""
    },
    {
      "end_ms": 31874,
      "start_ms": 27344,
      "text": "\"wider accessibility,\" \"singularity,\" \"truth,\" \"beauty.\""
    },
    {
      "end_ms": 34423,
      "start_ms": 32181,
      "text": "They combined all the special ingredients that could make"
    },
    {
      "end_ms": 37415,
      "start_ms": 34423,
      "text": "our platform smarter, faster, and more responsive,"
    },
    {
      "end_ms": 39930,
      "start_ms": 37415,
      "text": "a player that even haters could love."
    },
    {
      "end_ms": 43558,
      "start_ms": 39930,
      "text": "After months of work, we found the perfect solution:"
    },
    {
      "end_ms": 46680,
      "start_ms": 43558,
      "text": "a player that worked just like the old one, only better."
    },
    {
      "end_ms": 50646,
      "start_ms": 46941,
      "text": "Introducing the new Vimeo player."
    }
  ],
  "duration_seconds": 62,
  "observed_at_ms": 1794149022073,
  "owner": {
    "name": "Vimeo",
    "url": "https://vimeo.com/staff",
    "user_id": "152184"
  },
  "text": "Here at Vimeo, there's always one thing on our minds: how to make your videos look amazing, wherever they appear. The quality of our player was already the best in the galaxy, but we wanted to make the best thing about Vimeo even better, so we put our best developers and designers on the job. They threw around a few ideas, and a lot of words, words like \"future-ready,\" \"better sharing,\" \"wider accessibility,\" \"singularity,\" \"truth,\" \"beauty.\" They combined all the special ingredients that could make our platform smarter, faster, and more responsive, a player that even haters could love. After months of work, we found the perfect solution: a player that worked just like the old one, only better. Introducing the new Vimeo player.",
  "title": "The New Vimeo Player (You Know, For Videos)",
  "track": {
    "default": true,
    "id": "140662",
    "kind": "subtitles",
    "label": "English",
    "language": "en",
    "provenance": "user_uploaded"
  },
  "url": "https://vimeo.com/76979871",
  "video_id": "76979871"
}
```

### List channel videos

- Capability: `videos/list_channel_videos`
- Description: Videos of one public Vimeo channel (Vimeo API 3.4 api.vimeo.com/channels/{channel}/videos, anonymous public token), by channel name (staffpicks) or numeric id (927), newest additions first by default. Same video summary rows as search_videos, with `total`, `next_page` and `continuation`. An unknown channel is not_found.
- Instructions: You want the videos curated in a Vimeo channel such as Staff Picks, with their ids for get_video_transcript.
- Cost: 5 credits per call
- Capability file: [List channel videos](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/list_channel_videos)

Accepted options:
- `channel` (string, required): Channel name (staffpicks), numeric channel id, or a https://vimeo.com/channels/{name} URL. Example: `<channel>`
- `page` (number): page Example: `1`
- `per_page` (number): per_page Example: `25`
- `sort` (string): sort Example: `added`

Response schema example:
```json
{
  "count": 3,
  "country": "US",
  "next_page": 2,
  "observed_at_ms": 1794149070469,
  "page": 1,
  "per_page": 3,
  "total": 16624,
  "videos": [
    {
      "comments": 4,
      "created_time": "2026-11-06T14:11:23+00:00",
      "description": "In Colorado’s forgotten valley, two siblings face alligators and the ache of leaving youth behind.\n\nDirector: Freddie Gluck\nProducer: Chloe Campion, Freddie Gluck, Matteo Moretti\nExecutive Producer: Caitlyn Greene, Freddie Gluck, Timothy Zaug\nDirector of Photography: Matteo Moretti\nEditor: Freddie Gluck\nAdditional Editing: Matteo Moretti\nAssociate Producer: Ben Hunter, Lisa Laursen, Christopher Wirth, James R Stephens Jr\nComposer: Luca Moretti\nAssistant Camera: Ben Hunter\nBTS Photography: Ben Hunter\nSound Design: Calvin Pia\nSound Mix: Calvin Pia\nColor: Stephen Derluguian\nDCP: Dillon Brown\nGraphic Design: Davis Long\nPainter/Poster Design: Jordan Sullivan",
      "duration_seconds": 1124,
      "likes": 83,
      "owner": {
        "name": "Freddie Gluck",
        "url": "https://vimeo.com/freddiegluck",
        "user_id": "174584707"
      },
      "plays": 32077,
      "release_time": "2026-11-06T14:11:23+00:00",
      "thumbnail_url": "https://i.vimeocdn.com/video/2223015373-e371b8678886a6fe51c3a7690ba02ff0887ad004d53e173321476f8879b83013-d_1920x1080?&r=pad&region=us",
      "title": "Gatorville",
      "uri": "/videos/1244254462",
      "url": "https://vimeo.com/1244254462",
      "video_id": "1244254462"
    },
    {
      "comments": 7,
      "created_time": "2026-09-18T15:38:17+00:00",
      "description": "Commissioned by Mass MoCA + Pioneer Works\n\nTeen: Luzdivina Asue Nse Micha\nFather: Patrick Mitogo\nMother: Elianny Heredia Bautista\nGrandfather: Michael Dozie\nChild: Mateya Jeiyeoba\n\nDirector: Alex Cook\nProduction Company: Caviar LA\nManaging Director & EP: Michael Sagol\nEP: Salim El Arja\nProducers: Salim El Arja, Sydney Lowe\nDirector of Photography: Daniël Bouquet\n\nServicing Production Company: Solent Film\nServicing EP: Alex Momchev\nServicing Producers: Rosen Savkov, Lyubo Yonchev\nServicing PM: Samuil Djoganov\nCasting Director, Spain: Buda Roses, Jimena Burgueño Buda and María De la\nTorre Roses, APDICE\nCasting Director, Bulgaria: Vesselina Georgieva, Kokopelli-Mana\n\n1st AD: Marin Zhivkov\n1st AC: Radostin Lazarov\nPhantom Operator: Ivelin Metodiev\nDIT: Alexandra Nenkova\nGaffer: Peter Kostov\nKey Grip: Peter Stoianov\nProduction Designer: Borislava Kadiyska\nMake-Up Artist: Gergana Batanova\nHair Artist: Rositsa Gerasimova\nStylist: Viliyana Karushkova\nSenior SFX Technician: Kosta Maslev\nTransportation Captain: Antony Stoev\n\nEdit: Cabin Editing Company\nCabin Executive Producer: Britt Carson\nCabin Senior Producer: Lorelei Polk\nEditor: Esfandiar Bardon-Rafizadeh\nConform: Loom\nLoom Managing Director & EP: Corentin De Saedeleer\nLoom EP: Terry Huynh\nLoom DI / VFX Finishing Coordinator: Ted Tsoubris\nVFX Supervisor: Nick Chamberlain\nVFX Producer: Damani Blair\nRoto & Paint: Rhinestone VFX\nSound Designer: Jeremy Emery\nGraphic Designer: Katy Cook\nColor Studio: De Grot\nColor Producer: Ilse te Veldhuis\nColorist: Joppo\n\nSpecial Thanks to City Slang + This is Meru",
      "duration_seconds": 342,
      "likes": 149,
      "owner": {
        "name": "Alex Cook",
        "url": "https://vimeo.com/alexandercook",
        "user_id": "21789815"
      },
      "plays": 10270,
      "release_time": "2026-09-18T15:38:17+00:00",
      "thumbnail_url": "https://i.vimeocdn.com/video/2207155061-05e1466c175c4c30865b67ad65d90863171f9459678796eaad88e8d379916e3c-d_1920x1080?&r=pad&region=us",
      "title": "Son Lux \"Out Into Us\"",
      "uri": "/videos/1228116196",
      "url": "https://vimeo.com/1228116196",
      "video_id": "1228116196"
    },
    {
      "comments": 4,
      "created_time": "2026-11-02T11:56:57+00:00",
      "description": "Two feuding raccoons, having found shelter from a fierce winter storm, receive an unexpected guest.",
      "duration_seconds": 545,
      "likes": 66,
      "owner": {
        "name": "Gordon LePage",
        "url": "https://vimeo.com/gordonlepage",
        "user_id": "106008207"
      },
      "plays": 25288,
      "release_time": "2026-11-02T11:56:57+00:00",
      "thumbnail_url": "https://i.vimeocdn.com/video/2220624966-3443a627169e7469fc7072984418323c6e9e55ec33c0967c7b4a4d74aec7bc9a-d_1920x1080?&r=pad&region=us",
      "title": "Something Greater than You",
      "uri": "/videos/1242348473",
      "url": "https://vimeo.com/1242348473",
      "video_id": "1242348473"
    }
  ]
}
```

### List user videos

- Capability: `videos/list_user_videos`
- Description: Public videos uploaded by one Vimeo user (Vimeo API 3.4 api.vimeo.com/users/{user}/videos, anonymous public token), by vanity name (staff) or numeric user id (152184), newest first by default. Same video summary rows as search_videos, with `total`, `next_page` and `continuation`. An unknown user is not_found.
- Instructions: You want a Vimeo member's or organisation's uploads, for example to find a talk and then fetch its transcript.
- Cost: 5 credits per call
- Capability file: [List user videos](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/list_user_videos)

Accepted options:
- `page` (number): page Example: `1`
- `per_page` (number): per_page Example: `25`
- `sort` (string): sort Example: `date`
- `user` (string, required): Vanity name (staff), numeric user id, or a https://vimeo.com/{name} profile URL. Example: `<user>`

Response schema example:
```json
{
  "count": 3,
  "country": "US",
  "next_page": 2,
  "observed_at_ms": 1794149078800,
  "page": 1,
  "per_page": 3,
  "total": 841,
  "videos": [
    {
      "comments": 0,
      "created_time": "2026-10-30T17:23:23+00:00",
      "description": "Learn more about Vimeo OTT",
      "duration_seconds": 40,
      "likes": 2,
      "owner": {
        "name": "Vimeo",
        "url": "https://vimeo.com/staff",
        "user_id": "152184"
      },
      "plays": null,
      "release_time": "2026-10-30T17:23:23+00:00",
      "thumbnail_url": "https://i.vimeocdn.com/video/2219399043-e44d69640e66c415166268af011256dbd065c061a0fe866fa7505009f40a5020-d_1920x1080?&r=pad&region=us",
      "title": "Vimeo OTT - Platform Redesign",
      "uri": "/videos/1241393908",
      "url": "https://vimeo.com/1241393908",
      "video_id": "1241393908"
    },
    {
      "comments": 58,
      "created_time": "2026-10-14T10:44:26+00:00",
      "description": "Vimeo unveils major updates enhancing user experience and branding capabilities. \nDiscover new features like customizable video pages, full-screen vertical video playback on mobile, and a Recently deleted tab for easy recovery. Streamline your workflow with bulk actions and improved video management tools.",
      "duration_seconds": 210,
      "likes": 95,
      "owner": {
        "name": "Vimeo",
        "url": "https://vimeo.com/staff",
        "user_id": "152184"
      },
      "plays": null,
      "release_time": "2026-10-14T10:44:26+00:00",
      "thumbnail_url": "https://i.vimeocdn.com/video/2212247243-fb180a44ec7f3daa5f5c79d3770f35917c902cd0c19c500f946083d1bb39cc7a-d_1920x1080?&r=pad&region=us",
      "title": "What's new from Vimeo - End of Q3 update",
      "uri": "/videos/1235788780",
      "url": "https://vimeo.com/1235788780",
      "video_id": "1235788780"
    },
    {
      "comments": 0,
      "created_time": "2026-06-17T16:41:41+00:00",
      "description": "Wise is a global organization with over 5,000 employees spread around the world. The internal communications challenge? Ensuring every employee feels connected. Discover how Vimeo became the right tool to create a clear strategy for organizing and presenting video content. ✨\n\nIn this customer story, learn how Wise leveraged Vimeo to:\n\n\nMaintain connection: Create content that makes employees feel \"in the room\" whether they join a live call or watch the recording afterward.\nBuild an amazing archive: Establish a clear strategy by creating dedicated folders for every recorded event, building a comprehensive, high-quality archive of all content ever produced.\nCentralized access: Provide employees with one single tool where they can go to check all of the internal video content. 📲\nImprove accessibility: Ensure video is more accessible and of higher quality across the entire organization.\n\n\nIf you need a reliable, centralized platform to connect a large, distributed global workforce and build an easily accessible video archive, this is a must-watch!\n\nStart for free\n\n#Vimeo #customerstory #wise #internalcomms #employeeengagement #globalworkforce #videoarchive #videoplatform #communication 💡\n\n\n---\n\nTranscript:\n\nThere's something really powerful about being able to kind of pop into a call live, but then know if you're not able to do that, you then still have access to that same recording and it's like you were in the room by watching it even afterwards. \n\nWISE as an organization is now over 5,000 employees and we're spread around the world. But what this means for internal comms is that we wanna make sure that everyone really feels connected. \n\nHaving a clear strategy for organizing and presenting content wasn't something that was always there. Part of making video more accessible to people and higher quality has been just using the right tools. \n\nThat's where Vimeo comes in for us. We make sure that we create folders with every single event that we have recorded and we've created this amazing archive. \n\nHaving that one tool where people can go and check all of the content that we've ever produced is just amazing.",
      "duration_seconds": 60,
      "likes": 1,
      "owner": {
        "name": "Vimeo",
        "url": "https://vimeo.com/staff",
        "user_id": "152184"
      },
      "plays": null,
      "release_time": "2026-06-17T16:41:41+00:00",
      "thumbnail_url": "https://i.vimeocdn.com/video/2169774974-8d42be084226f8429851f58da033492113e7ad54a353c636d7ba237404e5e50b-d_1920x1080?&r=pad&region=us",
      "title": "How Wise scaled its employee communications into a company-wide “Mission”",
      "uri": "/videos/1202208321",
      "url": "https://vimeo.com/1202208321",
      "video_id": "1202208321"
    }
  ]
}
```

### List video text tracks

- Capability: `videos/list_video_text_tracks`
- Description: Every caption or subtitle track of one public Vimeo video, from the player embed's inline playerConfig: track id, language code, label, kind and provenance (user_uploaded or ai_generated), plus the video's title, duration and owner. The signed download URLs themselves are not returned because they expire within the hour; call get_video_transcript for the content. A video with no tracks returns an empty list; an unknown video id is not_found.
- Instructions: You want to know which languages a Vimeo video is captioned in, or whether its captions are human-made or auto-generated, before fetching a transcript.
- Cost: 5 credits per call
- Capability file: [List video text tracks](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/list_video_text_tracks)

Accepted options:
- `video_id` (string, required): Numeric Vimeo video id or a vimeo.com / player.vimeo.com video URL containing it. Example: `<video_id>`

Response schema example:
```json
{
  "country": "US",
  "duration_seconds": 62,
  "observed_at_ms": 1794149040099,
  "owner": {
    "name": "Vimeo",
    "url": "https://vimeo.com/staff",
    "user_id": "152184"
  },
  "title": "The New Vimeo Player (You Know, For Videos)",
  "track_count": 4,
  "tracks": [
    {
      "default": false,
      "id": "170",
      "kind": "subtitles",
      "label": "Deutsch",
      "language": "de",
      "provenance": "user_uploaded"
    },
    {
      "default": false,
      "id": "171",
      "kind": "subtitles",
      "label": "Español",
      "language": "es",
      "provenance": "user_uploaded"
    },
    {
      "default": true,
      "id": "140662",
      "kind": "subtitles",
      "label": "English",
      "language": "en",
      "provenance": "user_uploaded"
    },
    {
      "default": false,
      "id": "4678937",
      "kind": "subtitles",
      "label": "Français",
      "language": "fr",
      "provenance": "user_uploaded"
    }
  ],
  "url": "https://vimeo.com/76979871",
  "video_id": "76979871"
}
```

### Search videos

- Capability: `videos/search_videos`
- Description: Keyword search over public Vimeo videos through Vimeo API 3.4 (api.vimeo.com/videos?query=) with the anonymous public token. Sort by relevance, date, alphabetical, plays, likes, comments or duration; optionally restrict to videos with closed captions. Each hit carries id, URL, title, description, duration, created and release times, plays (null when hidden), likes, comments, the largest thumbnail and the owner. Pages of up to 50; `continuation` reports whether another page exists and `next_page` is its number. A query that matches nothing succeeds with an empty list. Vimeo caps search at 15 requests per anonymous token; a fresh token is minted per call.
- Instructions: Discovery: find Vimeo videos by words in their title, description or tags, then pass a hit's video_id to get_video_transcript or get_video.
- Cost: 5 credits per call
- Capability file: [Search videos](https://alexandria.firecrawl.dev/agents/providers/vimeo-com/videos/search_videos)

Accepted options:
- `captions_only` (boolean): Only videos that carry closed captions (Vimeo filter CC). Example: `false`
- `direction` (string): Sort direction; Vimeo's default when omitted. Example: `asc`
- `page` (number): page Example: `1`
- `per_page` (number): per_page Example: `25`
- `query` (string, required): Search words. Example: `<query>`
- `sort` (string): sort Example: `relevant`

Response schema example:
```json
{
  "count": 3,
  "country": "US",
  "next_page": 2,
  "observed_at_ms": 1794149058817,
  "page": 1,
  "per_page": 3,
  "total": 10977,
  "videos": [
    {
      "comments": 5,
      "created_time": "2013-09-20T16:55:04+00:00",
      "description": "Climate Change — The state of the science\n\nProduced by the International Geosphere-Biosphere Programme and Globaia and funded by the UN Foundation for the launch of the Intergovernmental Panel on Climate Change (IPCC) Fifth Assessment Report.\nhttp://www.igbp.net\nhttp://globaia.org\nhttp://www.unfoundation.org\n\nThe data visualization summarises several of the most significant statements in the IPCC’s latest summary for policymakers published September 2013. This summary covers the physical science basis of climate change. In 2014, IPCC will publish summaries concerning societal impacts, mitigation and adaptation.\n\nDownload the IPCC Working Group I summary for policymakers here: \nhttp://www.climatechange2013.org\n\n--\nPRODUCED AND DIRECTED BY\nOwen Gaffney and Félix Pharand-Deschênes\n\nANIMATION\nFélix Pharand-Deschênes\nGlobaïa\n\nSCRIPT\nOwen Gaffney\nInternational Geosphere-Biosphere Programme\n\nNARRATION\nSarah Sherborne\n\nDATA\nGEOS-5 atmospheric model\nNASA/Goddard Space Flight Center Scientific Visualization Studio\n\nSuomi NPP VIIRS Nighttime Lights 2012\nEarth Observation Group, NOAA National Geophysical Data Center\n\nLandscan 2011tm High Resolution global Population Data Set\nUT-Battelle, LLC, Oak Ridge National Laboratory\n\nBlue Marble: Next Generation, Reto Stöckli\nNASA Earth Observatory, NASA Goddard Space Flight Center\n\nAnnual temperature anomaly compared to 1860-1899 period\nGFDL-CM3 (historical and RCP8.5 experiments) 1860-2100\nCoupled Model Intercomparison Project Phase 5 (CMIP5)\n\nSeptember sea ice concentration\nGFDL-CM3 (historical and RCP8.5 experiments) 1860-2100\nCoupled Model Intercomparison Project Phase 5 (CMIP5)\n\nSea level rise flooded areas\nCenters for the Remote Sensing of Ice Sheets (CReSIS)\n\nCyclones tracks\nInternational Best Track Archive for Climate Stewardship (IBTrACS)\n\nOcean acidification\nMax Planck Institute Earth System Model, RCP 8.5\n\nMUSIC\nEarlyguard\nContinuo VII • Microcosmos • Mind over Matter\nhttp://earlyguard.bandcamp.com\n\nCOMMISSIONED BY\nInternational Geosphere-Biosphere Programme\n\nFor the launch of the Intergovernmental Panel on Climate Change Working Group I summary for policymakers\n(Fifth Assessment Report)\n\nFUNDED BY\nUnited Nations Foundation\n\nSPECIAL THANKS TO\nAnne-Marie Doucet\nLouve & Isis\nMyles Allen\nCatherine Boire\nWendy Broadgate\nDavid Huard\nTatiana Ilyina\nKalee Kreider\nNaomi Lubick\nJochem Marotzke\nJohannes Megel\nTim Nuthall\nSybil Seitzinger\nSturle Hauge Simonsen\nKaren Smyth\nSimon Torok\nDenise Young\n\nWELCOME TO THE ANTHROPOCENE\nwww.anthropocene.info",
      "duration_seconds": 245,
      "likes": 216,
      "owner": {
        "name": "Globaïa",
        "url": "https://vimeo.com/globaia",
        "user_id": "3359832"
      },
      "plays": 75153,
      "release_time": "2013-09-20T16:55:04+00:00",
      "thumbnail_url": "https://i.vimeocdn.com/video/455549757-d760a4d871a88bc0df793fba43cfb7aa2991fa9377ec9e9ad8a5f79b5c3b0c47-d_1920x1080?&r=pad&region=us",
      "title": "Climate Change — The state of the science",
      "uri": "/videos/75038049",
      "url": "https://vimeo.com/globaia/climate",
      "video_id": "75038049"
    },
    {
      "comments": 0,
      "created_time": "2018-11-06T08:03:55+00:00",
      "description": "I worked with the Ministry of Foreign Affairs and Trade and Flinch Marketing in New Zealand to make a few videos about their efforts in helping avoid climate change. They will be used to lead into larger articles, that give greater detail on each topic.\n\nCredits:\n\nClient - Ministry of Foreign Affairs and Trade NZ\nAgency - Flinch Marketing\nDirection, Illustration, Animation, SFX - Latham Arnott",
      "duration_seconds": 36,
      "likes": 54,
      "owner": {
        "name": "Latham Arnott",
        "url": "https://vimeo.com/akahomebody",
        "user_id": "7315804"
      },
      "plays": 858,
      "release_time": "2018-11-06T08:03:55+00:00",
      "thumbnail_url": "https://i.vimeocdn.com/video/737228962-2a26cc092d437ebc756fa2eceba801bb02bb45071e45204e376bfca7feed9256-d_1920x1080?&r=pad&region=us",
      "title": "MFAT on Climate Change - Innovation",
      "uri": "/videos/299165448",
      "url": "https://vimeo.com/299165448",
      "video_id": "299165448"
    },
    {
      "comments": 0,
      "created_time": "2018-11-08T19:19:25+00:00",
      "description": "I worked with the Ministry of Foreign Affairs and Trade and Flinch Marketing in New Zealand to make a few videos about their efforts in helping avoid climate change. They will be used to lead into larger articles, that give greater detail on each topic.\n\nCredits:\n\nClient - Ministry of Foreign Affairs and Trade NZ\nAgency - Flinch Marketing\nDirection, Illustration, Animation, SFX - Latham Arnott",
      "duration_seconds": 39,
      "likes": 56,
      "owner": {
        "name": "Latham Arnott",
        "url": "https://vimeo.com/akahomebody",
        "user_id": "7315804"
      },
      "plays": 861,
      "release_time": "2018-11-08T19:19:25+00:00",
      "thumbnail_url": "https://i.vimeocdn.com/video/737910946-24cda7e7684525b76f1da87d341627dc33a5c9b192ea2ae21ab8b3739992c5e9-d_1920x1080?&r=pad&region=us",
      "title": "MFAT on Climate Change - Taking Action",
      "uri": "/videos/299727054",
      "url": "https://vimeo.com/299727054",
      "video_id": "299727054"
    }
  ]
}
```
