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

> Start tracking a creator account by URL

Submit a creator account URL to start tracking their content and performance. The account will be queued for scraping — videos and metrics will appear within a few minutes.

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

## Body parameters

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

  * **TikTok:** `https://www.tiktok.com/@username`
  * **Instagram:** `https://www.instagram.com/username`
  * **YouTube:** `https://www.youtube.com/@username`
</ParamField>

<ParamField body="video_limit" type="integer" default="50">
  Maximum number of videos to track for this account. Min: 1, Max: 500.
</ParamField>

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

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

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

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

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "added": ["creator"],
      "alreadyTracked": [],
      "failed": []
    },
    "message": "Account queued for tracking"
  }
  ```

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


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