AtomicPlayerAtomicPlayer
atomicplayer.ai
  • English
  • Español
  • Português
AtomicPlayer
  • Sitio web
  • Panel
Documentación de la API
  • Introducción
  • Autenticación
  • Referencia de la API

© 2026 AtomicPlayer

Information
Videos
    Listar vídeosgetCrear un vídeopostObtener un vídeogetEliminar un vídeodeleteActualizar un vídeopatchCrear una URL de cargapostObtener el estado de la cargaget
Folders
    Listar carpetasgetCrear una carpetapost
Tags
    Listar etiquetasgetCrear una etiquetapostReemplazar etiquetas del vídeoput
Player
    Listar reproductoresgetObtener un reproductorgetCrear un reproductorpostActualizar el borradorpatchPublicar un reproductorpost
Analytics
    Resumen de analíticagetAnalítica de un vídeogetCurva de retencióngetEmbudo de reproduccióngetIngresosgetCohortesgetAudienciagetEspectadores en vivogetSesiones de repeticióngetResúmenes por vídeoget
Webhooks
    Listar eventos de webhookgetListar webhooksgetCrear un webhookpostObtener un webhookgetEliminar un webhookdeleteActualizar un webhookpatchListar entregasgetEnviar un evento de pruebapostRotar el secreto de firmapostEstadísticas de webhooksget
API keys
    Listar claves de APIgetCrear una clave de APIpostRevocar una clave de APIdeleteActualizar una clave de APIpatch
Schemas
AtomicPlayer API
AtomicPlayer API

Analytics

Download schema

Informes de reproducción, retención, audiencia e ingresos del espacio.


Resumen de analítica

GET
https://api.atomicplayer.ai
/v1/analytics/overview

Totales de vistas, reproducciones, retención, clics e ingresos. Alcance requerido: analytics.

Resumen de analítica › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

range
​string · enum

Ventana del informe. Usa 7d, 30d, 90d o today.

Enum values:
7d
30d
90d
today
Default: 30d

Resumen de analítica › Responses

Resumen de analítica

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/overview
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/overview?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "views": 8420, "plays": 5200, "playRate": 0.617, "conversions": 210, "revenue": 3150 }, "error": null }
json
application/json

Analítica de un vídeo

GET
https://api.atomicplayer.ai
/v1/analytics/video-detail

Los mismos totales para un vídeo. Alcance requerido: analytics.

Analítica de un vídeo › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

videoId
​string · uuid · required

Id del vídeo.

range
​string · enum

Ventana del informe. Usa 7d, 30d, 90d o today.

Enum values:
7d
30d
90d
today
Default: 30d

Analítica de un vídeo › Responses

Analítica de un vídeo

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/video-detail
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/video-detail?workspaceId=%3Cstring%3E&videoId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "videoId": "00000000-0000-4000-8000-000000000001", "views": 8420, "plays": 5200 }, "error": null }
json
application/json

Curva de retención

GET
https://api.atomicplayer.ai
/v1/analytics/retention

Porcentaje de espectadores que siguen viendo en cada punto del vídeo. Alcance requerido: analytics.

Curva de retención › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

videoId
​string · uuid · required

Id del vídeo.

range
​string · enum

Ventana del informe. Usa 7d, 30d, 90d o today.

Enum values:
7d
30d
90d
today
Default: 30d

Curva de retención › Responses

Curva de retención

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/retention
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/retention?workspaceId=%3Cstring%3E&videoId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "points": [ { "second": 0, "retention": 1 }, { "second": 30, "retention": 0.72 } ] }, "error": null }
json
application/json

Embudo de reproducción

GET
https://api.atomicplayer.ai
/v1/analytics/funnel

Impresiones, reproducciones, pitch y conversiones. Alcance requerido: analytics.

Embudo de reproducción › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

range
​string · enum

Ventana del informe. Usa 7d, 30d, 90d o today.

Enum values:
7d
30d
90d
today
Default: 30d

Embudo de reproducción › Responses

Embudo de reproducción

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/funnel
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/funnel?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "impressions": 9000, "plays": 5200, "conversions": 210 }, "error": null }
json
application/json

Ingresos

GET
https://api.atomicplayer.ai
/v1/analytics/revenue

Ingresos atribuidos a conversiones del reproductor en la ventana. Alcance requerido: analytics.

Ingresos › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

range
​string · enum

Ventana del informe. Usa 7d, 30d, 90d o today.

Enum values:
7d
30d
90d
today
Default: 30d

Ingresos › Responses

Ingresos

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/revenue
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/revenue?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "revenue": 3150, "conversions": 210 }, "error": null }
json
application/json

Cohortes

GET
https://api.atomicplayer.ai
/v1/analytics/cohorts

Espectadores que vuelven, agrupados por la semana de su primera vista. Alcance requerido: analytics.

Cohortes › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

range
​string · enum

Ventana del informe. Usa 7d, 30d, 90d o today.

Enum values:
7d
30d
90d
today
Default: 30d

Cohortes › Responses

Cohortes

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/cohorts
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/cohorts?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "cohorts": [ { "week": "2026-07-06", "viewers": 1200 } ] }, "error": null }
json
application/json

Audiencia

GET
https://api.atomicplayer.ai
/v1/analytics/audience

Vistas por dispositivo, país y referente. Alcance requerido: analytics.

Audiencia › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

range
​string · enum

Ventana del informe. Usa 7d, 30d, 90d o today.

Enum values:
7d
30d
90d
today
Default: 30d

Audiencia › Responses

Audiencia

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/audience
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/audience?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "devices": [ { "label": "mobile", "views": 5100 } ] }, "error": null }
json
application/json

Espectadores en vivo

GET
https://api.atomicplayer.ai
/v1/analytics/live

Espectadores que están viendo ahora. Alcance requerido: analytics.

Espectadores en vivo › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

Espectadores en vivo › Responses

Espectadores en vivo

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/live
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/live?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "viewers": 18 }, "error": null }
json
application/json

Sesiones de repetición

GET
https://api.atomicplayer.ai
/v1/analytics/replays

Sesiones de reproducción recientes que se pueden repetir. Alcance requerido: analytics.

Sesiones de repetición › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

range
​string · enum

Ventana del informe. Usa 7d, 30d, 90d o today.

Enum values:
7d
30d
90d
today
Default: 30d

Sesiones de repetición › Responses

Sesiones de repetición

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/replays
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/replays?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "sessions": [ { "id": "sess_123", "videoId": "00000000-0000-4000-8000-000000000001" } ] }, "error": null }
json
application/json

Resúmenes por vídeo

GET
https://api.atomicplayer.ai
/v1/analytics/video-summaries

Una fila de resumen por vídeo en la ventana. Alcance requerido: analytics.

Resúmenes por vídeo › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

range
​string · enum

Ventana del informe. Usa 7d, 30d, 90d o today.

Enum values:
7d
30d
90d
today
Default: 30d

Resúmenes por vídeo › Responses

Resúmenes por vídeo

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/analytics/video-summaries
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/analytics/video-summaries?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "videos": [ { "videoId": "00000000-0000-4000-8000-000000000001", "title": "Product launch VSL", "views": 8420, "plays": 5200 } ] }, "error": null }
json
application/json

PlayerWebhooks