> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/marketing/vimeo-public-data.md).

# Vimeo Public Data

Export Vimeo video metadata, play counts, and engagement metrics into Google Sheets or BigQuery via Coupler.io automation.

Vimeo Public Data lets you export video metadata and statistics from your Vimeo account or search public videos across the platform. Whether you're tracking your own content performance or researching trends, you can pull detailed video information like play counts, engagement metrics, user details, and content attributes into Coupler.io.

## Why connect Vimeo Public Data to Coupler.io?

* **Automate video tracking** — Pull performance data on a schedule without manual exports
* **Analyze your library** — Export your account videos with metadata, stats, and privacy settings
* **Research public content** — Search and analyze public videos by keyword to track industry trends
* **Combine with other data** — Join video metrics with audience data or marketing campaigns in Google Sheets, BigQuery, or Looker Studio
* **Feed AI tools** — Send video metadata and descriptions to Claude, ChatGPT, or Gemini for content analysis and tagging

## Prerequisites

You'll need:

* A **Vimeo account** (free or paid)
* **Coupler.io account**
* Permission to access your Vimeo videos or the ability to search public videos

## Quick start

{% hint style="success" %}
Start with "My account videos" to export your own video library. You can filter columns and add advanced filters to narrow down which videos appear in your report.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Log in to Coupler.io** and create a new data flow. Choose **Vimeo Public Data** as your source.
{% endstep %}

{% step %}
**Click "Connect"** and sign in with your Vimeo account. Coupler.io will ask for permission to access your public video data. Approve the OAuth connection.
{% endstep %}

{% step %}
**Select a report type.** Choose **"My account videos"** to export videos from your Vimeo account, or **"Public videos search"** to search for videos by keyword across Vimeo.
{% endstep %}

{% step %}
**If searching public videos,** enter one or more search keywords (one per line) to find videos on the platform. For example: "product demo" or "tutorial."
{% endstep %}

{% step %}
**Select columns** to include in your report. Common choices include Video Name, Link, Duration, Play stats, User Name, and Created date. You can also select video badges, privacy settings, and user location data.
{% endstep %}

{% step %}
**Optionally add advanced filters** to narrow results—for example, filter by content rating, video status, or creation date range.
{% endstep %}

{% step %}
**Choose a destination** — Google Sheets, Excel, BigQuery, Looker Studio, or an AI tool like Claude or ChatGPT.
{% endstep %}

{% step %}
**Run the data flow manually** to test it. Once it completes successfully, you can schedule it to run automatically on your chosen interval.
{% endstep %}
{% endstepper %}

## Vimeo Public Data data overview

Vimeo Public Data offers two report types, each with dozens of columns covering video metadata, user details, engagement stats, and content attributes.

## Report types

| Report                   | Description                                                                                           |
| ------------------------ | ----------------------------------------------------------------------------------------------------- |
| **My account videos**    | Videos from your Vimeo account with full metadata, statistics, privacy settings, and user information |
| **Public videos search** | Public videos matching one or more keywords you specify                                               |

## Video metrics

#### Engagement statistics

| Metric                       | Description                  |
| ---------------------------- | ---------------------------- |
| **Video stats: Plays**       | Total play count             |
| **Video stats: Likes**       | Number of likes              |
| **Video stats: Comments**    | Number of comments           |
| **Video stats: Credits**     | Number of credits added      |
| **Video stats: Pictures**    | Number of thumbnail pictures |
| **Video stats: Text tracks** | Number of captions/subtitles |

#### Content organization

| Metric                              | Description                       |
| ----------------------------------- | --------------------------------- |
| **Video stats: Albums**             | Total albums containing the video |
| **Video stats: Available albums**   | Accessible albums                 |
| **Video stats: Available channels** | Accessible channels               |

## Video dimensions

#### Basic video information

