Raw

Search videos by keyword

Keyword search on the platform, in the platform's own ranking order. 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}/search

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/raw/{platform}/search
  • Auth: HTTP bearer

Path parameters

platform'tiktok' | 'youtube' | 'instagram' required
Example:tiktok

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

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.

qstring required
Example:morning routine

Search keyword or phrase, 1-200 characters.

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.