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

# List Folder Videos

> Retrieve videos in a folder

Returns a paginated list of videos inside a folder with sorting and date filtering.

## Path parameters

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

## Query parameters

<ParamField query="limit" type="integer" default="20">
  Number of results per page. Min: 1, Max: 100.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Pagination offset.
</ParamField>

<ParamField query="sort" type="string" default="uploaded">
  Sort field. Options: `views`, `likes`, `comments`, `shares`, `engagement_rate`, `uploaded`.
</ParamField>

<ParamField query="sort_order" type="string" default="desc">
  Sort direction. Options: `asc`, `desc`.
</ParamField>

<ParamField query="start_date" type="string">
  Filter videos posted after this date. Format: `YYYY-MM-DD`.
</ParamField>

<ParamField query="end_date" type="string">
  Filter videos posted before this date. Format: `YYYY-MM-DD`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer reel25_sk_..." \
    "https://api.reel25.com/api/v1/folders/f1a2b3c4-.../videos?sort=views&sort_order=desc&limit=10"
  ```

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "550e8400-...",
        "description": "Viral cooking video #recipe",
        "viewCount": 5200000,
        "likeCount": 420000,
        "engagementRate": 10.25,
        "postedAt": "2025-03-01T10:00:00.000Z",
        "username": "creator",
        "type": "tiktok"
      }
    ],
    "total": 120,
    "currentPage": 1,
    "totalPages": 4
  }
  ```
</ResponseExample>


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