| Dimension                   | Description                    |
| --------------------------- | ------------------------------ |
| **Video: URI**              | Unique identifier              |
| **Video: Name**             | Video title                    |
| **Video: Description**      | Full description text          |
| **Video: Type**             | Video type (e.g., video, live) |
| **Video: Link**             | Direct Vimeo URL               |
| **Video: Player embed URL** | Embeddable player URL          |
| **Video: Duration**         | Length in seconds              |
| **Video: Width**            | Video frame width              |
| **Video: Height**           | Video frame height             |
| **Video: Language**         | Primary language               |
| **Video: Embed HTML**       | Ready-to-use embed code        |

#### Video status and playback

| Dimension                   | Description                                       |
| --------------------------- | ------------------------------------------------- |
| **Video: Play status**      | Current play status (playable, unavailable, etc.) |
| **Video: Status**           | Upload/processing status                          |
| **Video: Is playable**      | Whether video can be played                       |
| **Video: Has audio**        | Whether video contains audio                      |
| **Video: Is Vimeo create**  | Created using Vimeo's tools                       |
| **Video: Is screen record** | Screen recording                                  |

#### Dates

| Dimension              | Description      |
| ---------------------- | ---------------- |
| **Video: Created at**  | Upload date      |
| **Video: Modified at** | Last edit date   |
| **Video: Released at** | Publication date |

#### Content ratings and licensing

| Dimension                       | Description                            |
| ------------------------------- | -------------------------------------- |
| **Video: Content rating**       | Rating category (unrated, safe, etc.)  |
| **Video: Content rating class** | Rating classification                  |
| **Video: Rating mod locked**    | Whether rating is locked               |
| **Video: License**              | Creative Commons or other license type |

#### Privacy settings

| Dimension                   | Description                        |
| --------------------------- | ---------------------------------- |
| **Video privacy: View**     | Who can view (anybody, team, etc.) |
| **Video privacy: Embed**    | Who can embed                      |
| **Video privacy: Download** | Who can download                   |
| **Video privacy: Add**      | Who can add to collections         |
| **Video privacy: Comments** | Who can comment                    |

#### Video badges

| Dimension                                                           | Description                   |
| ------------------------------------------------------------------- | ----------------------------- |
| **Video badges: HDR**                                               | High-Dynamic-Range certified  |
| **Video badges: Live streaming**                                    | Live broadcast                |
| **Video badges: Live archived**                                     | Archived live stream          |
| **Video badges: Staff pick (normal, best of month/year, premiere)** | Vimeo staff selections        |
| **Video badges: VOD**                                               | Video-on-demand               |
| **Video badges: Weekend challenge**                                 | Vimeo Weekend Challenge entry |

#### Tags and categories

| Dimension                       | Description         |
| ------------------------------- | ------------------- |
| **Video tags: Name**            | Tag text            |
| **Video tags: URI**             | Tag identifier      |
| **Video tags: ID**              | Numeric tag ID      |
| **Video tags: Canonical**       | Canonical tag form  |
| **Video categories: Name**      | Category name       |
| **Video categories: URI**       | Category identifier |
| **Video categories: Link**      | Category URL        |
| **Video categories: Top level** | Parent category     |

## User dimensions

#### User profile

| Dimension            | Description            |
| -------------------- | ---------------------- |
| **User: URI**        | Unique user identifier |
| **User: Name**       | Display name           |
| **User: Link**       | Profile URL            |
| **User: Gender**     | Gender (if public)     |
| **User: Bio**        | Full biography         |
| **User: Short bio**  | Abbreviated bio        |
| **User: Created at** | Account creation date  |

#### User location

| Dimension                            | Description          |
| ------------------------------------ | -------------------- |
| **User location: Formatted address** | Complete address     |
| **User location: City**              | City                 |
| **User location: State**             | State/province       |
| **User location: State ISO code**    | State code           |
| **User location: Country**           | Country              |
| **User location: Country ISO code**  | Country code         |
| **User location: Latitude**          | Geographic latitude  |
| **User location: Longitude**         | Geographic longitude |

#### User websites

| Dimension                     | Description         |
| ----------------------------- | ------------------- |
| **User website: Name**        | Website title       |
| **User website: URI**         | Website identifier  |
| **User website: Link**        | Website URL         |
| **User website: Type**        | Website category    |
| **User website: Description** | Website description |

