Wistia tools
The 12 Wistia operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- List mediasGETLists the media of the account (videos, audio, images and documents) with hashed_id, name, type, status, duration in seconds, folder, subfolder, thumbnail and dates. The hashed_id is the id the other tools ask for. Pagination by page: the list ends when a page brings fewer items than per_page.
- Get mediaGETReturns one media: name, type, status, duration in seconds, description, folder, subfolder, tags, thumbnail, the files in assets and dates.
- Update mediaPUTUpdates the name, description or tags of a media and returns it. Fields left out keep their value, but tags replaces the whole list of tags of the media.
- Move mediasPUTMoves up to 100 media to a folder, or to a subfolder of that folder. Wistia runs the move in the background and answers with a background job status. This call is limited to 10 per 5 minutes, apart from the general limit.
- List foldersGETLists the shared folders of the account with hashed_id, name, description, media_count, public flag and dates. The My Library folders of each user are not included. Pagination by page: the list ends when a page brings fewer items than per_page.
- Create folderPOSTCreates a shared folder in the account, owned by the Account Owner, and returns it with its hashed_id.
- Update folderPUTUpdates the name, description or access of a folder and returns it. Fields left out keep their value.
- List subfoldersGETLists the subfolders of a folder with hashed_id, name, description, position and dates. Pagination by page: the list ends when a page brings fewer items than per_page.
- Get account analyticsGETReturns the totals of the whole account in a date range: plays, unique plays, unique loads, play_rate and engagement_rate (from 0 to 1), played_time in seconds, unique visitors and form conversions. The range goes up to 2 years.
- List top contentGETRanks the media, channels or folders of the account by a metric in a date range, with plays, play_rate, engagement_rate, played_time in seconds and unique visitors of each one, like the most played videos of last month. The range goes up to 2 years.
- Get media analyticsGETReturns the totals of one video in a date range: plays, unique plays, unique loads, play_rate and engagement_rate (from 0 to 1), played_time in seconds, unique visitors, call to action impressions and conversions, and form conversions. The range goes up to 2 years.
- Get media analytics timeseriesGETReturns the metrics of one video bucket by bucket in a date range, by day, week or month: a list with timestamp, plays, unique plays and loads, play_rate, engagement_rate, played_time in seconds, unique visitors and conversions. The range goes up to 2 years.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
