Niches

The niches endpoint provides access to content categories and trending themes within specific verticals. Discover what's trending in formula-one, anime, crypto, and more.


GET/niches

Get niches

Returns a list of all active niche categories available in the system. Use these niche identifiers to query specific trends.

Request

GET
/niches
curl https://api.virlo.ai/niches \
  -H "Authorization: Bearer {token}"

Response

{
  "results": 68,
  "data": [
    {
      "id": "motivational",
      "label": "Motivational"
    },
    {
      "id": "reddit-stories",
      "label": "Reddit Stories"
    },
    {
      "id": "basketball",
      "label": "Basketball"
    },
    {
      "id": "crypto",
      "label": "Crypto"
    },
    {
      "id": "finance",
      "label": "Finance"
    },
    {
      "id": "anime",
      "label": "Anime"
    },
    {
      "id": "gaming",
      "label": "Gaming"
    },
    {
      "id": "formula-one",
      "label": "Formula One"
    },
    {
      "id": "us-politics",
      "label": "US Politics"
    }
    // ... 68 niches total (we add new niches regularly)
  ]
}

GET/niches/:nicheId/trends

Returns all trends for the latest analysis date (in the last 24 hours) for a specific niche. Each trend includes the theme title, description, and average views.

Path parameters

  • Name
    nicheId
    Type
    string
    Description

    The niche identifier (e.g., anime, reddit-stories, brainrot). Use the Get niches endpoint to retrieve available niche IDs.

Request

GET
/niches/:nicheId/trends
curl https://api.virlo.ai/niches/anime/trends \
  -H "Authorization: Bearer {token}"

Response

{
  "results": 3,
  "data": [
    {
      "trend_name": "K-Pop Demon Hunters Netflix series content",
      "trend_description": "The new Netflix series 'K-Pop Demon Hunters' is generating massive views with analysis videos, character breakdowns, and soundtrack content. This crossover of K-pop and anime aesthetics is resonating strongly.",
      "average_views": 414392
    },
    {
      "trend_name": "Demon Slayer character content and cosplay",
      "trend_description": "Demon Slayer content is dominating with character showcases, cosplay videos, and character analysis performing exceptionally well. Multiple videos featuring Tanjiro, Giyu, Zenitsu, and other characters are getting strong engagement.",
      "average_views": 103289
    },
    {
      "trend_name": "Naruto character analysis and edits",
      "trend_description": "Naruto content focusing on specific characters like Kakashi is performing well, with character analysis and edit videos getting solid engagement from the established fanbase.",
      "average_views": 60511
    }
  ]
}

Error responses

The niches endpoints may return the following error codes:

  • Name
    401 Unauthorized
    Description

    Missing or invalid API key. Ensure you're including your API key in the Authorization header.

  • Name
    404 Not Found
    Description

    The specified niche ID was not found or has no trends available for the current analysis period. Use the /niches endpoint to get a list of valid niche IDs.

  • Name
    429 Too Many Requests
    Description

    Rate limit exceeded. Your plan has specific rate limits per endpoint. Wait before making additional requests.

Was this page helpful?