Video Geo Distribution
Developing
GET
/projects/{projId}/videos/{videoId}/analytics/{analyticsType}
Provides the Geo distributed Usage of a Video
GET
/projects/<project_id>/videos/<video_id>/analytics/geo-distribution?start_time=<time>&end_time=<time>&group_by=geo_region
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.vidinfra.com/v1/projects/66a1084b-4b6b-4001-a4ad-d34d13463068/videos/a16297d4-6146-44b8-9b0f-e0bdcbfa2705/analytics/geo-distribution'
Response Response Example
200 - OK - Success
{"message":"collection analytics was found.","result":{"message":"Dataset retrieved successfully","result":{"filters":[{"field":"media_series","operator":"equal","values":["384bf2ba-1fcb-4de8-9411-6d68000eb3c7"]}],"group_bys":["geo_region"],"metrics":[{"data":[{"geo_region":"","total_media_views":1707},{"geo_region":"Al Asimah","total_media_views":27},{"geo_region":"Al Aḩmadī","total_media_views":1},{"geo_region":"Baghdad","total_media_views":12},{"geo_region":"Barisal Division","total_media_views":130},{"geo_region":"Chittagong","total_media_views":1348},{"geo_region":"Dhaka Division","total_media_views":4445},{"geo_region":"England","total_media_views":20},{"geo_region":"Khulna Division","total_media_views":366},{"geo_region":"Lombardy","total_media_views":1},{"geo_region":"Mohafazat Liban-Nord","total_media_views":1},{"geo_region":"Muscat","total_media_views":14},{"geo_region":"Mymensingh Division","total_media_views":433},{"geo_region":"Rajshahi Division","total_media_views":1045},{"geo_region":"Rangpur Division","total_media_views":327},{"geo_region":"Sylhet Division","total_media_views":165},{"geo_region":"West Bengal","total_media_views":11},{"geo_region":"Île-de-France","total_media_views":1}],"filters":null,"group_bys":["geo_region"],"name":"total_media_views"}]}},"success":true}
Request
Path Params
projId
stringÂ
required
Example:
66a1084b-4b6b-4001-a4ad-d34d13463068
videoId
stringÂ
required
Example:
a16297d4-6146-44b8-9b0f-e0bdcbfa2705
analyticsType
stringÂ
required
Example:
geo-distribution
Query Params
start_time
stringÂ
optional
Example:
2024-02-25T17:59:59.999Z
end_time
stringÂ
optional
Example:
2024-03-03T17:59:59.999Z
group_by
stringÂ
optional
Example:
geo_region
Responses
Modified at 2025-06-19 04:59:01