Skip to navigation
Working with video data

Identify top-performing content

Use FastPix Video Data APIs to find your most-watched videos and break engagement down by device type.

Business goal: Identify popular videos to prioritize marketing efforts.

Here’s the API workflow below:


Step 1: List all the video views

Fetch all views for a campaign using the list video views endpoint:

Request
curl --request GET \
     --url 'https://api.fastpix.io/v1/data/viewlist?timespan[]=30:days&orderBy=view_end&sortOrder=desc' \
     --header 'accept: application/json' \
     --user '{Access_Token}:{Secret_Key}'

Returns 314 views sorted by view_end time.

Response
{
  "success": true,
  "data": [
    {
      "viewId": "cc6f0f74-5b7e-4f8b-b70a-9edd57aedd5c",
      "operatingSystem": "MacOS",
      "application": "Chrome",
      "viewStartTime": "2025-03-26T12:43:00.757",
      "viewEndTime": "2025-03-26T12:43:19.861",
      "videoTitle": "Knives Out",
      "errorCode": null,
      "errorMessage": null,
      "errorId": null,
      "country": "IN",
      "viewWatchTime": 20005,
      "QoeScore": 0.9758551881413913
    },
    {
      "viewId": "be8d99b0-4dad-4b5c-9444-552963f280c3",
      "operatingSystem": "MacOS",
      "application": "Chrome",
      "viewStartTime": "2025-03-26T11:54:52.64",
      "viewEndTime": "2025-03-26T11:55:03.068",
      "videoTitle": "The Mandalorian / Season 1 / EP -1",
      "errorCode": null,
      "errorMessage": null,
      "errorId": null,
      "country": "IN",
      "viewWatchTime": 1697,
      "QoeScore": 0.5
    },
    {
      "viewId": "c6dac770-9174-4064-884c-64402f749b2c",
      "operatingSystem": "MacOS",
      "application": "Chrome",
      "viewStartTime": "2025-03-26T07:04:36.008",
      "viewEndTime": "2025-03-26T07:05:15.598",
      "videoTitle": "Knives Out",
      "errorCode": null,
      "errorMessage": null,
      "errorId": null,
      "country": "IN",
      "viewWatchTime": 40033,
      "QoeScore": 0.9704809194376256
    }
  ],
  "pagination": {
    "totalRecords": 314,
    "currentOffset": 1,
    "offsetCount": 32
  },
  "timespan": [
    1740402124,
    1742994124
  ]
}

Step 2: List by top viewed content

Aggregate views by video title using the list by top content endpoint:

Request
curl --request GET \
     --url 'https://api.fastpix.io/v1/data/viewlist/top-content?timespan[]=30:days&limit=10&offset=1' \
     --header 'accept: application/json'

The response below clearly shows the video title “Knives Out” is the most viewed content compared to others with 276 views and 24 unique views.


Response
{
  "success": true,
  "data": [
    { "videoTitle": "Knives Out",                                "views": 276, "uniqueViews": 24 },
    { "videoTitle": "The Mandalorian / Season 1 / EP -1",        "views": 10,  "uniqueViews": 8  },
    { "videoTitle": "Crimson City Chronicles / Season 2 / EP-1", "views": 6,   "uniqueViews": 3  },
    { "videoTitle": "Silent Waters",                             "views": 5,   "uniqueViews": 4  },
    { "videoTitle": "Crimson City Chronicles / Season 1 / EP-1", "views": 5,   "uniqueViews": 2  },
    { "videoTitle": "Test series FastPix video / Season 1 / EP-1", "views": 4, "uniqueViews": 4  },
    { "videoTitle": "Test series api video / Season 2 / EP-1",   "views": 3,   "uniqueViews": 3  },
    { "videoTitle": "The Rise of Tech Giants - FastPix / Season 1 / EP 1", "views": 2, "uniqueViews": 1 },
    { "videoTitle": "test",                                      "views": 1,   "uniqueViews": 1  },
    { "videoTitle": "The Rise of Tech Giants -FastPix / Season 2 / EP -2", "views": 1, "uniqueViews": 1 }
  ],
  "timespan": [
    1740402286,
    1742994286
  ]
}

Step 3: List breakdown values

Segment top content by device using the list breakdown values endpoint:

curl --request GET \
     --url 'https://api.fastpix.io/v1/data/metrics/views/breakdown?timespan[]=30:days&filterby[]=video_title:Knives Out&groupBy=device_type' \
     --header 'accept: application/json'

The response gives you an observation that 97.8% of playbacks come from mobile devices.

Outcome: Optimize mobile playback and create short-form versions of top videos.

Response
{
  "success": true,
  "metadata": {
    "aggregation": "view_start"
  },
  "data": [
    {
      "views": 260,
      "value": 260,
      "totalWatchTime": 52012995,
      "totalPlayingTime": 62043103,
      "field": "Phone"
    },
    {
      "views": 15,
      "value": 15,
      "totalWatchTime": 1301418,
      "totalPlayingTime": 1318049,
      "field": "Desktop"
    },
    {
      "views": 1,
      "value": 1,
      "totalWatchTime": 31795,
      "totalPlayingTime": 107,
      "field": "TV"
    }
  ],
  "pagination": {
    "totalRecords": 3,
    "currentOffset": 1,
    "offsetCount": 1
  },
  "timespan": [
    1740402442,
    1742994442
  ]
}

See also