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

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

Request

GET
/youtube/videos/digest
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.

Was this page helpful?