curl -X GET "https://api.hooked.so/v1/niche/fitness/videos?platform=tiktok&limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/niche/fitness/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/niche/fitness/videos',
params={'platform': 'tiktok', 'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
videos = response.json()['data']['videos']
{
"success": true,
"data": {
"niche": {
"id": "fitness",
"label": "Fitness",
"emoji": "💪",
"description": "Workout routines, fitness tips, and gym content"
},
"videos": [
{
"id": "clx123abc",
"externalId": "7234567890123456789",
"platform": "tiktok",
"title": "5 minute ab workout #fitness",
"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": 2300000,
"likes": 456000,
"comments": 8900,
"shares": 23000
},
"viralScore": 88.5,
"engagementRate": 21.2,
"hashtags": ["fitness", "abs", "workout"],
"publishedAt": "2024-01-15T10:30:00Z"
}
],
"total": 85,
"limit": 10,
"offset": 0
}
}
Niches
Niche Videos
Get trending videos for a specific content niche
GET
/
v1
/
niche
/
{nicheId}
/
videos
curl -X GET "https://api.hooked.so/v1/niche/fitness/videos?platform=tiktok&limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/niche/fitness/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/niche/fitness/videos',
params={'platform': 'tiktok', 'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
videos = response.json()['data']['videos']
{
"success": true,
"data": {
"niche": {
"id": "fitness",
"label": "Fitness",
"emoji": "💪",
"description": "Workout routines, fitness tips, and gym content"
},
"videos": [
{
"id": "clx123abc",
"externalId": "7234567890123456789",
"platform": "tiktok",
"title": "5 minute ab workout #fitness",
"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": 2300000,
"likes": 456000,
"comments": 8900,
"shares": 23000
},
"viralScore": 88.5,
"engagementRate": 21.2,
"hashtags": ["fitness", "abs", "workout"],
"publishedAt": "2024-01-15T10:30:00Z"
}
],
"total": 85,
"limit": 10,
"offset": 0
}
}
Overview
This endpoint returns trending videos within a specific content niche. Use this to discover viral content in your target category.Path Parameters
string
required
The niche identifier (e.g., “fitness”, “cooking”, “gaming”)
Query Parameters
string
Filter by platform:
tiktok: TikTok videos onlyyoutube: YouTube videos only- Omit to get videos from all platforms
number
default:"20"
Number of videos to return (1-50)
number
default:"0"
Pagination offset
Response
boolean
Indicates if the request was successful
object
curl -X GET "https://api.hooked.so/v1/niche/fitness/videos?platform=tiktok&limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/niche/fitness/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/niche/fitness/videos',
params={'platform': 'tiktok', 'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
videos = response.json()['data']['videos']
{
"success": true,
"data": {
"niche": {
"id": "fitness",
"label": "Fitness",
"emoji": "💪",
"description": "Workout routines, fitness tips, and gym content"
},
"videos": [
{
"id": "clx123abc",
"externalId": "7234567890123456789",
"platform": "tiktok",
"title": "5 minute ab workout #fitness",
"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": 2300000,
"likes": 456000,
"comments": 8900,
"shares": 23000
},
"viralScore": 88.5,
"engagementRate": 21.2,
"hashtags": ["fitness", "abs", "workout"],
"publishedAt": "2024-01-15T10:30:00Z"
}
],
"total": 85,
"limit": 10,
"offset": 0
}
}
If the niche ID is invalid, a 404 error will be returned. Use the List Niches endpoint to get valid niche IDs.