Videos

The videos endpoint provides access to the top-performing videos published in the last 24 hours. Filter by niche category to discover trending content in specific verticals.

GET/videos/digest

Get videos digest

Returns the top videos published in the last 24 hours, ordered by view count (highest first). Optionally filter by niche category to focus on specific content verticals.

Query parameters

Name
limit
Type
number
Description
Number of top videos to return (1-50). Default is 10.
Name
niche
Type
string
Description
Filter by niche category. See the /niches endpoint for all available options.

Example niche values

Use the niche identifier exactly as shown. Popular niches include:

anime - Character analysis, cosplay, series discussions
reddit-stories - Story time, AITA, relationship drama
horror-scary - True crime, ghost stories, creepy tales
brainrot - Skibidi toilet, Italian chaos, absurd humor
celebrities - Hollywood drama, IShowSpeed, Kardashians
crypto - Bitcoin analysis, trading tips, DeFi strategies
formula-one - Race highlights, driver rivalries, F1 tech
ai-vlogs - Veo 3 generated content, AI characters
podcast-clips - Joe Rogan moments, viral interviews

Request

GET

/videos/digest

curl -G https://api.virlo.ai/videos/digest \
  -H "Authorization: Bearer {token}" \
  -d limit=10 \
  -d niche=anime

Response

{
  "results": 2,
  "data": [
    {
      "id": "e30b40b1-15fa-4d00-8db3-3eb83e94546d",
      "url": "https://www.youtube.com/watch?v=dkCFBauD2F4",
      "publish_date": "2025-10-22T04:00:51",
      "views": 11166267,
      "number_of_likes": 36859,
      "number_of_comments": 23,
      "description": "Noah's amazing toy unboxing ASMR video experience #toys #asmr  #satisfying  #unboxing",
      "thumbnail_url": "6c72771e-a3af-43c0-8951-605474eab5ec.jpg",
      "hashtags": ["#toys", "#asmr", "#satisfying", "#unboxing"],
      "type": "youtube",
      "niche": "asmr",
      "author_id": "b466d69a-cb59-44db-a59f-0f60039a18e8",
      "bookmarks": 0,
      "external_id": "dkCFBauD2F4",
      "region": null,
      "duration": 8
    },
    {
      "id": "65e6604e-7469-4c6c-aa49-cb93b6feac36",
      "url": "https://www.tiktok.com/@dailymail/video/7564023786111028535",
      "publish_date": "2025-10-22T13:00:00",
      "views": 10439698,
      "number_of_likes": 865067,
      "number_of_comments": 12065,
      "description": "She did their job for them 😳 🎥 Newsflare #trash #news #usa #mom",
      "thumbnail_url": "8dfc5b77-72aa-4965-baac-e6627c308ad9.jpg",
      "hashtags": ["trash"],
      "type": "tiktok",
      "niche": "breaking-news",
      "author_id": "16244f6f-4d83-44b2-a627-612f700065ea",
      "bookmarks": 22108,
      "external_id": "7564023786111028535",
      "region": "US",
      "duration": 65
    }
  ]
}

Error responses

The videos digest endpoint may return the following error codes:

Name
400 Bad Request
Description
Invalid parameters provided. Common causes include: - Invalid limit value (must be 1-50) - Invalid niche value (must be one of the valid niche identifiers)
Name
401 Unauthorized
Description
Missing or invalid API key. Ensure you're including your API key in the Authorization header.
Name
429 Too Many Requests
Description
Rate limit exceeded. Your plan has specific rate limits per endpoint. Wait before making additional requests.