curl -X GET "https://api.hooked.so/v1/trends/videos?platform=tiktok&limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/trends/videos?platform=tiktok&limit=10', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.videos);
import requests
response = requests.get(
'https://api.hooked.so/v1/trends/videos',
params={'platform': 'tiktok', 'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
videos = response.json()['data']['videos']
{
"success": true,
"data": {
"videos": [
{
"id": "clx123abc",
"externalId": "7234567890123456789",
"platform": "tiktok",
"title": "This fitness hack changed my life #fitness #workout",
"thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
"videoUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
"creator": {
"username": "fitnessguru",
"displayName": "Fitness Guru",
"avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
"followers": 1500000,
"isVerified": true
},
"stats": {
"views": 5400000,
"likes": 890000,
"comments": 12500,
"shares": 45000
},
"viralScore": 92.5,
"engagementRate": 17.5,
"hashtags": ["fitness", "workout", "gym"],
"niche": "fitness",
"publishedAt": "2024-01-15T10:30:00Z"
}
],
"total": 150,
"limit": 10,
"offset": 0
}
}
Trends
Trending Videos
Get currently trending viral videos across platforms
GET
/
v1
/
trends
/
videos
curl -X GET "https://api.hooked.so/v1/trends/videos?platform=tiktok&limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/trends/videos?platform=tiktok&limit=10', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.videos);
import requests
response = requests.get(
'https://api.hooked.so/v1/trends/videos',
params={'platform': 'tiktok', 'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
videos = response.json()['data']['videos']
{
"success": true,
"data": {
"videos": [
{
"id": "clx123abc",
"externalId": "7234567890123456789",
"platform": "tiktok",
"title": "This fitness hack changed my life #fitness #workout",
"thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
"videoUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
"creator": {
"username": "fitnessguru",
"displayName": "Fitness Guru",
"avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
"followers": 1500000,
"isVerified": true
},
"stats": {
"views": 5400000,
"likes": 890000,
"comments": 12500,
"shares": 45000
},
"viralScore": 92.5,
"engagementRate": 17.5,
"hashtags": ["fitness", "workout", "gym"],
"niche": "fitness",
"publishedAt": "2024-01-15T10:30:00Z"
}
],
"total": 150,
"limit": 10,
"offset": 0
}
}
Overview
This endpoint returns trending viral videos from TikTok and YouTube. Videos are ranked by viral score and filtered to show only the latest trending content.Query Parameters
string
Filter by platform:
tiktok: TikTok videos onlyyoutube: YouTube videos only- Omit to get videos from all platforms
string
Filter by niche ID (e.g., “fitness”, “cooking”, “gaming”). Use the List Niches endpoint to get available niches.
number
default:"20"
Number of videos to return (1-50)
number
default:"0"
Pagination offset
Response
boolean
Indicates if the request was successful
object
Show data
Show data
array
Array of trending video objects
Show video
Show video
string
Internal video ID
string
Platform-specific video ID
string
Platform (tiktok or youtube)
string
Video title or caption
string
URL to video thumbnail
string
Direct URL to watch the video
object
Creator information
object
Video statistics (views, likes, comments, shares)
number
Viral score (0-100)
number
Engagement rate percentage
array
Array of hashtags used
string
Content niche category
string
Publication date (ISO 8601)
number
Total number of trending videos
number
Current limit applied
number
Current offset applied
curl -X GET "https://api.hooked.so/v1/trends/videos?platform=tiktok&limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/trends/videos?platform=tiktok&limit=10', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.videos);
import requests
response = requests.get(
'https://api.hooked.so/v1/trends/videos',
params={'platform': 'tiktok', 'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
videos = response.json()['data']['videos']
{
"success": true,
"data": {
"videos": [
{
"id": "clx123abc",
"externalId": "7234567890123456789",
"platform": "tiktok",
"title": "This fitness hack changed my life #fitness #workout",
"thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
"videoUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
"creator": {
"username": "fitnessguru",
"displayName": "Fitness Guru",
"avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
"followers": 1500000,
"isVerified": true
},
"stats": {
"views": 5400000,
"likes": 890000,
"comments": 12500,
"shares": 45000
},
"viralScore": 92.5,
"engagementRate": 17.5,
"hashtags": ["fitness", "workout", "gym"],
"niche": "fitness",
"publishedAt": "2024-01-15T10:30:00Z"
}
],
"total": 150,
"limit": 10,
"offset": 0
}
}
Notes
Trending videos are updated regularly. The
isLatestViral flag ensures you only see the most current trending content.Combine platform and niche filters to find relevant trending content for your specific audience.