# Vimeo

**Provider:** Vimeo
**Category:** entertainment
**Base URL:** `https://api.vimeo.com`
**Auth:** bearer — `Authorization: Bearer YOUR_TOKEN`
**Rate Limit:** Varies by plan; throttled per token
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developer.vimeo.com/api/reference

## Description

Video hosting platform API providing access to videos, channels, groups, categories, and user data with full upload and management capabilities.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.vimeo.com/categories` | Get all categories |
| GET | `https://api.vimeo.com/categories/{category}/videos` | Get all videos in a category |
| GET | `https://api.vimeo.com/channels` | Get all channels |
| GET | `https://api.vimeo.com/me` | Get the authenticated user |
| GET | `https://api.vimeo.com/me/videos` | Get all videos for the authenticated user |
| POST | `https://api.vimeo.com/me/videos` | Upload a video |
| GET | `https://api.vimeo.com/videos/{video_id}` | Get a specific video |
| PATCH | `https://api.vimeo.com/videos/{video_id}` | Edit a video's metadata |

## Authentication

Bearer token in the Authorization header

```
Authorization: Bearer YOUR_TOKEN
```

## Sample Request

```bash
curl -X GET 'https://api.vimeo.com/me/videos' \
  -H 'Authorization: Bearer YOUR_TOKEN'
```

## Sample Response

```json
{"total":5,"page":1,"per_page":25,"data":[{"uri":"/videos/123","name":"My Video","description":"..."}]}
```

## Pricing Details

Free: 500MB/week, 5GB total. Starter: $7/mo. Standard: $20/mo. Advanced: $65/mo. API requires at least Starter.

---

*Source: [API Map](https://apimap.dev/apis/vimeo/) — CC BY 4.0*