vidinfra
  1. Analytics
vidinfra
  • Documentation
    • Guides
      • Welcome
      • Getting Started
        • What is Vidinfra?
        • Quick Start Guide
        • Publish First Video
        • FAQs
      • Upload & Import Videos
        • Upload from Device
        • Import from Vimeo
        • Import from YouTube
        • Import from Zoom
      • DRM
        • Widevine DRM
        • FairPlay DRM
      • Accounts
        • Accounts
      • Organization Settings
        • User Management
        • Billing
        • Settings
  • API Reference
    • Auth
      • User Registration
      • User Login
      • Verify-email
      • Forgot Password
      • Forgot Password Verify OTP
      • Forgot Password Set
      • Resend OTP
      • Logout
      • Set Password
      • Check Account exists
      • Update Password
      • Google Oauth Redirect
      • Google Oauth Callback
      • api-access-check
      • New Auth token using Refresh token
      • Github Oauth Redirect
      • Google Oauth Callback Copy
      • Get User Sessions
      • Delete User Sessions
    • User
      • Profiles
      • Profile Updates
      • Profile Avatar update
    • Projects
      • Get projects list
      • Get project
      • Create New Project
      • Destory Project
      • Update project
      • upload logo
      • Get Project Settings
      • Upsert Project Settings
    • Organization
      • List organizations
      • Create an organization
      • Get an organization
      • Update an organization
      • Switch an organization
    • Organization's invitations
      • Sent invitation list
      • Send invitation
      • Show Token
      • Accept Invitation
      • Reject Invitation
    • Audits
      • Audits
    • Members
      • Members
      • test permission
    • API Keys
      • Get All API keys
      • Get API Key
      • Create API Keys
      • Destory API Keys
      • api key middleware (test)
    • Folders
      • Get All Folders
      • Create Folder
      • Get Folder by ID
      • Update Folder
      • Move Folder
      • Bulk Move Folders (empty)
      • Delete Folder
      • Get Folder Tree
    • Videos
      • Get All video of a project
      • Get a Video
      • Get Video using Custom field
      • create video
      • Upload thumbnail
      • Update video
      • Destroy video
      • Search Video
      • batch video Assign to collecition
      • Mark Thumbnail As Default
      • Get Video Timelines
    • Video Metas
      • Create or Update Video Meta Data
      • Get All Meta Data of a Video
    • Video Captions
      • create video caption
      • Delete a video Caption
      • Get video caption
    • Video Chapter
      • create video chapters
    • Uploads
    • Tags
      • Get all tags upder a project
      • Create Tag
      • Delete tag
    • Players
      • Get all Players
      • Create Player
      • Get Specific player
      • update player
      • Delete Player
      • Player Mark as default
    • Webhook Endpoints
      • Get webhook
      • create web hook
      • GET Webhook by ID
      • Update webhook
      • Delete web hook
    • Advertisements
      • get all ads
      • create ads
      • get single advertisement
      • Update ads
      • Delete ads
    • Migrate
      • welcome
      • Debug
      • test
    • Webhook Event Logs
      • Get webhook event logs
      • Resend Webhook event by Id
      • Resend All Webhook Event
    • Analytics Direct Api
      • geo-distribution
      • Project Views
      • avg video watch
      • Total watch Time
      • Project Avg Watch per Unique user
      • Total Player Error
      • project popularity-analysis
      • Project Collection Insights
      • Collection Views
      • Collection avg Watch time
      • Collection Avg Watch per unique user
      • Collection Geo Distribution
      • Get all Users
      • User media views
      • User Avg video watch
      • user Player log
      • user sessions
      • Get all Video
      • video Player error
      • Video View
      • video Geo Distribution
      • video Avg watch
      • copy
    • Streams
      • Create livestream
      • Get all stream
      • Get a livestream
      • update status of livestream
      • delete a stream
      • get livestream historys
    • Stream Metas
    • Usages
      • Bandwidth Usage
      • Storage Usage
      • Get Over Usage
    • Encoding profile
      • Get all profiles
      • Create profile
      • Get A profile
      • Update a encoding profile
      • Delete a encoding profile
      • Make a profile default
    • Project Matrics
      • Get Matrics
      • project Usages
    • Access Control
      • Put Access Control
      • Get access Control
    • Analytics
      • Project Get geo-distribution
        GET
      • project views
        GET
      • Project avg video watch
        GET
      • Project Total Watch
        GET
      • Project Avg Watch per Unique user
        GET
      • Project All Player Errors
        GET
      • Project Popularity Analysis
        GET
      • Project Collections insights
        GET
      • Collection Geo Distribution
        GET
      • Collection avg watch time
        GET
      • Collection avg watch per unique User
        GET
      • Collection Player error
        GET
      • Video Geo Distribution
        GET
      • Video views
        GET
      • Video Avg Watch
        GET
      • Video Player Log
        GET
      • User
        GET
      • User Avg Video Watch
        GET
      • User Total Watch
        GET
      • User player error log
        GET
    • Plan
      • public plans
      • current plan
      • Account Plans
      • Get plan by ID
      • Admin Get Plans
      • Admin Create plan
      • Admin Get Plan by ID
      • Admin Update Plan by ID
      • Admin Delete plan By ID
      • Admin Get Plan Metrices
      • Admin Get Plan Metrices By Type
      • Admin Create Plan Matrices By Type
      • Admin Update Plan Metrices By ID
    • Upload Tokens
      • Obtain credentials before upload
    • subscribe
      • stripe redirect subscription
        • create checkout session
        • over usage payment
      • current subscription
      • discribe a plan by planCode
      • subscribe
      • cancel subscription
      • over usage payment
      • Stripe over usage autopay payment (test)
    • Transaction
      • Get All Transaction
    • Invoice
      • Get All Invoices
      • Get Invoice by ID
    • vimeo video importer
      • vimeo job list
      • Vimeo videos by migration id
      • Vimeo Set video importer
      • Vimeo sync import
      • Vimeo import videos
      • Get pull videos
      • pull video from url
    • test
      • Welcome to vidinfra Copy
      • metrics
    • transcoding service
      • get all jobs
      • get a job
      • create jobs
      • Update a job
      • Delete a job
      • create job v2
    • transcoding service v2
      • create jobs
      • get all jobs
      • get a job
      • Update a job
      • Delete a job
    • Welcome to vidinfra
      GET
    • health check
      GET
    • Regions List
      GET
    • key
      POST
    • Untitled Endpoint
      GET
  1. Analytics

