Tracking

Get metric snapshots for a tracked creator

Time-series of follower/following/video/view/like counts per scrape cycle, each with delta_* fields vs the previous snapshot. Also includes an engagement_rate per snapshot (total_likes / total_views at snapshot time) and delta_engagement_rate, giving a true engagement-rate history over time.

get/v1/tracking/creators/{id}/snapshots

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/tracking/creators/{id}/snapshots
Auth: HTTP bearer

Path parameters

idstring required

UUID of the tracked creator

Query parameters

start_datestring

Start date (ISO 8601). Only return snapshots on or after this date.

end_datestring

End date (ISO 8601). Only return snapshots on or before this date.

limitnumber

Max snapshots to return: the most recent ones in the date range, listed oldest first. Default 30, max 365.

Response

Creator snapshots

Example response

{
  "data": [
    {
      "id": "snap-001",
      "tracking_account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "followers": 162300000,
      "following": 512,
      "subscribers": 8500000,
      "total_likes": 2398000000,
      "total_videos": 1201,
      "total_views": 8455553979,
      "collected_post_count": 35,
      "snapshot_at": "2026-03-22T14:00:00.000Z",
      "delta_followers": 100000,
      "delta_following": 1,
      "delta_total_videos": 2,
      "delta_total_views": 500000,
      "delta_total_likes": 200000,
      "engagement_rate": 0.2836,
      "delta_engagement_rate": -0.0012
    }
  ]
}

Changes

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