Skip to main content
GET
/
v1
/
trends
/
videos
curl -X GET "https://api.hooked.ai/v1/trends/videos?platform=tiktok&limit=10" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "videos": [
      {
        "id": "clx123abc",
        "externalId": "7234567890123456789",
        "platform": "tiktok",
        "title": "This fitness hack changed my life #fitness #workout",
        "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": 5400000,
          "likes": 890000,
          "comments": 12500,
          "shares": 45000
        },
        "viralScore": 92.5,
        "engagementRate": 17.5,
        "hashtags": ["fitness", "workout", "gym"],
        "niche": "fitness",
        "publishedAt": "2024-01-15T10:30:00Z"
      }
    ],
    "total": 150,
    "limit": 10,
    "offset": 0
  }
}

​
Overview

This endpoint returns trending viral videos from TikTok and YouTube. Videos are ranked by viral score and filtered to show only the latest trending content.

​
Query Parameters

​
platform
string
Filter by platform:
  • tiktok: TikTok videos only
  • youtube: YouTube videos only
  • Omit to get videos from all platforms
​
niche
string
Filter by niche ID (e.g., “fitness”, “cooking”, “gaming”). Use the List Niches endpoint to get available niches.
​
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/trends/videos?platform=tiktok&limit=10" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "videos": [
      {
        "id": "clx123abc",
        "externalId": "7234567890123456789",
        "platform": "tiktok",
        "title": "This fitness hack changed my life #fitness #workout",
        "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": 5400000,
          "likes": 890000,
          "comments": 12500,
          "shares": 45000
        },
        "viralScore": 92.5,
        "engagementRate": 17.5,
        "hashtags": ["fitness", "workout", "gym"],
        "niche": "fitness",
        "publishedAt": "2024-01-15T10:30:00Z"
      }
    ],
    "total": 150,
    "limit": 10,
    "offset": 0
  }
}

​
Notes

Trending videos are updated regularly. The isLatestViral flag ensures you only see the most current trending content.
Combine platform and niche filters to find relevant trending content for your specific audience.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
platform
enum<string>
Available options:
tiktok,
youtube
​
niche
string
​
limit
integer
default:20
​
offset
integer
default:0

Response

200

Success