## Common use cases

### Video performance tracking

Export your account videos with plays, likes, comments, and duration to track which content performs best. Use the date filters to compare performance across quarters or campaigns.

### Audience research

Search public videos by keyword and export user names, locations, and profiles to understand who's creating similar content and where your audience is located.

### Content compliance

Pull video status, privacy settings, and content ratings to audit your library for compliance or to prepare videos for specific platforms or audiences.

### AI-powered content analysis

Export video names, descriptions, tags, and categories to Claude, ChatGPT, or Gemini for automated tagging, SEO optimization suggestions, or bulk description improvements.

## Use cases by role

{% tabs %}
{% tab title="Content creators" %}
Track the performance of your video library by exporting plays, engagement metrics (likes, comments), and audience demographics. Compare which videos drive the most engagement and use location data to understand your geographic reach. Send video descriptions and tags to ChatGPT or Claude for SEO optimization or bulk tagging suggestions.
{% endtab %}

{% tab title="Marketing teams" %}
Export your brand's videos and search for competitor content by keyword. Analyze engagement metrics alongside video metadata (duration, type, creation date) to identify trends. Join video performance data with campaign dates in Google Sheets or BigQuery to measure content ROI. Use AI tools to batch-analyze video descriptions and suggest improvements.
{% endtab %}

{% tab title="Analytics and research" %}
Pull public video data by keyword to research market trends, competitor activity, and audience preferences. Export user profiles and locations to build audience maps. Create dashboards in Looker Studio or BigQuery that track changes in engagement, content volume, or creator demographics over time.
{% endtab %}
{% endtabs %}

## Platform-specific notes

* **Public videos search** returns only videos marked as public on Vimeo — private or password-protected videos are not included
* **Search keywords** support exact matches and partial matches; use one keyword per line
* **User data** (location, website, bio) is only available if the user has made it public in their Vimeo profile
* **Video stats** are updated in near-real-time but may have a slight delay
* **Custom columns** can be combined and filtered in advanced settings to refine your report
* **Date range filtering** can be applied via advanced filters to narrow results by creation or modification date

## Vimeo Public Data common issues

### Connection issues

<details>

<summary>"OAuth connection failed" or "Access denied"</summary>

Vimeo's OAuth may fail if:

* Your Vimeo account doesn't have permission to access video data
* You accidentally denied permission during the sign-in flow
* Your Vimeo session has expired

**Fix:** Disconnect and reconnect the Vimeo account. When prompted, explicitly approve all permissions. If the issue persists, check that you're signing in with the correct Vimeo account.

</details>

<details>

<summary>"No videos found" in "My account videos"</summary>

This typically means your Vimeo account has no videos, or the data flow is looking at a Vimeo organization account.

**Fix:** Sign in to the personal Vimeo account that contains your videos. If you manage an organization, use the account associated with the videos you want to export.

</details>

### Missing data

<details>

<summary>"Search keywords" field is disabled or hidden</summary>

The search keywords field only appears when you select "Public videos search" as the report type.

**Fix:** Scroll up and change the report type to "Public videos search," then the keywords field will appear.

</details>

<details>

<summary>User location or website data is empty</summary>

Vimeo users control whether their location, website, and bio are public. If a field is blank, it means the video creator has not made that information public.

**Fix:** This is expected behavior and not an error. You can filter out rows with missing location data using advanced filters in your destination (Google Sheets, BigQuery, etc.).

</details>

<details>

<summary>Video stats (plays, likes, comments) are zero or missing</summary>

New videos or videos with low visibility may not have any stats yet. Also, if a video is private or in draft status, stats may not be available.

**Fix:** Check the video's status ("Video: Status" column) and play status. Only published, playable videos will have reliable stats. Wait 24 hours after publishing for stats to populate.

</details>

### Permission errors

<details>

<summary>"You don't have permission to access this data"</summary>

Your Vimeo account may not have the right permissions, or Coupler.io's access has been revoked.

**Fix:** Check your Vimeo account settings to ensure you're the account owner or have admin privileges. Then disconnect and reconnect Coupler.io in your Vimeo account settings (Settings > Applications > Connected Apps).

