# Browse Vimeo Staff Picks Films and Video Metadata

**Use case:** 

Browse Vimeo Staff Picks to collect public video records for nonprofit communications teams and independent producers seeking documentary footage. Results include titles, descriptions, video URLs, thumbnail URLs, licenses, and durations. Change channelSlugs to browse another public Vimeo channel.

## Input

```json
{
  "mode": "byChannel",
  "channelSlugs": [
    "staffpicks"
  ],
  "usernames": [],
  "videoUrls": [],
  "searchQueries": [
    "documentary"
  ],
  "categorySlugs": [],
  "tagSlugs": [],
  "showcaseUrls": [],
  "maxItems": 20,
  "sort": "default",
  "filterCategory": "any",
  "filterDuration": "any",
  "filterResolution": "any",
  "filterPrice": "any",
  "filterLicense": "any",
  "filterUploaded": "any",
  "filterStaffPicked": false,
  "filterHdr": "any",
  "filterVimeo360": "any",
  "filterLive": false,
  "includeCreatorProfile": false,
  "includeChannelProfile": false
}
```

## Output

```json
{
  "recordType": {
    "label": "Record type"
  },
  "title": {
    "label": "Title"
  },
  "name": {
    "label": "Name"
  },
  "displayName": {
    "label": "Display name"
  },
  "uploaderName": {
    "label": "Uploader name"
  },
  "publishedAt": {
    "label": "Published at"
  },
  "duration": {
    "label": "Duration"
  },
  "viewCount": {
    "label": "View count"
  },
  "likeCount": {
    "label": "Like count"
  },
  "commentCount": {
    "label": "Comment count"
  },
  "url": {
    "label": "Url"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Vimeo Channel, Creator & Video Metadata Extractor Actor is ready to run with the inputs already set for "Browse Vimeo Staff Picks Films and Video Metadata". [Sign up or log in](https://console.apify.com/create-task-from-example/qMnyCID5uAgn0yb2S) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Browse Vimeo Staff Picks Films and Video Metadata" task

The Vimeo Channel, Creator & Video Metadata Extractor Actor will start running based on the input automatically. You can also change all the input fields, like mode, channel slugs or urls, and more, to match your specific use case.

### 3. Receive the "Browse Vimeo Staff Picks Films and Video Metadata" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as record type, title, name, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Browse Vimeo Staff Picks Films and Video Metadata" task via API](https://apify.com/xyrelith-data/vimeo-channel-creator-and-video-metadata-extractor.md).

## FAQ

### Can I find free Creative Commons documentary videos for nonprofit campaigns?

The Vimeo Staff Picks task returns public video records with titles, descriptions, URLs, thumbnails, licenses and durations. Its current settings do not filter for documentaries or Creative Commons licenses; those filters apply in search mode.

### How many Vimeo videos can one run return?

With the current setting, the Vimeo Staff Picks task returns at most 20 records per source. The input supports up to 10,000 records per source, while Vimeo caps search and tag results at 10,000.

### Can I export Vimeo video metadata to CSV or Excel?

After running the Vimeo Staff Picks task, download its dataset as CSV, Excel, JSON, XML, RSS or an HTML table, or read it through the Apify API.

### How do I browse another Vimeo channel?

Enter the other public channel's slug or URL in the task settings. The current channel is Staff Picks, and the result limit applies separately to each channel.

### Can I run the Vimeo Staff Picks task on a schedule or through an API?

The Vimeo Staff Picks task can be run on an Apify schedule, through the Apify API, or with integrations such as Zapier, Make and n8n.

## About this Actor

This example demonstrates how to use [Vimeo Channel, Creator & Video Metadata Extractor](https://apify.com/xyrelith-data/vimeo-channel-creator-and-video-metadata-extractor.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/xyrelith-data/vimeo-channel-creator-and-video-metadata-extractor.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/xyrelith-data/vimeo-channel-creator-and-video-metadata-extractor.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).