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

# List Niches

> Get all available content niches for trend analysis

## Overview

This endpoint returns all available content niches that can be used to filter trends and analyze content categories.

### Response

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

<ResponseField name="data" type="object">
  <Expandable title="data">
    <ResponseField name="niches" type="array">
      Array of niche objects

      <Expandable title="niche">
        <ResponseField name="id" type="string">
          Unique niche identifier (e.g., "fitness", "cooking")
        </ResponseField>

        <ResponseField name="label" type="string">
          Display name for the niche
        </ResponseField>

        <ResponseField name="emoji" type="string">
          Emoji icon representing the niche
        </ResponseField>

        <ResponseField name="description" type="string">
          Brief description of the niche
        </ResponseField>

        <ResponseField name="keywords" type="array">
          Array of keywords associated with this niche
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total" type="number">
      Total number of niches available
    </ResponseField>
  </Expandable>
</ResponseField>

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

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.hooked.so/v1/niche/list', {
    headers: {
      'x-api-key': 'your_api_key_here'
    }
  });

  const data = await response.json();
  console.log(data.data.niches);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.hooked.so/v1/niche/list',
      headers={'x-api-key': 'your_api_key_here'}
  )

  niches = response.json()['data']['niches']
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "niches": [
        {
          "id": "fitness",
          "label": "Fitness",
          "emoji": "💪",
          "description": "Workout routines, fitness tips, and gym content",
          "keywords": ["workout", "gym", "fitness", "exercise", "training"]
        },
        {
          "id": "cooking",
          "label": "Cooking",
          "emoji": "🍳",
          "description": "Recipes, cooking tutorials, and food content",
          "keywords": ["recipe", "cooking", "food", "kitchen", "chef"]
        },
        {
          "id": "gaming",
          "label": "Gaming",
          "emoji": "🎮",
          "description": "Video game content, streams, and gaming tutorials",
          "keywords": ["gaming", "gamer", "videogames", "gameplay", "esports"]
        }
      ],
      "total": 40
    }
  }
  ```
</ResponseExample>

## Available Niches

The platform currently supports 40+ content niches including:

* **Lifestyle**: Fashion, Beauty, Travel, Home & Garden
* **Entertainment**: Comedy, Music, Dance, Art
* **Education**: Science, Technology, DIY, Business
* **Health**: Fitness, Wellness, Mental Health
* **Content**: Gaming, Sports, News, Motivation

<Tip>
  Use niche IDs when filtering trending videos or analyzing niche-specific metrics.
</Tip>


## OpenAPI

````yaml GET /v1/niche/list
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/list:
    get:
      tags:
        - Niches
      summary: List Niches
      description: Get all available content niches for trend analysis
      operationId: listNiches
      responses:
        '200':
          description: Success
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````