Wistia
Wistia media, folders, subfolders, captions, tags and stats (account, folder, media, daily and engagement), plus media metadata updates and URL imports.
Sync a video marketing library with CMS and campaign tools, report on plays and engagement, reuse captions as transcripts and bring new videos in from storage.
Source actions
17
Destination actions
2
Data types
15
Validation status
Implemented · fixture tested.
Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.
What you can map
account daily stats
- List account stats by daySourceIncremental
Account-wide loads, plays and hours watched per day between two dates (inclusive).
account_daily_stats.list
account stats
- Get account statsSource
Account-wide loads, plays and hours watched.
account_stats.get
background jobs
- Get background job statusSource
Status of an asynchronous Wistia job, such as a URL import.
background_jobs.get
captions
- Get captions in a languageSource
A media's captions in one language (JSON with SRT text).
captions.get - List captionsSource
Caption tracks across the account (or for one media), with SRT text unless only metadata is requested.
captions.list
events
- List viewing eventsSourceIncremental
Viewing sessions (events) for the account or one media, with percent viewed and country. Viewer personal data is not mapped.
events.list
folder stats
- Get folder statsSource
Loads, plays and hours watched for the media in one folder (project).
folder_stats.get
folders
- Get folderSource
One folder (previously project).
folders.get - List foldersSource
Folders (previously projects) in the account. My Library folders are not included.
folders.list
media daily stats
- List media stats by daySourceIncremental
Loads, plays and hours watched per day for one media between two dates (inclusive).
media_daily_stats.list
media detailed stats
- Get media statsSource
Loads, plays, play rate, hours watched, engagement, visitors and actions for one media.
media_detailed_stats.get
media engagement
- Get media engagement graphSource
Engagement and rewatch data for one video, as used by Wistia's engagement graph.
media_engagement.get
media imports
- Import media from URLDestinationNot retried automaticallyApproval before production
Queues Wistia to download a media file from a public URL into a folder. Returns a background job to poll.
media_imports.create
media stats
- Get media embed statsSource
Aggregated embed statistics for one video: page loads, visitors, plays and play rate.
media_stats.get
medias
- Get mediaSource
One media with status, folder, tags and thumbnail.
medias.get - List mediaSource
Media in the account or one folder, filterable by type, tags, name and archive status.
medias.list - Update media detailsDestinationProvider duplicate protectionApproval before production
Updates a media's name, description and (replacing) tags.
medias.update
subfolders
- List subfoldersSource
Subfolders (previously media groups) inside a folder.
subfolders.list
tags
- List tagsSource
Tags in the account with how many media use each.
tags.list
Authentication
Wistia API token
Plans and access
Any Wistia account. Only the Account Owner can create API tokens. Each token has its own permissions: reads need Read all folder and media data (and Read detailed stats for stats); updates and imports need Read, update & delete anything.
Test environment
Wistia has no sandbox. Use a test folder; imported media count toward the account's media limits.
Rate limits
600 requests per minute per account across api.wistia.com and upload.wistia.com. Over the limit Wistia returns HTTP 429 with Retry-After, which Nexra honours. Move Media allows 10 requests per 5 minutes (not offered).
Pagination
page and per_page (default and maximum 100). Wistia returns plain arrays, so a page shorter than per_page ends the list.
Provider events
Wistia sends account webhooks for media and upload events. Nexra event triggers are not yet available; flows run on demand or on a schedule.
Before you build a flow
- Never deletes, archives, moves, copies, swaps, trims, translates or restores media, and never deletes folders, subfolders, captions, localizations or tags.
- Caption purchases, localizations and extended audio descriptions charge the account and are not offered. Captions are read only.
- Folder, subfolder, sharing, customization, channel and brand writes are not offered, so Nexra never makes a folder public or changes who can see media.
- Binary uploads (upload.wistia.com) are not offered. Import media from a public URL instead; poll background_jobs.get for the result. Imports from vimeo.com and wistia.com are refused by Wistia.
- There is no updatedSince filter. Sort media and folders by updated (descending) and stop at records already seen.
- Stats events drop viewer personal data: IP address, organisation, city, region, coordinates, e-mail, first and last name and user-agent details are never mapped. Visitor keys are pseudonymous Wistia IDs.
- Events are kept for 2 years. Daily stats default to yesterday and today when no dates are given.
Developer reference
- Create the Wistia credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Wistia, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/wistia and the Connections API.