> ## 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.

# Niche Creators

> Get top creators in a specific content niche

## Overview

This endpoint returns top creators posting content within a specific niche. Creators are ranked by their follower count and engagement metrics.

### Path Parameters

<ParamField path="nicheId" type="string" required>
  The niche identifier (e.g., "fitness", "cooking", "gaming")
</ParamField>

### Query Parameters

<ParamField query="platform" type="string">
  Filter by platform:

  * `tiktok`: TikTok creators only
  * `youtube`: YouTube creators only
  * Omit to get creators from all platforms
</ParamField>

<ParamField query="limit" type="number" default="20">
  Number of creators to return (1-50)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Pagination offset
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data">
    <ResponseField name="niche" type="object">
      Niche information including id, label, emoji, and description
    </ResponseField>

    <ResponseField name="creators" type="array">
      Array of creator objects

      <Expandable title="creator">
        <ResponseField name="username" type="string">
          Creator's username/handle
        </ResponseField>

        <ResponseField name="displayName" type="string">
          Creator's display name
        </ResponseField>

        <ResponseField name="platform" type="string">
          Platform (tiktok or youtube)
        </ResponseField>

        <ResponseField name="avatarUrl" type="string">
          URL to creator's profile picture
        </ResponseField>

        <ResponseField name="followers" type="number">
          Follower count
        </ResponseField>

        <ResponseField name="isVerified" type="boolean">
          Whether the creator is verified
        </ResponseField>

        <ResponseField name="videosInNiche" type="number">
          Number of videos in this niche
        </ResponseField>

        <ResponseField name="avgViews" type="number">
          Average view count
        </ResponseField>

        <ResponseField name="avgEngagement" type="number">
          Average engagement rate
        </ResponseField>

        <ResponseField name="profileUrl" type="string">
          Link to creator's profile
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total" type="number">
      Total creators in this niche
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.hooked.so/v1/niche/fitness/creators?limit=10" \
    -H "x-api-key: your_api_key_here"
  ```

  ```javascript Node.js theme={null}
  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);
  ```

  ```python Python theme={null}
  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']
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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
    }
  }
  ```
</ResponseExample>

<Tip>
  Use this endpoint to discover influencers and content creators in your target niche for collaboration or inspiration.
</Tip>


## OpenAPI

````yaml GET /v1/niche/{nicheId}/creators
openapi: 3.0.0
info:
  title: Hooked API
  version: 1.0.0
  description: AI Video Generation API
servers:
  - url: https://api.hooked.so
security:
  - ApiKeyAuth: []
paths:
  /v1/niche/{nicheId}/creators:
    get:
      tags:
        - Niches
      summary: Niche Creators
      description: Get top creators in a specific content niche
      operationId: getNicheCreators
      parameters:
        - name: nicheId
          in: path
          required: true
          schema:
            type: string
        - name: platform
          in: query
          schema:
            type: string
            enum:
              - tiktok
              - youtube
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Success
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````