Skip to main content
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"

{
  "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 }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.hooked.so/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

This endpoint returns detailed performance metrics and analytics for a specific content niche, including daily trends, platform breakdowns, and top hashtags.

​
Path Parameters

​
nicheId
string
required
The niche identifier (e.g., “fitness”, “cooking”, “gaming”)

​
Query Parameters

​
days
number
default:"7"
Number of days of historical data to include (1-30)

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
curl -X GET "https://api.hooked.so/v1/niche/fitness/metrics?days=7" \
  -H "x-api-key: your_api_key_here"

{
  "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

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`);
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")
Combine niche metrics with the Niche Videos endpoint to identify what makes content go viral in your target category.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
nicheId
string
required

Query Parameters

​
days
integer
default:7

Response

200

Success