Tracking

List tracked videos

get/v1/tracking/videos

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/tracking/videos
Auth: HTTP bearer

Query parameters

pagenumber

Example:1

Page number, 1-indexed (default 1).

limitnumber

Example:20

Items per page (1-100, default 20). Values above 100 are clamped.

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

Only items from this platform. Omit for all platforms.

searchstring

Search by handle or display name (case-insensitive partial match)

Response

List of tracked videos

Example response

{
  "data": [
    {
      "id": "v1d2e3o4-f5g6-h7i8-j9k0-l1m2n3o4p5q6",
      "platform": "tiktok",
      "url": "https://www.tiktok.com/@khaby.lame/video/7234567890123456789",
      "tracking_account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "active",
      "scrape_cadence": "daily",
      "enrichment_status": "completed",
      "latest_views": 85000000,
      "latest_likes": 6200000,
      "latest_comments": 31000,
      "latest_shares": 450000,
      "latest_bookmarks": 12000,
      "growth_rate": 0.0312,
      "last_scraped_at": "2026-03-23T14:00:00.000Z",
      "next_scrape_at": "2026-03-24T14:00:00.000Z",
      "created_at": "2026-03-20T10:30:00.000Z",
      "updated_at": "2026-03-23T14:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "total_pages": 3,
    "has_next_page": true
  }
}

Changes

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