For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
StatusSupportDiscussionsLog inSign Up
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
  • ACTIVATE ACCOUNT
    • Create account
  • PRODUCT OS API
    • Overview
  • ERROR CODES
    • Error codes
  • VIDEO ON DEMAND API
    • Overview
  • LIVE STREAM API
    • Overview
  • VIDEO DATA API
    • Overview
      • GETList video views
      • GETGet details of video view
      • GETList by top content
LogoLogo
StatusSupportDiscussionsLog inSign Up
VIDEO DATA APIViews

Get details of video view

GET
https://api.fastpix.com/v1/data/viewlist/:viewId
GET
/v1/data/viewlist/:viewId
$curl https://api.fastpix.com/v1/data/viewlist/viewId \
>     -u "<username>:<password>"
200Retrieved
1{
2  "success": true,
3  "data": {
4    "asnId": 55836,
5    "asnName": "AS55836 Reliance Jio Infocomm Limited",
6    "averageBitrate": 1512855,
7    "avgDownscaling": 0,
8    "avgRequestLatency": 0,
9    "avgRequestThroughput": 12588331,
10    "avgUpscaling": 0,
11    "beaconDomain": "metrix.ws",
12    "browserEngine": null,
13    "browserName": "Chrome",
14    "browserVersion": "Chrome 5.8.3",
15    "bufferCount": 0,
16    "bufferFill": 0,
17    "bufferFrequency": 0,
18    "bufferRatio": 0,
19    "cdn": null,
20    "city": "Gaddi Annaram",
21    "connectionType": "cellular",
22    "continent": "AS",
23    "country": "India",
24    "countryCode": "IN",
25    "custom": {
26      "Custom": [
27        {
28          "dimensionName": "custom_1",
29          "displayName": "displayName-1",
30          "value": "ShortVideo"
31        }
32      ]
33    },
34    "deviceManufacturer": "vivo",
35    "deviceModel": "V2130",
36    "deviceName": "V2130",
37    "deviceType": "Mobile",
38    "drmType": null,
39    "droppedFrameCount": 0,
40    "errorCode": null,
41    "errorContext": null,
42    "errorId": null,
43    "errorMessage": null,
44    "exitBeforeVideoStart": false,
45    "experimentName": null,
46    "fpApiVersion": "1",
47    "fpEmbed": false,
48    "fpEmbedVersion": "1.0.0",
49    "fpLiveStreamId": null,
50    "fpPlaybackId": null,
51    "fpSdk": "media3_fastpix",
52    "fpSdkVersion": "1.0.0",
53    "fpViewerId": "36c707a3-7f9a-48ab-9ba4-416617d20889",
54    "insertTimestamp": "2025-09-24T07:33:53.390Z",
55    "ipAddress": "192.168.136.251",
56    "jumpLatency": 72,
57    "latitude": "17.3669",
58    "liveStreamLatency": null,
59    "longitude": "78.5242",
60    "maxDownscaling": 0,
61    "maxRequestLatency": 0,
62    "maxUpscaling": 0,
63    "mediaId": null,
64    "osName": "Android",
65    "osVersion": "Android 14",
66    "pageContext": null,
67    "pageLoadTime": 0,
68    "playbackScore": 1,
69    "playerAutoplayOn": false,
70    "playerHeight": 383,
71    "playerInitializationTime": 0,
72    "playerInstanceId": "859e3520-acb7-44fc-b856-69aa364de566",
73    "playerLanguage": null,
74    "playerName": null,
75    "playerPoster": null,
76    "playerPreloadOn": false,
77    "playerRemotePlayed": false,
78    "playerResolution": "393x383",
79    "playerSoftwareName": "media3-generic",
80    "playerSoftwareVersion": "1.6.1",
81    "playerSourceDomain": null,
82    "playerSourceHeight": 720,
83    "playerSourceWidth": 1280,
84    "playerVersion": null,
85    "playerViewCount": 0,
86    "playerWidth": 393,
87    "propertyId": null,
88    "qualityOfExperienceScore": 0.969798041615667,
89    "region": "Telangana",
90    "renderQualityScore": 1,
91    "sessionId": "8c7859bf-6d0c-4de8-a1d7-a3d8bdecc977",
92    "sign": "1",
93    "stabilityScore": 1,
94    "startupScore": 0.890174696784244,
95    "subPropertyId": null,
96    "totalStartupTime": 987,
97    "updatedTimestamp": "2025-09-24T07:33:55.074Z",
98    "usedFullScreen": false,
99    "userAgent": "Dalvik/2.1.0 (Linux; U; Android 14; V2130 Build/UP1A.231005.007)",
100    "videoContentType": null,
101    "videoDuration": null,
102    "videoEncodingVariant": null,
103    "videoId": "68d3780f38aec4265abe453a",
104    "videoLanguage": null,
105    "videoProducer": null,
106    "videoResolution": "720X1280",
107    "videoSeries": null,
108    "videoSourceDomain": null,
109    "videoSourceDuration": 30120,
110    "videoSourceHostname": "unknown",
111    "videoSourceStreamType": null,
112    "videoSourceType": null,
113    "videoSourceUrl": null,
114    "videoStartupFailed": false,
115    "videoStartupTime": 987,
116    "videoTitle": "Best practices for identifying and engaging your champion",
117    "videoVariantId": null,
118    "videoVariantName": null,
119    "viewEnd": "2025-09-24T07:33:55.074Z",
120    "viewHasAd": false,
121    "viewHasError": false,
122    "viewId": "202b8e4f-c078-4b98-88c8-6f7c23ba7272",
123    "viewMaxPlayheadPosition": 0,
124    "viewPageUrl": null,
125    "viewPlayingTime": 0,
126    "viewSeekedCount": 1,
127    "viewSeekedDuration": 72,
128    "viewSessionId": "059c5bc2-12fc-45f1-b893-db9f1d0bf7d1",
129    "viewStart": "2025-09-24T07:33:53.390Z",
130    "viewTotalContentPlaybackTime": 0,
131    "viewerId": null,
132    "watchTime": 987,
133    "workspaceId": "fdae281f-b582-4ea0-8694-15fccd1cbd98",
134    "events": [
135      {
136        "player_playhead_time": 0,
137        "event_name": "playerReady",
138        "event_details": {},
139        "viewer_time": 1713156224677,
140        "event_time": "1713156224686"
141      },
142      {
143        "player_playhead_time": 0,
144        "event_name": "viewBegin",
145        "event_details": {},
146        "viewer_time": 1713156224685,
147        "event_time": "1713156224686"
148      },
149      {
150        "player_playhead_time": 0,
151        "event_name": "play",
152        "event_details": {},
153        "viewer_time": 1713156224686,
154        "event_time": "1713156234688"
155      },
156      {
157        "player_playhead_time": 0,
158        "event_name": "waiting",
159        "event_details": {},
160        "viewer_time": 1713156224688,
161        "event_time": "1713156234688"
162      },
163      {
164        "player_playhead_time": 0,
165        "event_name": "loadstart",
166        "event_details": {},
167        "viewer_time": 1713156224693,
168        "event_time": "1713156234688"
169      },
170      {
171        "player_playhead_time": 0,
172        "event_name": "playing",
173        "event_details": {},
174        "viewer_time": 1713156225946,
175        "event_time": "1713156234688"
176      },
177      {
178        "player_playhead_time": 0,
179        "event_name": "variantChanged",
180        "event_details": {},
181        "viewer_time": 1713156225950,
182        "event_time": "1713156234688"
183      },
184      {
185        "player_playhead_time": 326000,
186        "event_name": "seeking",
187        "event_details": {},
188        "viewer_time": 1713156228382,
189        "event_time": "1713156234688"
190      },
191      {
192        "player_playhead_time": 326000,
193        "event_name": "waiting",
194        "event_details": {},
195        "viewer_time": 1713156228384,
196        "event_time": "1713156234688"
197      },
198      {
199        "player_playhead_time": 326000,
200        "event_name": "seeked",
201        "event_details": {},
202        "viewer_time": 1713156229031,
203        "event_time": "1713156234688"
204      },
205      {
206        "player_playhead_time": 326000,
207        "event_name": "playing",
208        "event_details": {},
209        "viewer_time": 1713156229032,
210        "event_time": "1713156234688"
211      },
212      {
213        "player_playhead_time": 326337,
214        "event_name": "waiting",
215        "event_details": {},
216        "viewer_time": 1713156229427,
217        "event_time": "1713156234688"
218      },
219      {
220        "player_playhead_time": 326400,
221        "event_name": "playing",
222        "event_details": {},
223        "viewer_time": 1713156229661,
224        "event_time": "1713156234688"
225      },
226      {
227        "player_playhead_time": 327265,
228        "event_name": "pause",
229        "event_details": {},
230        "viewer_time": 1713156230577,
231        "event_time": "1713156234688"
232      },
233      {
234        "player_playhead_time": 327265,
235        "event_name": "seeking",
236        "event_details": {},
237        "viewer_time": 1713156236178,
238        "event_time": "1713156244691"
239      },
240      {
241        "player_playhead_time": 1496000,
242        "event_name": "seeked",
243        "event_details": {},
244        "viewer_time": 1713156237276,
245        "event_time": "1713156244691"
246      },
247      {
248        "player_playhead_time": 1496010,
249        "event_name": "play",
250        "event_details": {},
251        "viewer_time": 1713156241461,
252        "event_time": "1713156244691"
253      },
254      {
255        "player_playhead_time": 1496021,
256        "event_name": "playing",
257        "event_details": {},
258        "viewer_time": 1713156241479,
259        "event_time": "1713156244691"
260      },
261      {
262        "player_playhead_time": 1500117,
263        "event_name": "pause",
264        "event_details": {},
265        "viewer_time": 1713156245651,
266        "event_time": "1713156245655"
267      },
268      {
269        "player_playhead_time": 1500117,
270        "event_name": "ended",
271        "event_details": {},
272        "viewer_time": 1713156245654,
273        "event_time": "1713156245655"
274      },
275      {
276        "player_playhead_time": 1500117,
277        "event_name": "viewCompleted",
278        "viewer_time": 1713156245657,
279        "event_time": 1713156245658
280      }
281    ]
282  }
283}
Retrieves detailed information about a specific video view using its unique `viewId`. This provides insights into individual viewer interactions with your video content, helping you enhance user experience and improve engagement with your videos. To use this endpoint, send `GET` request with the `viewId`. The response includes detailed metrics and attributes related to the specified video view. #### Example If a developer receives a report of a poor viewing experience for a specific user. By using this endpoint with the users `viewId`, the developer can retrieve metrics like buffering duration, playback errors, and session length. This data allows the developer to pinpoint issues (such as poor connectivity or a browser-specific problem) and take steps to improve the user experience. Related guide: <a href="https://docs.fastpix.io/page/what-video-data-do-we-capture#/">What Video Data do we capture?</a>
Was this page helpful?
Previous

List by top content

Next
Built with

Retrieves detailed information about a specific video view using its unique viewId. This provides insights into individual viewer interactions with your video content, helping you enhance user experience and improve engagement with your videos.

To use this endpoint, send GET request with the viewId. The response includes detailed metrics and attributes related to the specified video view.

Example

If a developer receives a report of a poor viewing experience for a specific user. By using this endpoint with the users viewId, the developer can retrieve metrics like buffering duration, playback errors, and session length. This data allows the developer to pinpoint issues (such as poor connectivity or a browser-specific problem) and take steps to improve the user experience.

Related guide: What Video Data do we capture?

Authentication

AuthorizationBasic

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

  • Username: Access Token ID
  • Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

Path parameters

viewIdstringRequired
Pass View Id

Response

Get a video view by id
successboolean
Shows the request status. Returns true for success and false for failure.
dataobject
Displays the result of the request.