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

# Bulk Track Videos

> Track multiple videos by URL in a single request

Track up to 25 videos at once by providing an array of URLs. Each URL is processed independently — if one fails, the others still succeed.

## Body parameters

<ParamField body="urls" type="string[]" required>
  Array of video URLs (max 25). Each must be a valid TikTok, Instagram, or YouTube link (HTTPS).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.reel25.com/api/v1/videos/bulk-track \
    -H "Authorization: Bearer reel25_sk_..." \
    -H "Content-Type: application/json" \
    -d '{
      "urls": [
        "https://www.tiktok.com/@creator1/video/7234567890123456789",
        "https://www.tiktok.com/@creator2/video/7234567890123456790",
        "https://www.instagram.com/reel/ABC123/"
      ]
    }'
  ```

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

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

  response = requests.post(
      'https://api.reel25.com/api/v1/videos/bulk-track',
      headers={
          'Authorization': 'Bearer reel25_sk_...',
          'Content-Type': 'application/json',
      },
      json={
          'urls': [
              'https://www.tiktok.com/@creator1/video/7234567890123456789',
              'https://www.tiktok.com/@creator2/video/7234567890123456790',
          ]
      }
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": [
      {
        "url": "https://www.tiktok.com/@creator1/video/7234567890123456789",
        "data": {
          "trackedVideoId": "9f14e45f-...",
          "videoId": "550e8400-...",
          "isNew": true
        }
      },
      {
        "url": "https://www.tiktok.com/@creator2/video/7234567890123456790",
        "error": "This video is already tracked in your workspace"
      }
    ]
  }
  ```
</ResponseExample>


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