Obtener analíticas del medio en Wistia, con una API
Devuelve los totales de un video en un rango de fechas: plays, unique plays, unique loads, play_rate y engagement_rate (de 0 a 1), played_time en segundos y más.
- Identificador
- wistia_get_media_analytics
La llamada
POST https://connect.reportei.com/api/tools/wistia_get_media_analytics/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"media_hashed_id": "<media_hashed_id>",
"start_date": "<start_date>",
"end_date": "<end_date>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| media_hashed_id | string | Sí | The hashed_id of the video, from List medias, like 4d23503f70. |
| start_date | string | Sí | First day of the range, YYYY-MM-DD, included. |
| end_date | string | Sí | Day after the last day of the range, YYYY-MM-DD: it is excluded, so October is 2026-10-01 to 2026-11-01. |
Conexiones posibles
Tu cliente conecta su cuenta de Wistia una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/wistia_get_media_analytics. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Wistia
- Listar mediosGETLista los medios de la cuenta (videos, audios, imágenes y documentos) con hashed_id, name, type, status, duración en segundos, carpeta, subcarpeta, miniatura y fechas.
- Obtener medioGETDevuelve un medio: name, type, status, duración en segundos, description, carpeta, subcarpeta, tags, miniatura, los archivos en assets y fechas.
- Actualizar medioPUTActualiza el nombre, la descripción o las tags de un medio y lo devuelve. Los campos omitidos conservan su valor, pero tags reemplaza toda la lista de tags del medio.
- Mover mediosPUTMueve hasta 100 medios a una carpeta, o a una subcarpeta de esa carpeta. Wistia ejecuta el movimiento en segundo plano y responde con el estado de un background job.
- Listar carpetasGETLista las carpetas compartidas de la cuenta con hashed_id, name, description, media_count, indicador de público y fechas. Las carpetas My Library de cada usuario no están incluidas.
- Crear carpetaPOSTCrea una carpeta compartida en la cuenta, propiedad del Account Owner, y la devuelve con su hashed_id.
- Actualizar carpetaPUTActualiza el nombre, la descripción o el acceso de una carpeta y la devuelve. Los campos omitidos conservan su valor.
- Listar subcarpetasGETLista las subcarpetas de una carpeta con hashed_id, name, description, position y fechas. Paginación por página: la lista termina cuando una página trae menos elementos que per_page.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
