List User Video Metrics

An overview of the List User Video Metrics

Endpoint Description

Retrieve a list of all videos in the R1 Discover video library watched by users that are within your accessible companies (subscriptions). Endpoints return detail describing watch metrics.

HTTP Method

GET /api/v2/metrics/metrics/videos/companies/{companyId}

Request

Headers:

Content-Type: application/json - Specifies that the request body format is JSON.
Accept: application/json - Indicates that the client expects a JSON response.
Authorization: Bearer {token} - A valid Bearer token must be provided to authenticate the request.

URL Parameters

userId (integer, required): The R1 Discover id of the user to query video data. Example: 1234

Query Parameters:

page (integer, required): Specifies the page number in the pagination sequence to retrieve a specific set of results.
limit (integer, required): Specifies the number of records to retrieve per page, controlling the volume of data returned.

Request Examples

curl --request GET \
    --get "http://r1discoverapi.local/api/v2/metrics/metrics/videos/users/1?page=1&limit=50" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer {token}"

const url = new URL(
    "http://r1discoverapi.local/api/v2/metrics/metrics/videos/users/1"
);

const params = {
    "page": "1",
    "limit": "50",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer {token}",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.r1learning.com/api/v2/metrics/metrics/videos/companies/1?page=1&limit=50");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer {token}");
var content = new StringContent(string.Empty);
content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response

Data Dictionary:

video_log_id (integer): R1 unique identifier for the video log.
video_url (string): The URL to access the video via the Remote Login Token for integration via an iFrame.
user_id (integer): The ID of the user that accessed the video.
video_title (string): The title of the video.
start_time_stamp (string): The date/time the video session was started.
completion_time_stamp (string): The date/time the video session was completed.
watched_percentage (string): The percentage of the video that was watched in this session.
watched_duration (string): The number of seconds of the video that were watched in this session.

Response Examples

{
    "meta": {
        "total_items": 1,
        "total_pages": 1,
        "current_page": 1,
        "per_page": 50
    },
    "data": {
        "user_id": "17434",
        "video_metrics": [
            {
                "video_log_id": 3,
                "video_url": "",
                "user_id": 17434,
                "video_title": "Identify My Stage of Change",
                "start_time_stamp": "2024-01-07T21:56:34.000000Z",
                "completion_time_stamp": "2024-01-07T21:56:44.000000Z",
                "watched_percentage": "100.00",
                "watched_duration": "126.954666"
            }
        ]
    }
}

Postman Link

Notes

Authorization Required: Ensure the provided Bearer token is valid and has sufficient privileges to access the endpoint.
Response Handling: Implement pagination to manage data effectively, especially when dealing with large datasets.

PreviousList Company Video Metrics NextGlobal Endpoints (System)

Last updated 8 months ago