Marketing
Wistia in your product and your AI agents, through one API
The Wistia toolkit covers media, folders and subfolders, plus account-level and per-video analytics: plays, play rate, engagement and a timeseries. Your product or AI agent calls them through Connect, which stores the customer's API key and logs every execution.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/wistia_create_folder/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}How it works
From a connected customer to the first Wistia call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Wistia account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Wistia.
Video analytics in your dashboard
A SaaS pulls plays, play_rate and engagement_rate for a date range and shows them next to its own metrics.
Content performance reports
An agency tool ranks the media or folders of an account by a metric and reads one video's timeseries by day, week or month.
Agent that organizes the library
An AI agent renames and tags media, creates folders and moves up to 100 media at once.
Tools
12 Wistia tools
- 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.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
Questions about the Wistia toolkit
Do I need to build against the Wistia API?
No. Connect ships 12 Wistia tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Wistia account?
With the mode the toolkit accepts: API key. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
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.
