---
title: "Get video metrics history"
method: GET
path: "/videos/{platform}/{platformVideoId}/metrics"
tags: ["Video Analytics"]
---

# Get video metrics history

`GET /videos/{platform}/{platformVideoId}/metrics`

## Request

- Base URL: `https://viral.app/api/v1`
- URL: `https://viral.app/api/v1/videos/{platform}/{platformVideoId}/metrics`
- Auth: API key in header `x-api-key`

Retrieves only the requested video metric series for the selected video. Supports day, week, or month aggregation and returns chart-ready buckets from the video's published date through today.

## Path parameters

- `platform` 'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat', required: Social media platform (facebook, instagram, tiktok, youtube, snapchat)
- `platformVideoId` string, required: Native platform video id found in the URL of the video

## Query parameters

- `metrics` string[], required
- `aggregation` 'day' | 'week' | 'month'

## Response `200`

OK

- object: Video metrics with only the requested metric series populated in each returned bucket.
  - `aggregation` 'day' | 'week' | 'month', required
  - `dailyMetrics` object[], required
    - `date` string, required: Bucket start date in ISO format (YYYY-MM-DD)
    - `endDate` string, required: Bucket end date in ISO format (YYYY-MM-DD)
    - `viewCount` number
    - `organicViewCount` number
    - `paidViewCount` number
    - `likeCount` number
    - `commentCount` number
    - `shareCount` number
    - `bookmarkCount` number
    - `engagementRate` number

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `404`: 404
- `408`: 408
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/viral/apis/viral-app-api.md) · [All operations](https://skmtc.dev/viral/apis/viral-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viral/apis/viral-app-api/revisions/31e97fa79ef1?raw)