Skip to main content
Wistia’s Data API exposes viewer-level analytics that most video platforms hide — individual visitor engagement, per-second heatmaps, CTA click-through rates, and viewing history tied to email addresses. These five jobs pull that data through Mavera’s surfaces (Personas, Mave Agent, Focus Groups, Brand Voice, Generate) to map viewers to psychographic personas, diagnose drop-off points with creative fixes, test CTA variations with synthetic panels, build a brand voice profile from spoken content, and generate personalized follow-up emails for your highest-intent viewers.

API Reference Card

All examples use two environment variables: WISTIA_API_TOKEN and MAVERA_API_KEY. The Wistia token is an API access token generated under Account → Settings → API Access. It provides full read access to stats, media, and visitor data. Store both keys in your secrets manager. Wistia’s 600 req/min limit is generous — you’re unlikely to hit it unless you’re pulling stats for thousands of videos in a tight loop.

Prerequisites

1

Wistia account

You need a Wistia account with at least one project containing videos with viewer analytics enabled.
2

API token

Generate a token at Account → Settings → API Access. Select read-all permissions for stats and media access.
3

Mavera API key

Get your key from Mavera dashboard.
4

Environment variables


Jobs


Rate Limits & Production Notes

Wistia’s rate limit is 600 requests per minute — generous but not unlimited. The visitor stats endpoints can return large payloads (100 visitors per page with nested events). For accounts with 50,000+ visitors, full pagination takes 500+ requests. Add 100-200ms delays between calls and monitor your request count. Wistia returns 429 Too Many Requests when the limit is hit — retry after 1 second. Unlike YouTube, Wistia has no daily quota — only per-minute throttling.
Production checklist:

What’s Next

All Integrations

50+ API integrations with full code

Wistia Data API

Official Wistia API documentation

Focus Groups API

Full reference for POST /api/v1/focus-groups

Brand Voice API

Full reference for POST /api/v1/brand-voice

Generate API

Full reference for POST /api/v1/generate

Personas API

Full reference for POST /api/v1/personas