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

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

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 top creators posting content within a specific niche. Creators are ranked by their follower count and engagement metrics.

​
Path Parameters

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

​
Query Parameters

​
platform
string
Filter by platform:
  • tiktok: TikTok creators only
  • youtube: YouTube creators only
  • Omit to get creators from all platforms
​
limit
number
default:"20"
Number of creators to return (1-50)
​
offset
number
default:"0"
Pagination offset

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
curl -X GET "https://api.hooked.so/v1/niche/fitness/creators?limit=10" \
  -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"
    },
    "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.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
nicheId
string
required

Query Parameters

​
platform
enum<string>
Available options:
tiktok,
youtube
​
limit
integer
default:20
​
offset
integer
default:0

Response

200

Success