# Vimeo Video Detail API Documentation

Retrieve a public Vimeo video: title, description (HTML plus plain text), duration, width, height, upload date (ISO 8601, UTC), tags (omitted when empty), thumbnails (list of width, height and url), the owner summary and the embed privacy setting. A valid video is a successful response.

- **Documentation:** [https://scrappa.co/docs/vimeo-api/vimeo_video](https://scrappa.co/docs/vimeo-api/vimeo_video)
- **API group:** Vimeo API
- **Endpoint:** `GET https://scrappa.co/api/vimeo/video`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | Yes | Vimeo video ID (integer). Example: 76979871. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/vimeo/video?id=76979871"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": 76979871,
        "title": "The New Vimeo Player (You Know, For Videos)",
        "description": "It may look (mostly) like a video player, but it is actually a video player.",
        "description_plain": "It may look (mostly) like a video player, but it is actually a video player.",
        "duration": 62,
        "width": 1280,
        "height": 720,
        "upload_date": "2013-10-15T18:08:29Z",
        "url": "https://vimeo.com/76979871",
        "tags": [
            "vimeo",
            "player",
            "video"
        ],
        "thumbnails": [
            {
                "width": 100,
                "height": 56,
                "url": "https://i.vimeocdn.com/video/543210987_100x56.jpg"
            },
            {
                "width": 200,
                "height": 113,
                "url": "https://i.vimeocdn.com/video/543210987_200x113.jpg"
            },
            {
                "width": 640,
                "height": 360,
                "url": "https://i.vimeocdn.com/video/543210987_640x360.jpg"
            }
        ],
        "user": {
            "id": 152184,
            "name": "Vimeo",
            "url": "https://vimeo.com/staff"
        },
        "embed_privacy": "anywhere"
    },
    "meta": {
        "endpoint_family": "video_detail",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id parameter is missing or not an integer. This response is not billable. |
| 404 | Video Not Found | The requested Vimeo video was not found. This response is not billable. |
| 503 | Upstream Unavailable | The Vimeo API is temporarily unavailable. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)