v1

latestOpenAPI 3.0.02026-07-2493247.1 KB

Video Data

Obtain a video download link

Returns a pre-signed URL to download a test session video. The URL is valid for one hour; after expiration, request a new URL.

Compatibility:

Sessions must be found within tests with the "STUDYV2" type and belong to one of the following product types:
- "LIVE_CONVERSATION" (non-classic live conversation)
- "NON_THINK_OUT_LOUD" (interaction test)
- "THINK_OUT_LOUD" (think-out-loud test).
Go to How to Obtain a Test ID (UUID) for details.

Use case examples:

For an example on how to securely download and manage session videos at scale using pre-signed URLs, go to Process Session Videos at Scale.
For an example on how to integrate video downloads into an automated research data pipeline, go to Create an Automated Pipeline.

get/api/v2/sessionResults/{sessionId}/videoDownloadUrl

Path parameters

sessionIdstring uuid required

ID of the test session the video you want to retrieve belongs to.

Response

Video download URL successfully returned.

videoUrlstring url required

Pre-signed URL to download the video file. Valid for one hour.

sessionIdstring uuid required

ID of the Interaction test session the video corresponds to.

expiresAtstring date-time required

Expiration timestamp of the video download URL. UTC time. ISO 8601 format.

Example response

{
  "videoUrl": "https://mock-bucket.s3.amazonaws.com/videos/123e4567-e89b-12d3-a456-426614174000/session.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20260114%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260114T120000Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "expiresAt": "2025-10-01T12:00:00Z"
}