AtomicPlayerAtomicPlayer
atomicplayer.ai
  • English
  • Español
  • Português
AtomicPlayer
  • Website
  • Dashboard
API docs
  • Introduction
  • Authentication
  • API reference

© 2026 AtomicPlayer

Information
Videos
    List videosgetCreate a videopostGet a videogetDelete a videodeleteUpdate a videopatchCreate an upload URLpostGet upload statusget
Folders
    List foldersgetCreate a folderpost
Tags
    List tagsgetCreate a tagpostReplace video tagsput
Player
    List playersgetGet a playergetCreate a playerpostUpdate a player draftpatchPublish a playerpost
Analytics
    Analytics overviewgetVideo analyticsgetRetention curvegetPlayback funnelgetRevenuegetCohortsgetAudiencegetLive viewersgetReplay sessionsgetVideo summariesget
Webhooks
    List webhook eventsgetList webhooksgetCreate a webhookpostGet a webhookgetDelete a webhookdeleteUpdate a webhookpatchList deliveriesgetSend a test eventpostRotate the signing secretpostWebhook statsget
API keys
    List API keysgetCreate an API keypostRevoke an API keydeleteUpdate an API keypatch
Schemas
AtomicPlayer API
AtomicPlayer API

Analytics

Download schema

Workspace playback, retention, audience, and revenue reports.


Analytics overview

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

Totals for views, plays, retention, clicks, and revenue. Required scope: analytics.

Analytics overview › query Parameters

workspaceId
​string · uuid · required

Workspace id.

range
​string · enum

Reporting window. Use 7d, 30d, 90d, or today.

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

Analytics overview › Responses

Analytics overview

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

Video analytics

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

The same totals for one video. Required scope: analytics.

Video analytics › query Parameters

workspaceId
​string · uuid · required

Workspace id.

videoId
​string · uuid · required

Video id.

range
​string · enum

Reporting window. Use 7d, 30d, 90d, or today.

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

Video analytics › Responses

Video analytics

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

Retention curve

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

Share of viewers still watching at each point in the video. Required scope: analytics.

Retention curve › query Parameters

workspaceId
​string · uuid · required

Workspace id.

videoId
​string · uuid · required

Video id.

range
​string · enum

Reporting window. Use 7d, 30d, 90d, or today.

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

Retention curve › Responses

Retention curve

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

Playback funnel

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

Impressions, plays, pitch, and conversions. Required scope: analytics.

Playback funnel › query Parameters

workspaceId
​string · uuid · required

Workspace id.

range
​string · enum

Reporting window. Use 7d, 30d, 90d, or today.

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

Playback funnel › Responses

Playback funnel

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

Revenue

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

Revenue attributed to player conversions in the window. Required scope: analytics.

Revenue › query Parameters

workspaceId
​string · uuid · required

Workspace id.

range
​string · enum

Reporting window. Use 7d, 30d, 90d, or today.

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

Revenue › Responses

Revenue

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

Cohorts

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

Returning viewers grouped by the week of their first view. Required scope: analytics.

Cohorts › query Parameters

workspaceId
​string · uuid · required

Workspace id.

range
​string · enum

Reporting window. Use 7d, 30d, 90d, or today.

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

Cohorts › Responses

Cohorts

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

Audience

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

Views broken down by device, country, and referrer. Required scope: analytics.

Audience › query Parameters

workspaceId
​string · uuid · required

Workspace id.

range
​string · enum

Reporting window. Use 7d, 30d, 90d, or today.

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

Audience › Responses

Audience

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

Live viewers

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

Viewers watching right now. Required scope: analytics.

Live viewers › query Parameters

workspaceId
​string · uuid · required

Workspace id.

Live viewers › Responses

Live viewers

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

Replay sessions

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

Recent playback sessions that can be replayed. Required scope: analytics.

Replay sessions › query Parameters

workspaceId
​string · uuid · required

Workspace id.

range
​string · enum

Reporting window. Use 7d, 30d, 90d, or today.

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

Replay sessions › Responses

Replay sessions

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

Video summaries

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

One summary row per video in the window. Required scope: analytics.

Video summaries › query Parameters

workspaceId
​string · uuid · required

Workspace id.

range
​string · enum

Reporting window. Use 7d, 30d, 90d, or today.

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

Video summaries › Responses

Video summaries

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