Skip to main content
GET
/
v1
/
niche
/
{nicheId}
/
videos
curl -X GET "https://api.hooked.ai/v1/niche/fitness/videos?platform=tiktok&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"
    },
    "videos": [
      {
        "id": "clx123abc",
        "externalId": "7234567890123456789",
        "platform": "tiktok",
        "title": "5 minute ab workout #fitness",
        "thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
        "videoUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
        "creator": {
          "username": "fitnessguru",
          "displayName": "Fitness Guru",
          "avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
          "followers": 1500000,
          "isVerified": true
        },
        "stats": {
          "views": 2300000,
          "likes": 456000,
          "comments": 8900,
          "shares": 23000
        },
        "viralScore": 88.5,
        "engagementRate": 21.2,
        "hashtags": ["fitness", "abs", "workout"],
        "publishedAt": "2024-01-15T10:30:00Z"
      }
    ],
    "total": 85,
    "limit": 10,
    "offset": 0
  }
}

Overview

This endpoint returns trending videos within a specific content niche. Use this to discover viral content in your target category.

Path Parameters

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

Query Parameters

platform
string
Filter by platform:
  • tiktok: TikTok videos only
  • youtube: YouTube videos only
  • Omit to get videos from all platforms
limit
number
default:"20"
Number of videos 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.ai/v1/niche/fitness/videos?platform=tiktok&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"
    },
    "videos": [
      {
        "id": "clx123abc",
        "externalId": "7234567890123456789",
        "platform": "tiktok",
        "title": "5 minute ab workout #fitness",
        "thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
        "videoUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
        "creator": {
          "username": "fitnessguru",
          "displayName": "Fitness Guru",
          "avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
          "followers": 1500000,
          "isVerified": true
        },
        "stats": {
          "views": 2300000,
          "likes": 456000,
          "comments": 8900,
          "shares": 23000
        },
        "viralScore": 88.5,
        "engagementRate": 21.2,
        "hashtags": ["fitness", "abs", "workout"],
        "publishedAt": "2024-01-15T10:30:00Z"
      }
    ],
    "total": 85,
    "limit": 10,
    "offset": 0
  }
}
If the niche ID is invalid, a 404 error will be returned. Use the List Niches endpoint to get valid niche IDs.

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