Dimension: video

Product(s)
Video Cloud
Role(s)
API Developer
Topic(s)
Analytics
API(s)
Analytics API

In this topic, you will learn about the Analytics API videos dimension. The video dimension provides analytics by video.

URL parameters

Analytics API reports support the following URL parameters.

URL Parameters
Parameter Description Required Values Default
account The accounts you want to report on yes one or more account ids as a comma-delimited list none
dimensions The dimension(s) to report on yes one or more dimensions as a comma-delimited list (some combinations are not valid) none
where Used to specify filters for reports no {dimension}=={value} - one or more as a semi-colon-delimited list none
limit Number of items to return no positive integer 10
offset Number of items to skip no positive integer 0
sort Field to sort items on no a valid field for the request video_view
fields Fields to return no varies according to the dimension you are reporting on video_view
format Format to return results in no json | csv | xlxs json
reconciled If included, will limit results to either historical or realtime data no true | false true
from The beginning of the date range for the request no An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string alltime, or relative date (-1m); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false. 30 days prior to now
to The end of the date range for the request no An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string now, or relative data (+7d); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false. now

Fields available

The following fields can be returned for the dimension.

  • ad_mode_begin
  • ad_mode_complete
  • bytes_delivered
  • engagement_score
  • play_request
  • play_rate
  • video
  • video_duration
  • video_engagement_1
  • video_engagement_100
  • video_engagement_25
  • video_engagement_50
  • video_engagement_75
  • video_impression
  • video_name
  • video_percent_viewed
  • video_seconds_viewed
  • video_view
  • video.reference_id
  • video.name
  • video.description
  • video.complete
  • video.created_at
  • video.duration
  • video.economics
  • video.long_description
  • video.state
  • video.tags
  • video.updated_at
  • video.custom_fields.{field_name}
  • video_download_request
  • video_download_complete
  • video_download_cancellation
  • video_download_error

Filter values

Used as a filter, a dimension allows you to narrow the results.

Filter values: video ids as a comma-delimited list or video.q=={video field}:{value}

Combining dimensions

To see what dimensions this on can be combined with, and what fields are available for the combination, see Dimension and Fields.

Request Examples

Dimension request

https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video

Filter request

https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video&where=video==4093643993001,1754276206001

Response

Response will appear here when you test a request