--- updatedAt: 2026-04-20T20:28:50.000Z agentTools: projectIndex: https://docs.wistia.com/llms.txt --- # Show Webinar Audience Retrieve audience data for a webinar. Returns a paginated list of registrants with their attendance status, engagement metrics, attribution data, and per-attendee histograms. ## 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 webinar can also be used. # OpenAPI definition ````json { "openapi": "3.1.1", "info": { "title": "Analytics API", "description": "Wistia Analytics API - Bottler-powered analytics endpoints", "version": "2026.09.0" }, "servers": [ { "url": "https://api.wistia.com/modern" } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Analytics:Webinar" } ], "paths": { "/analytics/webinars/{webinarId}/audience": { "get": { "summary": "Show Webinar Audience", "x-speakeasy-group": "analyticsWebinar", "x-speakeasy-name-override": "getAudience", "description": "Retrieve audience data for a webinar. Returns a paginated list of\nregistrants with their attendance status, engagement metrics,\nattribution data, and per-attendee histograms.\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 webinar can also\nbe used.\n\n", "parameters": [ { "name": "webinarId", "in": "path", "description": "The hashed ID of the webinar.", "required": true, "schema": { "description": "The hashed ID of the webinar (e.g., \"abc123xyz\")", "type": "string" } }, { "name": "per_page", "in": "query", "description": "Number of results to return (max 100).", "required": false, "schema": { "type": "integer", "default": 25, "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "description": "Cursor for pagination. Use the value from the previous response's page_info.end_cursor.", "required": false, "schema": { "type": "string" } }, { "name": "X-Wistia-API-Version", "in": "header", "required": true, "schema": { "type": "string", "default": "2026-09" } } ], "responses": { "200": { "description": "Success response with webinar audience data.", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "data": { "type": "array", "items": { "unevaluatedProperties": false, "allOf": [ { "type": "object", "properties": { "first_name": { "description": "The registrant's first name.", "type": [ "string", "null" ] }, "last_name": { "description": "The registrant's last name.", "type": [ "string", "null" ] }, "email": { "description": "The registrant's email address.", "type": [ "string", "null" ] }, "phone_number": { "description": "The registrant's phone number.", "type": [ "string", "null" ] }, "company": { "description": "The registrant's company name.", "type": [ "string", "null" ] }, "job_title": { "description": "The registrant's job title.", "type": [ "string", "null" ] }, "country": { "description": "The registrant's country.", "type": [ "string", "null" ] }, "registered_at": { "description": "When the registrant registered in ISO 8601 format.", "type": [ "string", "null" ], "format": "date-time" }, "attended_at": { "description": "When the registrant joined the live event in ISO 8601 format.", "type": [ "string", "null" ], "format": "date-time" }, "attendance_status": { "description": "Whether the registrant attended the event.", "type": [ "string", "null" ] }, "restriction_status": { "description": "The registrant's restriction status (e.g., approved, blocked).", "type": [ "string", "null" ] }, "origin_method": { "description": "How the registrant was added (e.g., registration_form, import).", "type": [ "string", "null" ] }, "utm_campaign": { "description": "The UTM campaign that referred this registrant.", "type": [ "string", "null" ] }, "utm_source": { "description": "The UTM source that referred this registrant.", "type": [ "string", "null" ] }, "utm_medium": { "description": "The UTM medium that referred this registrant.", "type": [ "string", "null" ] }, "referrer_domain": { "description": "The referring domain for this registrant.", "type": [ "string", "null" ] }, "ip_country": { "description": "The registrant's country based on IP geolocation.", "type": [ "string", "null" ] }, "ip_city": { "description": "The registrant's city based on IP geolocation.", "type": [ "string", "null" ] }, "engagement_rate": { "description": "The registrant's engagement rate during the event (between 0 and 1).", "type": [ "number", "null" ], "format": "float" }, "focused_rate": { "description": "The registrant's focused viewing rate during the event (between 0 and 1).", "type": [ "number", "null" ], "format": "float" }, "played_time": { "description": "Total time the registrant watched in seconds.", "type": [ "integer", "null" ] }, "focused_played_time": { "description": "Total time the registrant watched with the tab focused in seconds.", "type": [ "integer", "null" ] }, "chat_count": { "description": "The number of chat messages sent by this registrant.", "type": [ "integer", "null" ] }, "annotation_click_count": { "description": "The number of annotation clicks by this registrant.", "type": [ "integer", "null" ] }, "poll_responses_count": { "description": "The number of poll responses submitted by this registrant.", "type": [ "integer", "null" ] }, "attendee_histogram": { "description": "Per-bucket attendance data for this registrant.", "type": [ "array", "null" ], "items": { "type": [ "integer", "null" ] } }, "focused_attendee_histogram": { "description": "Per-bucket focused attendance data for this registrant.", "type": [ "array", "null" ], "items": { "type": [ "integer", "null" ] } }, "chats": { "description": "Chat messages sent by this registrant with timestamps.", "type": [ "array" ], "items": { "type": "object", "unevaluatedProperties": false, "properties": { "rounded_player_position": { "description": "The approximate position in the event when the chat was sent (in seconds).", "type": "integer" }, "chats": { "description": "The chat message content.", "type": "array", "items": { "type": "string" } } } } } } } ] } }, "page_info": { "unevaluatedProperties": false, "type": "object", "properties": { "has_next_page": { "description": "Whether there are more results after this page.", "type": "boolean" }, "has_previous_page": { "description": "Whether there are results before this page.", "type": "boolean" }, "end_cursor": { "description": "Cursor to use for fetching the next page.", "type": [ "string", "null" ] }, "start_cursor": { "description": "Cursor to use for fetching the previous page.", "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": "Webinar 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" ] } } } } } }, "503": { "description": "Analytics service is temporarily unavailable", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Analytics service is temporarily unavailable" ] } } } } } } }, "tags": [ "Analytics:Webinar" ], "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.analyticsWebinar.getAudience({\n webinarId: \"\",\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" ] } } ````