Analytics
The Analytics API allows you to retrieve performance metrics and engagement data for your videos.
Video Analytics
GET/analytics/videos/{video_id}
Retrieves analytics data for a specific video.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| video_id | string | Required The ID of the video to retrieve analytics for |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| start_date | string | Optional Start date for the analytics period (YYYY-MM-DD) |
| end_date | string | Optional End date for the analytics period (YYYY-MM-DD) |
Response
{
"video_id": "vid_12345abcde",
"title": "Welcome Message for John",
"created_at": "2025-02-15T10:30:00Z",
"metrics": {
"views": 42,
"unique_viewers": 38,
"total_watch_time": 1845.3,
"average_watch_time": 43.9,
"completion_rate": 0.76,
"engagement_score": 8.2
},
"watch_time_distribution": [
{
"segment": "0-25%",
"viewers": 42
},
{
"segment": "25-50%",
"viewers": 38
},
{
"segment": "50-75%",
"viewers": 35
},
{
"segment": "75-100%",
"viewers": 32
}
],
"engagement": {
"clicks": 8,
"shares": 3,
"reactions": {
"like": 12,
"love": 5,
"curious": 2
}
},
"viewer_demographics": {
"devices": {
"mobile": 65,
"desktop": 30,
"tablet": 5
},
"browsers": {
"chrome": 55,
"safari": 30,
"firefox": 10,
"other": 5
},
"countries": {
"US": 45,
"UK": 15,
"CA": 10,
"DE": 8,
"other": 22
}
}
}
Account Analytics
GET/analytics/account
Retrieves aggregate analytics data for all videos in your account.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| start_date | string | Optional Start date for the analytics period (YYYY-MM-DD) |
| end_date | string | Optional End date for the analytics period (YYYY-MM-DD) |
| group_by | string | Optional Group results by time period (day, week, month) |
Response
{
"period": {
"start_date": "2025-02-01",
"end_date": "2025-02-28"
},
"summary": {
"total_videos": 28,
"total_views": 3845,
"unique_viewers": 1652,
"average_completion_rate": 0.72,
"average_engagement_score": 7.8,
"total_interactions": 476
},
"trends": [
{
"date": "2025-02-01",
"views": 120,
"completion_rate": 0.68,
"engagement_score": 7.2
},
{
"date": "2025-02-08",
"views": 205,
"completion_rate": 0.71,
"engagement_score": 7.5
},
{
"date": "2025-02-15",
"views": 310,
"completion_rate": 0.74,
"engagement_score": 8.1
},
{
"date": "2025-02-22",
"views": 286,
"completion_rate": 0.73,
"engagement_score": 7.9
}
],
"top_videos": [
{
"video_id": "vid_12345abcde",
"title": "Welcome Message for John",
"views": 245,
"engagement_score": 8.7
},
{
"video_id": "vid_67890fghij",
"title": "Product Demo for Enterprise",
"views": 186,
"engagement_score": 8.2
},
{
"video_id": "vid_abcdef12345",
"title": "Feature Announcement",
"views": 142,
"engagement_score": 7.9
}
]
}
Template Performance
GET/analytics/templates/{template_id}
Retrieves performance analytics for videos created from a specific template.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| template_id | string | Required The ID of the template to analyze |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| start_date | string | Optional Start date for the analytics period (YYYY-MM-DD) |
| end_date | string | Optional End date for the analytics period (YYYY-MM-DD) |
Response
{
"template_id": "tmpl_welcome_message",
"name": "Welcome Message",
"total_videos": 120,
"total_views": 3240,
"average_completion_rate": 0.81,
"average_engagement_score": 8.4,
"metrics_distribution": {
"completion_rate": {
"min": 0.62,
"max": 0.94,
"median": 0.82,
"quartiles": [0.75, 0.82, 0.88]
},
"engagement_score": {
"min": 6.5,
"max": 9.2,
"median": 8.5,
"quartiles": [7.8, 8.5, 8.9]
},
"watch_time": {
"min": 32.4,
"max": 58.2,
"median": 48.6,
"quartiles": [42.3, 48.6, 52.1]
}
},
"top_performing_videos": [
{
"video_id": "vid_12345abcde",
"title": "Welcome Message for John",
"views": 245,
"completion_rate": 0.92,
"engagement_score": 9.1
},
{
"video_id": "vid_67890fghij",
"title": "Welcome Message for Sarah",
"views": 186,
"completion_rate": 0.89,
"engagement_score": 8.8
}
]
}
Export Analytics
POST/analytics/export
Generates and exports analytics data in CSV or JSON format.
Request Body
| Parameter | Type | Description |
|---|---|---|
| type | string | Required Type of export (video, account, template) |
| id | string | Optional ID of the specific video or template (required if type is video or template) |
| start_date | string | Optional Start date for the analytics period (YYYY-MM-DD) |
| end_date | string | Optional End date for the analytics period (YYYY-MM-DD) |
| format | string | Optional Export format (csv, json) (default: csv) |
| metrics | array | Optional Specific metrics to include in the export (default: all) |
Example Request
{
"type": "account",
"start_date": "2025-01-01",
"end_date": "2025-02-28",
"format": "csv",
"metrics": ["views", "completion_rate", "engagement_score"]
}
Response
{
"export_id": "export_12345abcde",
"status": "processing",
"type": "account",
"format": "csv",
"estimated_completion": "2025-03-05T15:35:00Z"
}
Get Export Status
GET/analytics/export/{export_id}
Checks the status of an analytics export and provides the download link when complete.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| export_id | string | Required The ID of the export to check |
Response (Processing)
{
"export_id": "export_12345abcde",
"status": "processing",
"progress": 45,
"estimated_completion": "2025-03-05T15:35:00Z"
}
Response (Completed)
{
"export_id": "export_12345abcde",
"status": "completed",
"format": "csv",
"size": 245678,
"download_url": "https://cdn.sixtyseconds.video/exports/export_12345abcde.csv",
"expires_at": "2025-03-12T15:30:00Z"
}
Understanding Analytics Metrics
Key Metrics
| Metric | Description |
|---|---|
| Views | Total number of times a video has been viewed |
| Unique Viewers | Number of individual users who have viewed the video |
| Completion Rate | Percentage of viewers who watched the video to completion |
| Watch Time | Total time viewers spent watching the video |
| Average Watch Time | Average duration of video watched per view |
| Engagement Score | Composite score (1-10) based on watch time, interactions, and other factors |
Engagement Metrics
Engagement metrics track how viewers interact with your videos:
- Clicks: Number of times viewers clicked on elements within the video
- Shares: Number of times the video was shared
- Reactions: Emotional responses recorded from viewers (like, love, curious, etc.)
Viewer Demographics
Demographic data provides insights about your audience:
- Devices: Breakdown of viewing devices (mobile, desktop, tablet)
- Browsers: Web browsers used to view your videos
- Countries: Geographic distribution of your viewers
Best Practices
- Regular Monitoring: Check your video analytics weekly to identify trends and opportunities
- A/B Testing: Create variations of videos using different templates to compare performance
- Benchmark Comparison: Compare your video's metrics against account averages
- Completion Rate Focus: Optimize videos to improve completion rates, which strongly correlate with conversion
- Segment Analysis: Analyze performance across different customer segments to tailor your content