---
title: "Get metric snapshots for a tracked creator"
method: GET
path: "/v1/tracking/creators/{id}/snapshots"
tags: ["Tracking"]
---

# Get metric snapshots for a tracked creator

`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

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.

## Path parameters

- `id` string, required

## Query parameters

- `start_date` string
- `end_date` string
- `limit` number

## Response `200`

Creator snapshots

- CreatorSnapshotsResponseDto
  - `data` CreatorSnapshotDataDto[], required
    - `id` string, required
    - `tracking_account_id` string, required
    - `followers` number, nullable
    - `following` number, nullable
    - `subscribers` number, nullable: Subscriber count (YouTube). Null on platforms that do not expose it.
    - `total_likes` number, nullable
    - `total_videos` number, nullable
    - `total_views` number, nullable: Total views. For YouTube this is the profile-level view count from the platform. For TikTok and Instagram this is computed from collected posts (see collected_post_count).
    - `collected_post_count` number, required: Number of collected posts used to compute total_views. 0 when total_views comes directly from the platform (YouTube).
    - `snapshot_at` string, required
    - `delta_followers` number, nullable: Change in followers since previous snapshot (null for first snapshot)
    - `delta_following` number, nullable: Change in following since previous snapshot
    - `delta_total_videos` number, nullable: Change in total videos since previous snapshot
    - `delta_total_views` number, nullable: Change in total views since previous snapshot
    - `delta_total_likes` number, nullable: Change in total likes since previous snapshot
    - `engagement_rate` number, nullable: Engagement rate at snapshot time, computed as total_likes / total_views. Null when total_views is 0/unknown. Series across snapshots = engagement-rate history.
    - `delta_engagement_rate` number, nullable: Change in engagement_rate since previous snapshot (null for first snapshot)

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `404`: Tracked creator not found
- `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)