Raw

A creator's videos

A creator's recent videos, newest first. YouTube returns Shorts only and Instagram returns Reels only. One platform page per call. Follow pagination.next_cursor for more; page sizes are set by the platform. Live data fetched at request time, not stored by Virlo. Typical latency is a few seconds, up to about 25 s. 1 credit ($0.01) per call, including an empty page. Errors (400, 404, 5xx) are not billed.

get/v1/raw/{platform}/creator/{handle}/videos

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/raw/{platform}/creator/{handle}/videos
Auth: HTTP bearer

Path parameters

platform'tiktok' | 'youtube' | 'instagram' required

Example:tiktok

Platform. youtube covers YouTube Shorts and instagram covers Instagram Reels.

handlestring required

Example:khaby.lame

Creator handle, with or without the leading @. On YouTube a channel ID (UC...) also works.

Query parameters

cursorstring

Opaque cursor from pagination.next_cursor of the previous page. Omit for the first page. Pass it back unchanged with the same path and query; any change returns 400 invalid_cursor. A cursor can expire after 6 hours (also 400 invalid_cursor); then request the first page again.

Response

Example response

{
  "data": [
    {
      "id": "7137423965982592302",
      "platform": "tiktok",
      "url": "https://www.tiktok.com/@khaby.lame/video/7137423965982592302",
      "hashtags": [
        "fyp",
        "comedy"
      ],
      "published_at": "2026-10-01T14:03:00.000Z",
      "duration_seconds": 21,
      "author": {
        "id": "6784563164518679557",
        "handle": "khaby.lame",
        "display_name": "Khabane lame"
      },
      "stats": {
        "views": 1200000,
        "likes": 85000,
        "comments": 1200,
        "shares": 3400,
        "saves": 5100
      },
      "sound": {
        "title": "original sound"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.