| Learn how the Results API lets you connect UserTesting results directly into your tools, dashboards, and workflows. |
This article applies to: UserTesting
Results API for surveys and interaction tests is available on the following subscriptions:
| Advanced ✓ | Ultimate ✓ | Ultimate+ ✓ |
On this page:
- About Results API
- Using API endpoints
- How to generate an access token
- How to use an access token
- How to obtain a testId (UUID)
- What can you do with the Results API?
About Results API
- Results API is for surveys and interaction tests
- Results API is a set of endpoints that can help you analyze and gather in-depth data
from test and session results.
Base URL
https://api.use2.usertesting.com
Summary of available endpoints:
| Endpoint | Purpose |
| GET api/v2/testResults/{testId}/qxScores | Returns a list of the aggregated QXscore task results for the test. |
| GET api/v2/sessionResults?testId={testId} |
Returns a list of completed session results for a particular test. This will return a list of Summary objects. To get detailed session results information, the user will need to call the /api/v2/sessionResults/{sessionId} endpoint with the individual session ID. |
| GET api/v2/sessionResults/{sessionId} | To get a detailed response for a particular session, will include participant demographic information and the individual task results for that session. |
| GET api/v2/sessionResults/{sessionId}/videoDownloadUrl | To generate a video, download link. |
| GET api/v2/sessionResults/{sessionId}/transcript | To get a video session’s transcript in VTT format. |
To learn more about each endpoint, select the links below:
Use cases:
- Automated research pipelines
- Real-time action triggers and insight delivery
- AI analysis and insight generation
- Custom dashboards and internal UX portals
Using API endpoints
- To use any of our API endpoints, you must provide an access token in the header.
- To generate an access token, you must first obtain your client credentials.
Prerequisites
- Ensure that your email address has been added as a team member to the workspaces you intend to query data from. Contact an account admin for assistance.
- Contact support@usertesting.com to register your email address for API use and request your client credentials.
- The support team will then send you your credentials (client ID and client secret) through a secure channel, for example, a 1Password link.
Note: Do not share your client credentials.
How to generate an access token
| Note: Access tokens expire after 3600 seconds (1 hour). A new access token must be generated after the expiration time to make further requests. |
After obtaining your client credentials, use the following endpoint to generate an access token:
Header and URL
POST https://auth.usertesting.com/oauth2/aus1p3vtd8vtm4Bxv0h8/v1/token
| Header | Value |
| Content-Type | dapplication/x-www-form-urlencoded |
Request body URL-endcoded form
| Key | Value |
| client_id | CLIENT_ID |
| client_secret | CLIENT_SECRET |
| grant_type | client_credentials |
| scope | studies:read |
Replace the CLIENT_ID and CLIENT_SECRET placeholders with the values provided by the UserTesting support team. After sending the request, you will receive a response that includes the access token. Do not share the access token and store it in a safe place.
How to use an access token
Use the value of the access_token property from the response in the header of all the
endpoint requests you make.
For all API requests, add the following header:
| Header | Value |
| Authorization | Bearer ACCESS_TOKEN |
How to obtain a testId (UUID)
- For some requests, you’ll need to provide the testId of the test you want to get data from.
- The testId is a universally unique identifier (UUID) format, such as surveys and interaction tests.
To obtain a testId, follow these steps:
- Log in to the UserTesting app.
- On the navigation panel, select a workspace.
- Then, select Tests.
- Now, in the Tests section, select All test types button to sort tests by one of the compatible test types, for example: Survey or Unmoderated > Interaction test.
- Choose the test you want to request data for through the API.
- In your browser’s address bar, copy the UUID found in the URL.
- Make your API request using the UUID you just copied.
What can you do with the Results API?
With structured access to UserTesting data, you can:
-
Automate research workflows
- Export complete test results. Including videos, screener responses, and metrics into data warehouses like Snowflake, BigQuery, or Databricks
- Eliminate manual downloads with nightly syncs or scheduled jobs
-
Trigger near real-time actions
- Push “failed task” events into tools like Jira, Asana, or Slack
- Automatically notify teams when usability issues or negative sentiment is detected
-
Power AI and LLM Analysis
- Feed transcripts and videos into LLMs, notebooks, or internal AI platforms
- Enable summarization, clustering, and auto-generated UX recommendations
-
Build custom dashboards
- Visualize UX trends across tests in Looker, Power BI, or Tableau
- Track QXscores, task performance, and participant feedback over time
Related content
|
Want to learn more? Check out these Knowledge Base articles... |
Interested in growing your skills? Check out our University courses... |
|
Need hands-on training?
|
Can't find your answer?
|