YouTube Videos
The YouTube videos endpoint provides access to the top-performing YouTube videos published in the last 24 hours. Filter by niche category to discover trending content in specific verticals on YouTube.
Get YouTube videos digest
Returns the top YouTube 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 discussionsreddit-stories
- Story time, AITA, relationship dramahorror-scary
- True crime, ghost stories, creepy talesbrainrot
- Skibidi toilet, Italian chaos, absurd humorcelebrities
- Hollywood drama, IShowSpeed, Kardashianscrypto
- Bitcoin analysis, trading tips, DeFi strategiesformula-one
- Race highlights, driver rivalries, F1 techai-vlogs
- Veo 3 generated content, AI characterspodcast-clips
- Joe Rogan moments, viral interviews
Request
curl -G https://api.virlo.ai/youtube/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": "3e697300-be24-4ef5-9b6c-b1a9cce56e52",
"url": "https://www.youtube.com/watch?v=JO57an06NLQ",
"publish_date": "2025-10-22T12:00:40",
"views": 8522543,
"number_of_likes": 23676,
"number_of_comments": 7,
"description": "Cool Items!🥰 New Gadgets, Smart Appliances, Kitchen Tools Utensils, Home Cleaning, Beauty #shorts",
"thumbnail_url": "851ec552-d2eb-4fa2-bdf6-17ff836ac93e.jpg",
"hashtags": ["#5Minute", "#BoongItems", "#Appliances", "#UtensilsSmartHome", "#shorts"],
"type": "youtube",
"niche": "e-commerce",
"author_id": "bf8db3f1-ae8e-4203-8a05-3c0645faff19",
"bookmarks": 0,
"external_id": "JO57an06NLQ",
"region": null,
"duration": 6
}
]
}
Error responses
The YouTube 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.