curl -X GET "https://api.hooked.so/v1/niche/fitness/metrics?days=7" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/niche/fitness/metrics?days=7', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.summary);
import requests
response = requests.get(
'https://api.hooked.so/v1/niche/fitness/metrics',
params={'days': 7},
headers={'x-api-key': 'your_api_key_here'}
)
metrics = response.json()['data']
print(f"Total views: {metrics['summary']['totalViews']}")
{
"success": true,
"data": {
"niche": {
"id": "fitness",
"label": "Fitness",
"emoji": "💪",
"description": "Workout routines, fitness tips, and gym content"
},
"period": {
"days": 7,
"startDate": "2024-01-08T00:00:00Z",
"endDate": "2024-01-15T00:00:00Z"
},
"summary": {
"totalVideos": 245,
"totalViews": 156000000,
"totalLikes": 12500000,
"totalComments": 890000,
"totalShares": 2300000,
"avgViralScore": 72.5,
"avgEngagementRate": 10.2
},
"platforms": {
"tiktok": {
"videos": 180,
"views": 120000000
},
"youtube": {
"videos": 65,
"views": 36000000
}
},
"dailyMetrics": [
{
"date": "2024-01-15",
"views": 23000000,
"likes": 1800000,
"comments": 125000,
"shares": 340000,
"videos": 35,
"avgViralScore": 74.2,
"avgEngagement": 10.8,
"platforms": {
"tiktok": { "views": 18000000, "videos": 26 },
"youtube": { "views": 5000000, "videos": 9 }
}
}
],
"topHashtags": [
{ "hashtag": "fitness", "count": 189 },
{ "hashtag": "workout", "count": 156 },
{ "hashtag": "gym", "count": 134 },
{ "hashtag": "fitnessmotivation", "count": 98 },
{ "hashtag": "training", "count": 87 }
]
}
}
Niches
Niche Metrics
Get performance metrics and analytics for a content niche
GET
/
v1
/
niche
/
{nicheId}
/
metrics
curl -X GET "https://api.hooked.so/v1/niche/fitness/metrics?days=7" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/niche/fitness/metrics?days=7', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.summary);
import requests
response = requests.get(
'https://api.hooked.so/v1/niche/fitness/metrics',
params={'days': 7},
headers={'x-api-key': 'your_api_key_here'}
)
metrics = response.json()['data']
print(f"Total views: {metrics['summary']['totalViews']}")
{
"success": true,
"data": {
"niche": {
"id": "fitness",
"label": "Fitness",
"emoji": "💪",
"description": "Workout routines, fitness tips, and gym content"
},
"period": {
"days": 7,
"startDate": "2024-01-08T00:00:00Z",
"endDate": "2024-01-15T00:00:00Z"
},
"summary": {
"totalVideos": 245,
"totalViews": 156000000,
"totalLikes": 12500000,
"totalComments": 890000,
"totalShares": 2300000,
"avgViralScore": 72.5,
"avgEngagementRate": 10.2
},
"platforms": {
"tiktok": {
"videos": 180,
"views": 120000000
},
"youtube": {
"videos": 65,
"views": 36000000
}
},
"dailyMetrics": [
{
"date": "2024-01-15",
"views": 23000000,
"likes": 1800000,
"comments": 125000,
"shares": 340000,
"videos": 35,
"avgViralScore": 74.2,
"avgEngagement": 10.8,
"platforms": {
"tiktok": { "views": 18000000, "videos": 26 },
"youtube": { "views": 5000000, "videos": 9 }
}
}
],
"topHashtags": [
{ "hashtag": "fitness", "count": 189 },
{ "hashtag": "workout", "count": 156 },
{ "hashtag": "gym", "count": 134 },
{ "hashtag": "fitnessmotivation", "count": 98 },
{ "hashtag": "training", "count": 87 }
]
}
}
Overview
This endpoint returns detailed performance metrics and analytics for a specific content niche, including daily trends, platform breakdowns, and top hashtags.Path Parameters
string
required
The niche identifier (e.g., “fitness”, “cooking”, “gaming”)
Query Parameters
number
default:"7"
Number of days of historical data to include (1-30)
Response
boolean
Indicates if the request was successful
object
Show data
Show data
object
Niche information including id, label, emoji, and description
object
Time period information (days, startDate, endDate)
object
object
Platform-specific breakdown of videos and views
array
Daily metrics with views, likes, comments, shares, and platform breakdowns
array
Most used hashtags in this niche with usage counts
curl -X GET "https://api.hooked.so/v1/niche/fitness/metrics?days=7" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/niche/fitness/metrics?days=7', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.summary);
import requests
response = requests.get(
'https://api.hooked.so/v1/niche/fitness/metrics',
params={'days': 7},
headers={'x-api-key': 'your_api_key_here'}
)
metrics = response.json()['data']
print(f"Total views: {metrics['summary']['totalViews']}")
{
"success": true,
"data": {
"niche": {
"id": "fitness",
"label": "Fitness",
"emoji": "💪",
"description": "Workout routines, fitness tips, and gym content"
},
"period": {
"days": 7,
"startDate": "2024-01-08T00:00:00Z",
"endDate": "2024-01-15T00:00:00Z"
},
"summary": {
"totalVideos": 245,
"totalViews": 156000000,
"totalLikes": 12500000,
"totalComments": 890000,
"totalShares": 2300000,
"avgViralScore": 72.5,
"avgEngagementRate": 10.2
},
"platforms": {
"tiktok": {
"videos": 180,
"views": 120000000
},
"youtube": {
"videos": 65,
"views": 36000000
}
},
"dailyMetrics": [
{
"date": "2024-01-15",
"views": 23000000,
"likes": 1800000,
"comments": 125000,
"shares": 340000,
"videos": 35,
"avgViralScore": 74.2,
"avgEngagement": 10.8,
"platforms": {
"tiktok": { "views": 18000000, "videos": 26 },
"youtube": { "views": 5000000, "videos": 9 }
}
}
],
"topHashtags": [
{ "hashtag": "fitness", "count": 189 },
{ "hashtag": "workout", "count": 156 },
{ "hashtag": "gym", "count": 134 },
{ "hashtag": "fitnessmotivation", "count": 98 },
{ "hashtag": "training", "count": 87 }
]
}
}
Use Cases
Track niche performance over time
Track niche performance over time
Use the
dailyMetrics array to visualize trends and identify the best days for posting.const bestDay = dailyMetrics.reduce((best, day) =>
day.avgEngagement > best.avgEngagement ? day : best
);
console.log(`Best day: ${bestDay.date} with ${bestDay.avgEngagement}% engagement`);
Compare platform performance
Compare platform performance
Use the
platforms breakdown to understand where your niche performs best.platforms = metrics['platforms']
if platforms['tiktok']['views'] > platforms['youtube']['views']:
print("TikTok is performing better in this niche")
Discover trending hashtags
Discover trending hashtags
Use
topHashtags to find the most effective hashtags for your content.Combine niche metrics with the Niche Videos endpoint to identify what makes content go viral in your target category.
⌘I