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

# Track Video

> Start tracking a video by URL

Submit a video or account URL to start tracking its performance. Supports TikTok, Instagram, and YouTube. The video will be queued for scraping — metrics will appear within a few minutes.

<Info>
  Tracking does not consume credits, but counts toward your plan's video tracking limit.
</Info>

## Body parameters

<ParamField body="url" type="string" required>
  The full video URL. Must be HTTPS. Supported formats:

  * **TikTok:** `https://www.tiktok.com/@user/video/1234567890`
  * **Instagram:** `https://www.instagram.com/reel/ABC123/`
  * **YouTube:** `https://www.youtube.com/watch?v=ID`, `https://youtu.be/ID`, `https://youtube.com/shorts/ID`
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.reel25.com/api/v1/videos \
    -H "Authorization: Bearer reel25_sk_..." \
    -H "Content-Type: application/json" \
    -d '{"url": "https://www.tiktok.com/@creator/video/7234567890123456789"}'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.reel25.com/api/v1/videos', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer reel25_sk_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      url: 'https://www.tiktok.com/@creator/video/7234567890123456789',
    }),
  });
  const { data } = await response.json();
  ```

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

  response = requests.post(
      'https://api.reel25.com/api/v1/videos',
      headers={
          'Authorization': 'Bearer reel25_sk_...',
          'Content-Type': 'application/json',
      },
      json={'url': 'https://www.tiktok.com/@creator/video/7234567890123456789'}
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "trackedVideoId": "9f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
      "videoId": "550e8400-e29b-41d4-a716-446655440000",
      "isNew": true
    },
    "message": "Video queued for tracking"
  }
  ```

  ```json 400 theme={null}
  {
    "code": "INVALID_URL",
    "message": "URL must be a valid TikTok, Instagram, or YouTube link (https)"
  }
  ```

  ```json 409 theme={null}
  {
    "code": "ALREADY_TRACKED",
    "message": "This video is already tracked in your workspace"
  }
  ```
</ResponseExample>


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