--- updatedAt: 2026-04-20T20:27:13.000Z agentTools: projectIndex: https://docs.wistia.com/llms.txt --- # Show Media Stats Retrieve stats for a video. This endpoint provides statistics for a specific video identified by its media-id. ## Requires api token with one of the following permissions ``` Read detailed stats ``` Tokens with the "Act with a team member's permissions" permission (`all:delegate_to_contact_permissions` scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token. An [expiring access token](https://docs.wistia.com/reference/post_expiring-token) created with the `all:delegate_to_contact_permissions` scope and an authorization granting the `view-stats` permission on this media can also be used. # OpenAPI definition ````json { "openapi": "3.1.1", "info": { "title": "Stats API", "description": "Wistia Stats API", "version": "2026.09.0" }, "servers": [ { "url": "https://api.wistia.com/modern" } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Stats:Media" } ], "paths": { "/stats/medias/{mediaId}": { "get": { "summary": "Show Media Stats", "x-speakeasy-group": "statsMedia", "x-speakeasy-name-override": "get", "description": "Retrieve stats for a video. This endpoint provides statistics for a specific video identified by its media-id.\n\n\n## Requires api token with one of the following permissions\n```\nRead detailed stats\n```\n\nTokens with the \"Act with a team member's permissions\" permission\n(`all:delegate_to_contact_permissions` scope) can also be used. Requests\nmade with such a token are authorized using the permissions of the\ncontact assigned to the token.\n\nAn [expiring access token](https://docs.wistia.com/reference/post_expiring-token)\ncreated with the `all:delegate_to_contact_permissions` scope and an\nauthorization granting the `view-stats` permission on this media can also\nbe used.\n\n", "parameters": [ { "name": "mediaId", "in": "path", "description": "The hashed ID or ID of the video for which you want to retrieve stats.", "required": true, "schema": { "description": "The hashed ID or numeric ID of the media (e.g., \"4d23503f70\" or \"22570\")", "type": "string" } }, { "name": "X-Wistia-API-Version", "in": "header", "required": true, "schema": { "type": "string", "default": "2026-09" } } ], "responses": { "200": { "description": "Success response with the stats of the video.", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "load_count": { "description": "The total number of times this video has been loaded.", "type": "integer" }, "play_count": { "description": "The total number of times this video has been played.", "type": "integer" }, "play_rate": { "description": "The percentage of visitors who clicked play (between 0 and 1).", "type": "number", "format": "float" }, "hours_watched": { "description": "The total time spent watching this video.", "type": "number", "format": "float" }, "engagement": { "description": "The average percentage of the video that gets viewed (between 0 and 1).", "type": "number", "format": "float" }, "visitors": { "description": "The total number of unique people that have loaded this video.", "type": "integer" }, "actions": { "type": "array", "items": { "unevaluatedProperties": false, "type": "object", "properties": { "type": { "description": "Type of action (e.g., \"Call to Action\").", "type": "string" }, "action_count": { "description": "Number of actions performed.", "type": "integer" }, "impression_count": { "description": "Number of times the action was shown.", "type": "integer" }, "rate": { "description": "The rate of actions performed over impressions.", "type": "number", "format": "float" }, "url": { "description": "For action types that link out (e.g., post-roll CTA), the URL the viewer was directed to.", "type": [ "string", "null" ] }, "text": { "description": "For action types that include display text (e.g., post-roll CTA), the text shown to the viewer.", "type": [ "string", "null" ] } } } } } } } } }, "401": { "description": "Unauthorized, invalid or missing token", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "code": { "description": "A machine-readable identifier for the specific authorization failure.", "type": "string", "enum": [ "unauthorized_credentials", "account_inactive", "unauthorized_scope", "unauthorized_params" ] }, "error": { "type": "string", "examples": [ "Invalid credentials." ] } } } } } }, "403": { "description": "Forbidden, token is valid but account does not have access to feature", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Webinars are not available on your current plan" ] } } } } } }, "404": { "description": "Media not found or does not belong to account", "content": {} }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Internal server error" ] } } } } } } }, "tags": [ "Stats:Media" ], "x-readme": { "code-samples": [ { "name": "Typescript (SDK)", "language": "javascript", "code": "import { Wistia } from \"@wistia/wistia-api-client\";\n\nconst wistia = new Wistia({\n bearerAuth: process.env[\"WISTIA_BEARER_AUTH\"] ?? \"\",\n});\n\nasync function run() {\n const result = await wistia.statsMedia.get({\n mediaId: \"\",\n });\n\n console.log(result);\n}\n\nrun();" } ] } } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer" } } }, "x-readme": { "samples-languages": [ "javascript", "shell", "node", "python", "ruby" ] } } ````