Project avg video watch

Developing
GET
/projects/{projId}/analytics/{analyticsType}
Provides the Avg Video Watch By Region of a project
📣 this endpoint provides the Avg Video Watch By Region of the contents of the project across different regions
✳ list of request parameters
start_time
end_time
group_by = geo_region
🔰 this endpoint gives all the avgerage views information analytics of the project
📢 Info message : Here URL is contructed like
GET /projects/<project_id>/analytics/avg-video-watch?start_time=<time>&end_time=<time>&group_by=geo_region
here time should be formated in RFC3339
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.vidinfra.com/v1/projects/66a1084b-4b6b-4001-a4ad-d34d13463068/analytics/avg-video-watch'
Response Response Example
200 - OK - Success
{"message":"project analytics resource was found.","result":{"message":"Dataset retrieved successfully","result":{"filters":[],"group_bys":["geo_region"],"metrics":[{"data":[{"avg_media_watch_time":169.72610294117646,"geo_region":""},{"avg_media_watch_time":3.5238095238095237,"geo_region":"Al Asimah"},{"avg_media_watch_time":2,"geo_region":"Al Aḩmadī"},{"avg_media_watch_time":1,"geo_region":"Baghdad"},{"avg_media_watch_time":261.28205128205127,"geo_region":"Barisal Division"},{"avg_media_watch_time":107.88010899182561,"geo_region":"Chittagong"},{"avg_media_watch_time":240.70274068868588,"geo_region":"Dhaka Division"},{"avg_media_watch_time":6.444444444444445,"geo_region":"England"},{"avg_media_watch_time":355.7063492063492,"geo_region":"Khulna Division"},{"avg_media_watch_time":105.70121951219512,"geo_region":"Mymensingh Division"},{"avg_media_watch_time":1539,"geo_region":"National Capital Territory of Delhi"},{"avg_media_watch_time":183.92926045016077,"geo_region":"Rajshahi Division"},{"avg_media_watch_time":278.49532710280374,"geo_region":"Rangpur Division"},{"avg_media_watch_time":41.5,"geo_region":"Sylhet Division"}],"filters":null,"group_bys":["geo_region"],"name":"avg_media_watch_time"}]}},"success":true}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
projId
string 
required
Example:
66a1084b-4b6b-4001-a4ad-d34d13463068
analyticsType
string 
required
Example:
avg-video-watch
Query Params
start_time
string 
optional
Example:
2024-02-24T17:59:59.999Z
end_time
string 
optional
Example:
2024-03-02T17:59:59.999Z
group_by
string 
optional
Example:
geo_region

Responses

🟢200OK
application/json
Body
message
string 
required
result
object 
required
message
string 
required
result
array [object {6}] 
required
success
boolean 
required
🟢200OK
Modified at 2025-06-19 04:59:01
Previous
project views
Next
Project Total Watch
Built with