</details>

### Data discrepancies

<details>

<summary>Play counts or engagement metrics don't match Vimeo's dashboard</summary>

Vimeo's public data API may lag slightly behind real-time stats, and different time zones can affect date-based filtering.

**Fix:** Allow 1–2 hours for stats to sync. If discrepancies persist, check that you're using the same date range and filters in both places. Date-based comparisons should use the same time zone in your destination tool.

</details>

<details>

<summary>Video appears in search but not in "My account videos"</summary>

Public videos search shows all public videos matching your keywords, including videos from other creators. "My account videos" shows only videos you've uploaded.

**Fix:** This is expected. Use "My account videos" for your library and "Public videos search" for research.

</details>

### Rate limits

<details>

<summary>Data flow is slow or timing out on large searches</summary>

Searching for very popular keywords (e.g., "video") can return thousands of results, which may take longer to process.

**Fix:** Use more specific keywords to narrow results. If you're exporting a large number of your own videos, split them into multiple data flows by date range using advanced filters.

</details>

## Vimeo Public Data FAQ

<details>

<summary>Can I export videos from multiple Vimeo accounts in one data flow?</summary>

No, one data flow connects to one Vimeo account. To export from multiple accounts, create separate data flows for each account and use Coupler.io's Append transformation to combine them into a single destination table.

</details>

<details>

<summary>Does "Public videos search" include my own videos?</summary>

Only if your videos are marked as public on Vimeo. If your videos are private or password-protected, they won't appear in search results, even if you're searching your own content. Use "My account videos" to export your full library regardless of privacy settings.

</details>

<details>

<summary>Can I filter videos by duration, resolution, or engagement level?</summary>

Yes, via advanced filters. You can filter by creation date, status, or other fields. However, Vimeo's public API doesn't support filtering directly by duration or view count in the data flow setup—you can do that in your destination (Google Sheets, BigQuery, etc.) after the export.

</details>

<details>

<summary>How often are plays and engagement stats updated?</summary>

Vimeo updates stats every 1–2 hours. If you need real-time stats, set your data flow to refresh more frequently, but keep in mind you may see the same numbers for a few hours.

</details>

<details>

<summary>What's the difference between "My account videos" and "Public videos search"?</summary>

**My account videos** exports all videos from your Vimeo account, including private and draft videos, with full access to all metadata and stats. **Public videos search** searches across all public videos on Vimeo matching your keywords and includes basic metadata and stats for public creators. Use the first for your own library and the second for research.

</details>

<details>

<summary>Can I send video data to AI tools like ChatGPT or Claude?</summary>

Yes. Export video names, descriptions, tags, and categories to Claude, ChatGPT, Cursor, Gemini, Perplexity, or OpenClaw. You can use AI to bulk-generate SEO descriptions, optimize tags, or analyze content themes.

</details>

<details>

<summary>How do I join video stats with other data (e.g., campaign dates)?</summary>

After exporting to your destination, use Coupler.io's Join transformation to combine your Vimeo data with other sources. For example, join video creation dates with a marketing campaign table to measure content ROI. Alternatively, use native joins in Google Sheets, BigQuery, or your BI tool.

</details>

<details>

<summary>Why are some user fields blank even though they appear in my column selection?</summary>

Vimeo gives creators control over what information is public. If location, website, or bio fields are blank, it means that creator hasn't filled them in or has hidden them from public view. This is normal and not an error.

</details>

<details>

<summary>Can I filter out private or draft videos?</summary>

Yes. Use advanced filters and select only videos with a "playable" status, or filter by specific privacy settings in the "Video privacy" fields. Alternatively, remove draft rows after export using filters in your destination.

</details>

{% hint style="info" %}
For more details on available data, see the [Data Overview](#vimeo-public-data-data-overview). For troubleshooting, check [Common Issues](#vimeo-public-data-common-issues). For setup tips, see [Best Practices](https://docs.coupler.io/sources/category/marketing/vimeo-public-data/best-practices.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.coupler.io/sources/category/marketing/vimeo-public-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
