API REST

Qué puedes hacer

• Subir vídeos directamente al almacenamiento, con subidas reanudables en partes de 16 MB para archivos grandes.
• Importar un vídeo a partir del enlace a un archivo.
• Consultar y gestionar tu biblioteca y tus webhooks desde tu propio código.
• Llevar tus analíticas a un panel, una hoja de cálculo o un almacén de datos (consulta Analíticas más abajo).
• Dar a cada clave solo el acceso que necesita: Read only, Read & write videos o Admin.

Analíticas

Cualquier clave, incluso las de tipo Read only, puede leer tus analíticas. Cada periodo se indica con days (los últimos N días, hoy incluido) o con las fechas from y to (AAAA-MM-DD, ambas incluidas).

• GET /v1/stats: totales, reproducciones por día, todos los vídeos, páginas principales y campañas UTM del espacio de trabajo, de una carpeta o de una etiqueta. Con ?format=csv lo obtienes en hoja de cálculo.
• GET /v1/videos/{id}/stats: un vídeo, con su retención de la audiencia, finalización, países y dispositivos.
• GET /v1/analytics/sessions: todas las visualizaciones, de la más antigua a la más reciente, hasta 1000 cada vez. Devuelve el valor de next como after para obtener la página siguiente. Cada visualización incluye el espectador (si se conoce), cuánto vio, si llegó al final, país, dispositivo, página, etiquetas UTM y en qué hizo clic o qué envió.
• GET /v1/analytics/viewer?email=…: todo lo que vio una persona, por vídeo, con todas sus sesiones combinadas.
• POST /v1/analytics/report: un informe personalizado (agrupación y métricas, como en Analytics → Reports), y GET /v1/analytics/reports/{id}/run ejecuta un informe que tu equipo haya guardado allí.
• GET /v1/analytics/compare?videos=… y GET /v1/analytics/live: compara vídeos y descubre quién está viendo ahora mismo.

Configúralo

1. En Pellio, ve a Settings → Developers. Tienes que ser propietario o administrador.
2. Crea una clave: ponle un nombre y elige su Access.
3. Copia la clave. Solo se muestra una vez, así que guárdala en un lugar seguro.
4. Envíala como bearer token: curl https://api.pellio.io/v1/videos -H "Authorization: Bearer pk_…"
5. Para subir un vídeo, llama a POST /v1/videos/uploads, envía el archivo con PUT a la URL que recibes y después llama a POST /v1/videos/{id}/complete. Un webhook video.ready te avisa cuando está procesado.

Conviene saber

• Todos los endpoints están en la referencia de la API, y el documento OpenAPI está en https://api.pellio.io/v1/openapi.json.
• Los archivos tienen que ser de vídeo o audio, de hasta 20 GB. Las URL de subida son válidas durante 6 horas.
• Cada clave puede hacer 600 peticiones por minuto y 30 importaciones por minuto. Una respuesta 429 significa que debes ir más despacio y volver a intentarlo.
• La lista de claves muestra cuándo se usó cada una por última vez. Revoke desactiva una clave al instante.
• Requiere el plan Standard o superior.

Guía completa: Claves de API.