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"}'
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();
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'}
)
{
"data": {
"trackedVideoId": "9f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"videoId": "550e8400-e29b-41d4-a716-446655440000",
"isNew": true
},
"message": "Video queued for tracking"
}
{
"code": "INVALID_URL",
"message": "URL must be a valid TikTok, Instagram, or YouTube link (https)"
}
{
"code": "ALREADY_TRACKED",
"message": "This video is already tracked in your workspace"
}
Videos
Track Video
Start tracking a video by URL
POST
/
api
/
v1
/
videos
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"}'
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();
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'}
)
{
"data": {
"trackedVideoId": "9f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"videoId": "550e8400-e29b-41d4-a716-446655440000",
"isNew": true
},
"message": "Video queued for tracking"
}
{
"code": "INVALID_URL",
"message": "URL must be a valid TikTok, Instagram, or YouTube link (https)"
}
{
"code": "ALREADY_TRACKED",
"message": "This video is already tracked in your workspace"
}
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.
Tracking does not consume credits, but counts toward your plan’s video tracking limit.
Body parameters
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
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"}'
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();
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'}
)
{
"data": {
"trackedVideoId": "9f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"videoId": "550e8400-e29b-41d4-a716-446655440000",
"isNew": true
},
"message": "Video queued for tracking"
}
{
"code": "INVALID_URL",
"message": "URL must be a valid TikTok, Instagram, or YouTube link (https)"
}
{
"code": "ALREADY_TRACKED",
"message": "This video is already tracked in your workspace"
}
Was this page helpful?