Skip to main content
GET
/
v1
/
niche
/
{nicheId}
/
videos
curl -X GET "https://api.hooked.so/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
  }
}

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 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.so/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