Video Analytics

Get video metrics history

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.

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

Path parameters

platform'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat' required

Social media platform (facebook, instagram, tiktok, youtube, snapchat)

Example:facebook
platformVideoIdstring required

Native platform video id found in the URL of the video

Example:7123456789012345678

Query parameters

metricsstring[] required
aggregation'day' | 'week' | 'month'

Response

OK

aggregation'day' | 'week' | 'month' required

Changes

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