curl -X GET "https://api.hooked.so/v1/niche/fitness/creators?limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/niche/fitness/creators?limit=10', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.creators);
import requests
response = requests.get(
'https://api.hooked.so/v1/niche/fitness/creators',
params={'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
creators = response.json()['data']['creators']
{
"success": true,
"data": {
"niche": {
"id": "fitness",
"label": "Fitness",
"emoji": "💪",
"description": "Workout routines, fitness tips, and gym content"
},
"creators": [
{
"username": "fitnessguru",
"displayName": "Fitness Guru",
"platform": "tiktok",
"avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
"followers": 1500000,
"isVerified": true,
"videosInNiche": 12,
"avgViews": 2300000,
"avgEngagement": 18.5,
"profileUrl": "https://www.tiktok.com/@fitnessguru"
},
{
"username": "gymlife",
"displayName": "Gym Life",
"platform": "youtube",
"avatarUrl": "https://yt3.ggpht.com/avatar.jpg",
"followers": 890000,
"isVerified": false,
"videosInNiche": 8,
"avgViews": 450000,
"avgEngagement": 12.3,
"profileUrl": "https://www.youtube.com/@gymlife"
}
],
"total": 45
}
}
Niches
Niche Creators
Get top creators in a specific content niche
GET
/
v1
/
niche
/
{nicheId}
/
creators
curl -X GET "https://api.hooked.so/v1/niche/fitness/creators?limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/niche/fitness/creators?limit=10', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.creators);
import requests
response = requests.get(
'https://api.hooked.so/v1/niche/fitness/creators',
params={'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
creators = response.json()['data']['creators']
{
"success": true,
"data": {
"niche": {
"id": "fitness",
"label": "Fitness",
"emoji": "💪",
"description": "Workout routines, fitness tips, and gym content"
},
"creators": [
{
"username": "fitnessguru",
"displayName": "Fitness Guru",
"platform": "tiktok",
"avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
"followers": 1500000,
"isVerified": true,
"videosInNiche": 12,
"avgViews": 2300000,
"avgEngagement": 18.5,
"profileUrl": "https://www.tiktok.com/@fitnessguru"
},
{
"username": "gymlife",
"displayName": "Gym Life",
"platform": "youtube",
"avatarUrl": "https://yt3.ggpht.com/avatar.jpg",
"followers": 890000,
"isVerified": false,
"videosInNiche": 8,
"avgViews": 450000,
"avgEngagement": 12.3,
"profileUrl": "https://www.youtube.com/@gymlife"
}
],
"total": 45
}
}
Overview
This endpoint returns top creators posting content within a specific niche. Creators are ranked by their follower count and engagement metrics.Path Parameters
string
required
The niche identifier (e.g., “fitness”, “cooking”, “gaming”)
Query Parameters
string
Filter by platform:
tiktok: TikTok creators onlyyoutube: YouTube creators only- Omit to get creators from all platforms
number
default:"20"
Number of creators to return (1-50)
number
default:"0"
Pagination offset
Response
boolean
Indicates if the request was successful
object
Show data
Show data
object
Niche information including id, label, emoji, and description
array
Array of creator objects
Show creator
Show creator
string
Creator’s username/handle
string
Creator’s display name
string
Platform (tiktok or youtube)
string
URL to creator’s profile picture
number
Follower count
boolean
Whether the creator is verified
number
Number of videos in this niche
number
Average view count
number
Average engagement rate
string
Link to creator’s profile
number
Total creators in this niche
curl -X GET "https://api.hooked.so/v1/niche/fitness/creators?limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/niche/fitness/creators?limit=10', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.creators);
import requests
response = requests.get(
'https://api.hooked.so/v1/niche/fitness/creators',
params={'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
creators = response.json()['data']['creators']
{
"success": true,
"data": {
"niche": {
"id": "fitness",
"label": "Fitness",
"emoji": "💪",
"description": "Workout routines, fitness tips, and gym content"
},
"creators": [
{
"username": "fitnessguru",
"displayName": "Fitness Guru",
"platform": "tiktok",
"avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
"followers": 1500000,
"isVerified": true,
"videosInNiche": 12,
"avgViews": 2300000,
"avgEngagement": 18.5,
"profileUrl": "https://www.tiktok.com/@fitnessguru"
},
{
"username": "gymlife",
"displayName": "Gym Life",
"platform": "youtube",
"avatarUrl": "https://yt3.ggpht.com/avatar.jpg",
"followers": 890000,
"isVerified": false,
"videosInNiche": 8,
"avgViews": 450000,
"avgEngagement": 12.3,
"profileUrl": "https://www.youtube.com/@gymlife"
}
],
"total": 45
}
}
Use this endpoint to discover influencers and content creators in your target niche for collaboration or inspiration.
⌘I