# Vimeo User Videos API Documentation

Retrieve a public Vimeo user with one page of their public videos: the owner summary (id, name, url) derived from the video list, each video with title, description (HTML plus plain text), duration, thumbnails (list of width, height and url) and upload date (ISO 8601, UTC), plus pagination. A user with zero public videos is a valid empty response with a null user.

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

## 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 user ID (integer). Example: 152184 (Vimeo staff). |
| `page` | integer | No | 1-based page number. 20 videos per page. Defaults to 1. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/vimeo/user?id=152184&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "user": {
            "id": 152184,
            "name": "Vimeo",
            "url": "https://vimeo.com/staff"
        },
        "videos": [
            {
                "id": 1202208321,
                "title": "Copy of How Wise scaled its employee communications into a company-wide Mission",
                "description": "How Wise scaled its employee communications into a company-wide Mission.",
                "description_plain": "How Wise scaled its employee communications into a company-wide Mission.",
                "duration": 60,
                "width": 1920,
                "height": 1080,
                "upload_date": "2026-06-17T20:41:41Z",
                "url": "https://vimeo.com/1202208321",
                "tags": [
                    "wise",
                    "mission"
                ],
                "thumbnails": [
                    {
                        "width": 100,
                        "height": 56,
                        "url": "https://i.vimeocdn.com/video/2169774974_100x56.jpg"
                    },
                    {
                        "width": 200,
                        "height": 113,
                        "url": "https://i.vimeocdn.com/video/2169774974_200x113.jpg"
                    },
                    {
                        "width": 640,
                        "height": 360,
                        "url": "https://i.vimeocdn.com/video/2169774974_640x360.jpg"
                    }
                ],
                "user": {
                    "id": 152184,
                    "name": "Vimeo",
                    "url": "https://vimeo.com/staff"
                },
                "embed_privacy": "anywhere"
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 20,
            "has_more": true
        }
    },
    "meta": {
        "endpoint_family": "user_videos",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id parameter is missing or not an integer. This response is not billable. |
| 404 | User Not Found | The requested Vimeo user 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)