---
title: "Start tracking a video"
method: POST
path: "/v1/tracking/videos"
tags: ["Tracking"]
---

# Start tracking a video

`POST /v1/tracking/videos`

## Request

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

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

## Request body

- V1TrackVideoDto
  - `url` string, required: Video URL
  - `platform` 'tiktok' | 'youtube' | 'instagram', required: Platform the account or video is on.
  - `tracking_account_id` string: 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)

## Response `202`

Video tracking enqueued

- TrackVideoResponseDto
  - `data` TrackVideoResultDto, required
    - `id` string, required
    - `status` string, required
    - `message` string, required

## Other responses

- `400`: Invalid request parameters
- `401`: Unauthorized - missing or invalid API key
- `402`: Insufficient credits
- `409`: Already tracked by this account. A video can be tracked once per account, across the web app and the API; the message says where.
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)