Accessing QXscore metrics via the Results API

This article applies to: UserTesting 

On this page:

• About QXscore
• API endpoint
• Error handling
• Use cases

About QXscore

QXscore (Quality Experience Score) is a composite metric that reflects the quality of the user experience. 

It includes:

• Behavioral: Task success rates — did users complete the goal?
• Attitudinal: Satisfaction score obtained from a questionnaire that measures usability, trust, loyalty, and appearance.

• Aggregated QX Score: One value representing the average of the behavioral and attitudinal scores of all qualified sessions.

   

API endpoint

You can retrieve QX Scores using this endpoint:

GET /api/v2/testResults/{testId}/qxScores

Parameters

Headers

Request sample

curl --location
'https://api.use2.usertesting.com/api/v2/testResults/3fa85f64-5717-4562-
b3fc-2c963f66afa6/qxScores' \
--header 'Authorization: Bearer ACCESS_TOKEN'

Sample response

{
 "testId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
 "qxScores": [
   {
     "taskGroupId": "b1e2c3d4-5678-1234-9abc-def012345678",
     "label": "QXscore 1",
     "qxScore": 38,
     "components": {
       "behavioral": 25,
       "attitudinal": 50
     },
     "values": {
       "behavioral": [
         50,
         50
       ],
       "usability": 50,
       "trust": 50,
       "appearance": 50,
       "loyalty": 50
     }
   }
 ],
 "meta": {
   "totalQxTasks": 1,
   "completes": 2
 }
}
 

Fields explained

• qxScores[]: An array of QX task groups with scores
• components: The behavioral and attitudinal breakdown
• values: Contains behavioral values along with four attitudinal dimensions (usability, trust, appearance, loyalty)
• meta: Test-level metadata

Error handling

Use cases 

• Integrate UserTesting insights into data warehouses (Snowflake, BigQuery, Databricks, etc)
• Build real-time dashboards combining UX metrics with product analytics
• Enable AI-powered insights and automated workflow triggers
• Scale research impact across organizations
   

Related content