Raw

Comments on a video

Top-level comments on one video (no replies). Takes a TikTok video, YouTube video or Instagram post by url or id (exactly one); the format is not checked. 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}/video/comments

Request

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

Path parameters

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

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

Query parameters

urlstring
Example:https://www.tiktok.com/@khaby.lame/video/7137423965982592302

Video URL as shared on the platform. Pass exactly one of url or id.

idstring
Example:7137423965982592302

Platform video ID (TikTok numeric ID, YouTube video ID, Instagram shortcode). Pass exactly one of url or id.

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": "7138000000000000000",
      "likes": 120,
      "reply_count": 4,
      "author": {
        "id": "6784563164518679557",
        "handle": "khaby.lame",
        "display_name": "Khabane lame"
      }
    }
  ]
}

Changes

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