curl -H "Authorization: Bearer reel25_sk_..." \
"https://api.reel25.com/api/v1/videos?limit=10&offset=0"
const response = await fetch(
'https://api.reel25.com/api/v1/videos?limit=10',
{ headers: { 'Authorization': 'Bearer reel25_sk_...' } }
);
const { data, pagination } = await response.json();
import requests
response = requests.get(
'https://api.reel25.com/api/v1/videos',
headers={'Authorization': 'Bearer reel25_sk_...'},
params={'limit': 10, 'offset': 0}
)
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"trackedVideoId": "9f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"tiktokVideoId": "7234567890123456789",
"url": "https://tiktok.com/@creator/video/7234567890123456789",
"description": "Check out this recipe! #cooking #viral",
"hashtags": ["cooking", "viral"],
"duration": 45,
"thumbnailUrl": "https://...",
"postedAt": "2025-03-10T14:30:00.000Z",
"viewCount": 1250000,
"likeCount": 98000,
"commentCount": 3200,
"shareCount": 15000,
"bookmarkCount": 45000,
"engagementRate": 12.85,
"type": "tiktok",
"accountUsername": "creator",
"accountDisplayName": "Creator Name",
"accountId": "8f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"canonicalAccountId": "8f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"isTracked": true,
"trackedAt": "2025-03-10T15:00:00.000Z",
"lastScrapedAt": "2025-03-15T12:00:00.000Z",
"createdAt": "2025-03-10T14:30:00.000Z",
"musicName": "original sound - @creator",
"musicAuthor": "@creator",
"musicCoverUrl": "https://..."
}
],
"pagination": {
"total": 47,
"limit": 10,
"offset": 0,
"has_more": true
}
}
Videos
List Videos
Retrieve all tracked videos in your workspace
GET
/
api
/
v1
/
videos
curl -H "Authorization: Bearer reel25_sk_..." \
"https://api.reel25.com/api/v1/videos?limit=10&offset=0"
const response = await fetch(
'https://api.reel25.com/api/v1/videos?limit=10',
{ headers: { 'Authorization': 'Bearer reel25_sk_...' } }
);
const { data, pagination } = await response.json();
import requests
response = requests.get(
'https://api.reel25.com/api/v1/videos',
headers={'Authorization': 'Bearer reel25_sk_...'},
params={'limit': 10, 'offset': 0}
)
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"trackedVideoId": "9f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"tiktokVideoId": "7234567890123456789",
"url": "https://tiktok.com/@creator/video/7234567890123456789",
"description": "Check out this recipe! #cooking #viral",
"hashtags": ["cooking", "viral"],
"duration": 45,
"thumbnailUrl": "https://...",
"postedAt": "2025-03-10T14:30:00.000Z",
"viewCount": 1250000,
"likeCount": 98000,
"commentCount": 3200,
"shareCount": 15000,
"bookmarkCount": 45000,
"engagementRate": 12.85,
"type": "tiktok",
"accountUsername": "creator",
"accountDisplayName": "Creator Name",
"accountId": "8f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"canonicalAccountId": "8f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"isTracked": true,
"trackedAt": "2025-03-10T15:00:00.000Z",
"lastScrapedAt": "2025-03-15T12:00:00.000Z",
"createdAt": "2025-03-10T14:30:00.000Z",
"musicName": "original sound - @creator",
"musicAuthor": "@creator",
"musicCoverUrl": "https://..."
}
],
"pagination": {
"total": 47,
"limit": 10,
"offset": 0,
"has_more": true
}
}
Returns a paginated list of all tracked videos in your workspace.
Query parameters
integer
default:"20"
Number of results per page. Min: 1, Max: 100.
integer
default:"0"
Pagination offset. Use with
limit to paginate through results.string
Filter videos posted after this date. Format:
YYYY-MM-DD.string
Filter videos posted before this date. Format:
YYYY-MM-DD.string
Filter by platform. Options:
tiktok, youtube, insta.curl -H "Authorization: Bearer reel25_sk_..." \
"https://api.reel25.com/api/v1/videos?limit=10&offset=0"
const response = await fetch(
'https://api.reel25.com/api/v1/videos?limit=10',
{ headers: { 'Authorization': 'Bearer reel25_sk_...' } }
);
const { data, pagination } = await response.json();
import requests
response = requests.get(
'https://api.reel25.com/api/v1/videos',
headers={'Authorization': 'Bearer reel25_sk_...'},
params={'limit': 10, 'offset': 0}
)
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"trackedVideoId": "9f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"tiktokVideoId": "7234567890123456789",
"url": "https://tiktok.com/@creator/video/7234567890123456789",
"description": "Check out this recipe! #cooking #viral",
"hashtags": ["cooking", "viral"],
"duration": 45,
"thumbnailUrl": "https://...",
"postedAt": "2025-03-10T14:30:00.000Z",
"viewCount": 1250000,
"likeCount": 98000,
"commentCount": 3200,
"shareCount": 15000,
"bookmarkCount": 45000,
"engagementRate": 12.85,
"type": "tiktok",
"accountUsername": "creator",
"accountDisplayName": "Creator Name",
"accountId": "8f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"canonicalAccountId": "8f14e45f-ceea-467f-a6f0-4b3b8c3a0e1d",
"isTracked": true,
"trackedAt": "2025-03-10T15:00:00.000Z",
"lastScrapedAt": "2025-03-15T12:00:00.000Z",
"createdAt": "2025-03-10T14:30:00.000Z",
"musicName": "original sound - @creator",
"musicAuthor": "@creator",
"musicCoverUrl": "https://..."
}
],
"pagination": {
"total": 47,
"limit": 10,
"offset": 0,
"has_more": true
}
}
Was this page helpful?