> ## 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.

# Folder Analytics

> Get aggregated analytics for a folder

Returns aggregated analytics for all accounts and videos inside a folder, including total views, likes, engagement metrics, and growth data.

## Path parameters

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

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer reel25_sk_..." \
    https://api.reel25.com/api/v1/folders/f1a2b3c4-.../analytics
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.reel25.com/api/v1/folders/f1a2b3c4-.../analytics',
    { 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/folders/{folder_id}/analytics',
      headers={'Authorization': 'Bearer reel25_sk_...'}
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "totalAccounts": 5,
      "totalVideos": 120,
      "totalViews": 45000000,
      "totalLikes": 3200000,
      "totalComments": 150000,
      "totalShares": 85000,
      "avgEngagementRate": 7.85,
      "topVideos": [
        {
          "id": "550e8400-...",
          "description": "Viral cooking video",
          "viewCount": 5200000,
          "username": "creator"
        }
      ]
    }
  }
  ```
</ResponseExample>


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