> ## Documentation Index
> Fetch the complete documentation index at: https://reel25.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Video History

> Retrieve performance snapshots for a video over time

Returns time-series performance data for a tracked video. Each snapshot captures the video's metrics at a point in time, allowing you to chart growth curves.

## Path parameters

<ParamField path="id" type="string" required>
  The video UUID.
</ParamField>

## Query parameters

<ParamField query="days" type="integer" default="30">
  Number of days of history to return. Min: 1, Max: 365.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer reel25_sk_..." \
    "https://api.reel25.com/api/v1/videos/550e8400.../history?days=7"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.reel25.com/api/v1/videos/550e8400.../history?days=7',
    { headers: { 'Authorization': 'Bearer reel25_sk_...' } }
  );
  const { data } = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      f'https://api.reel25.com/api/v1/videos/{video_id}/history',
      headers={'Authorization': 'Bearer reel25_sk_...'},
      params={'days': 7}
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "a1b2c3d4-...",
        "capturedAt": "2025-03-15T12:00:00.000Z",
        "viewCount": 1250000,
        "likeCount": 98000,
        "commentCount": 3200,
        "shareCount": 15000,
        "bookmarkCount": 45000,
        "engagementRate": 12.85,
        "viewGrowth": 70000,
        "likeGrowth": 6000,
        "commentGrowth": 300,
        "shareGrowth": 800
      },
      {
        "id": "e5f6g7h8-...",
        "capturedAt": "2025-03-14T12:00:00.000Z",
        "viewCount": 1180000,
        "likeCount": 92000,
        "commentCount": 2900,
        "shareCount": 14200,
        "bookmarkCount": 42000,
        "engagementRate": 12.80,
        "viewGrowth": 55000,
        "likeGrowth": 4500,
        "commentGrowth": 250,
        "shareGrowth": 600
      }
    ]
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.