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

# Top Videos

> Get your top performing tracked videos

Returns your top performing videos ranked by engagement metrics.

## Query parameters

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

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

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.reel25.com/api/v1/analytics/videos/top?limit=5',
    { headers: { 'Authorization': 'Bearer reel25_sk_...' } }
  );
  const { data } = await response.json();
  ```

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

  response = requests.get(
      'https://api.reel25.com/api/v1/analytics/videos/top',
      headers={'Authorization': 'Bearer reel25_sk_...'},
      params={'limit': 5}
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "550e8400-...",
        "tiktokVideoId": "7234567890123456789",
        "description": "Viral cooking video #recipe",
        "viewCount": 5200000,
        "likeCount": 420000,
        "commentCount": 18000,
        "shareCount": 95000,
        "engagementRate": 10.25,
        "postedAt": "2025-03-01T10:00:00.000Z",
        "url": "https://tiktok.com/@creator/video/7234567890123456789",
        "type": "tiktok",
        "thumbnailUrl": "https://...",
        "username": "creator",
        "displayName": "Creator Name"
      }
    ]
  }
  ```
</ResponseExample>


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