Tracking

Start tracking a video

Begin monitoring a video's metrics over time. Each recurring cycle collects fresh metrics and generates an AI report (charged per cycle).

post/v1/tracking/videos

Request

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

Request body

urlstring required

Video URL

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

Platform the account or video is on.

tracking_account_idstring

ID of a tracked creator to associate with

scrape_cadence'six_hours' | 'twelve_hours' | 'daily' | 'every_other_day' | 'weekly' | 'bi_weekly' | 'monthly'

How often to collect metrics and generate an AI report (default: daily)

Example request

{
  "url": "https://www.tiktok.com/@user/video/123",
  "platform": "tiktok",
  "scrape_cadence": "daily"
}

Response

Video tracking enqueued

Example response

{
  "data": {
    "id": "v1d2e3o4-f5g6-h7i8-j9k0-l1m2n3o4p5q6",
    "status": "active",
    "message": "Video tracking started. Initial metrics and AI report are being generated."
  }
}

Changes

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