curl -H "Authorization: Bearer reel25_sk_..." \
"https://api.reel25.com/api/v1/folders/f1a2b3c4-.../videos?sort=views&sort_order=desc&limit=10"
const response = await fetch(
'https://api.reel25.com/api/v1/folders/f1a2b3c4-.../videos?sort=views&limit=10',
{ headers: { 'Authorization': 'Bearer reel25_sk_...' } }
);
const { data } = await response.json();
import requests
response = requests.get(
f'https://api.reel25.com/api/v1/folders/{folder_id}/videos',
headers={'Authorization': 'Bearer reel25_sk_...'},
params={'sort': 'views', 'limit': 10}
)
{
"data": [
{
"id": "550e8400-...",
"description": "Viral cooking video #recipe",
"viewCount": 5200000,
"likeCount": 420000,
"engagementRate": 10.25,
"postedAt": "2025-03-01T10:00:00.000Z",
"username": "creator",
"type": "tiktok"
}
],
"total": 120,
"currentPage": 1,
"totalPages": 4
}
Folder Videos
List Folder Videos
Retrieve videos in a folder
GET
/
api
/
v1
/
folders
/
{id}
/
videos
curl -H "Authorization: Bearer reel25_sk_..." \
"https://api.reel25.com/api/v1/folders/f1a2b3c4-.../videos?sort=views&sort_order=desc&limit=10"
const response = await fetch(
'https://api.reel25.com/api/v1/folders/f1a2b3c4-.../videos?sort=views&limit=10',
{ headers: { 'Authorization': 'Bearer reel25_sk_...' } }
);
const { data } = await response.json();
import requests
response = requests.get(
f'https://api.reel25.com/api/v1/folders/{folder_id}/videos',
headers={'Authorization': 'Bearer reel25_sk_...'},
params={'sort': 'views', 'limit': 10}
)
{
"data": [
{
"id": "550e8400-...",
"description": "Viral cooking video #recipe",
"viewCount": 5200000,
"likeCount": 420000,
"engagementRate": 10.25,
"postedAt": "2025-03-01T10:00:00.000Z",
"username": "creator",
"type": "tiktok"
}
],
"total": 120,
"currentPage": 1,
"totalPages": 4
}
Returns a paginated list of videos inside a folder with sorting and date filtering.
Path parameters
string
required
The folder UUID.
Query parameters
integer
default:"20"
Number of results per page. Min: 1, Max: 100.
integer
default:"0"
Pagination offset.
string
default:"uploaded"
Sort field. Options:
views, likes, comments, shares, engagement_rate, uploaded.string
default:"desc"
Sort direction. Options:
asc, desc.string
Filter videos posted after this date. Format:
YYYY-MM-DD.string
Filter videos posted before this date. Format:
YYYY-MM-DD.curl -H "Authorization: Bearer reel25_sk_..." \
"https://api.reel25.com/api/v1/folders/f1a2b3c4-.../videos?sort=views&sort_order=desc&limit=10"
const response = await fetch(
'https://api.reel25.com/api/v1/folders/f1a2b3c4-.../videos?sort=views&limit=10',
{ headers: { 'Authorization': 'Bearer reel25_sk_...' } }
);
const { data } = await response.json();
import requests
response = requests.get(
f'https://api.reel25.com/api/v1/folders/{folder_id}/videos',
headers={'Authorization': 'Bearer reel25_sk_...'},
params={'sort': 'views', 'limit': 10}
)
{
"data": [
{
"id": "550e8400-...",
"description": "Viral cooking video #recipe",
"viewCount": 5200000,
"likeCount": 420000,
"engagementRate": 10.25,
"postedAt": "2025-03-01T10:00:00.000Z",
"username": "creator",
"type": "tiktok"
}
],
"total": 120,
"currentPage": 1,
"totalPages": 4
}
Was this page helpful?