Skip to main content

Vidalytics API Overview

Public API + Advanced Stats API

Erika Lehmann avatar
Written by Erika Lehmann
Updated this week

Vidalytics offers a powerful API ecosystem designed for automation, analytics, integrations, and advanced data workflows.
There are two major API layers available:

  1. Public API – for video management, automation workflows, CRM integrations, and embed code generation.

  2. Advanced Stats API – for pulling detailed video analytics, timelines, segmented data, and near real-time viewer activity into your BI tools.

Both API layers help teams automate manual work, centralize insights, and build custom video-powered solutions.

1. Public API (App API)

The Public API allows you to integrate Vidalytics with your internal systems and third-party tools, automate workflows, and manage your video content programmatically.

🚫 Restrictions:

Available starting with our Premium Plan and up.

Access & Analyze Video Data

Retrieve general-level performance insights and essential video metadata to power your workflows or reporting.

Automate CRM Events

Sync viewer interactions (plays, completions, opt-ins, conversions) with:

  • CRMs

  • Email platforms

  • Automation tools

  • Custom back-end systems

Perfect for behavior-based automations.

Manage Video Content

Programmatically update or organize your video library:

  • Rename videos

  • Move them between folders

  • Update settings

  • Add tags or classifications

Generate & Customize Embed Codes

Dynamically fetch embed codes to automate publishing on:

  • Landing pages

  • CMS platforms

  • Headless websites

  • Multi-brand setups

And More

The Public API covers a wide set of endpoints designed to support operational and automation use cases.
​

For all endpoints, visit:
​Vidalytics API Docs → https://api-docs.vidalytics.com/

2. Advanced Stats API

The Advanced Stats API extends analytics access far beyond the Public API.
It lets Premium+ customers pull the same advanced metrics shown inside Vid Stats — including timeline, segmentation, and near real-time activity — directly into BI tools and data pipelines.

This is ideal for:

  • Enterprise reporting stacks

  • Automated dashboards

  • Cross-platform attribution analysis

  • A/B test infrastructure

  • Multi-brand analytics environments

🚫 Restrictions:

Available on Premium Plan, but advanced filters, segments, multi-video, and real-time endpoints require Enterprise Plan

New Advanced Stats API Features

Timeline Stats API (Premium & Enterprise)

Pull hourly or daily stats for any video:

  • Plays

  • Views

  • Conversions

  • Engagement data

  • Watch-time trends

Useful for trend lines, campaign comparisons, or time-of-day performance analysis.

Advanced Filters (Enterprise Only)

Filter analytics using the same filters as inside Vid Stats:

  • Geo

  • Device

  • Browser

  • URL parameters

  • Referrer data

  • Traffic breakdowns

Segmented Reporting (Enterprise Only)

Break down results by:

  • Country

  • Device type

  • Browser

  • OS

  • & more

Perfect for identifying high-performing and low-performing audiences.

Bulk Requests – Up to 50 Videos (Enterprise Only)

Query multiple videos in one call. Ideal for large libraries, variant testing, or multi-brand reporting.

Near Real-Time Metrics (Enterprise Only)

A dedicated endpoint shows how many viewers are watching right now, with ~1-minute delay.
Useful for:

  • Live dashboards

  • Traffic monitoring

  • Volume checks on high-performing campaigns

How to Use Vidalytics APIs

1. Generate Your API Token

  • Go to Account Settings → Global Settings

  • Create an API token

  • Store it securely

2. Read the Documentation

All endpoints, examples, and schemas are here:
​https://api-docs.vidalytics.com/

3. Start Integrating

Use standard tools:

  • Python

  • Node.js

  • PHP

  • Zapier / Make via webhooks

  • BI tools

  • Internal dashboards

4. Automate, Analyze, or Integrate

Use your API token to:

  • Pull stats

  • Filter data

  • Sync events

  • Manage videos

  • Generate embed codes

  • Build enterprise data flows

API Usage Limits

Monthly API Request Limits

Plan

Monthly Limit

Premium

3,000 requests

Enterprise

30,000 requests

Agency

3,000 requests

Throttling After Limit Is Reached

Plan

Throttled Rate

Premium

~1 request/hour

Enterprise

~10 requests/hour

Agency

~1 request/hour

Notes

  • Stats refresh every 2 hours (except near real-time endpoint).

  • Bulk stats endpoints allow up to 50 video IDs per request.

  • Session API returns up to 1,000 results per call.

  • Maximum date range is 1 month per request.


Benefits of Using Vidalytics APIs

For Automation

  • Sync video events to CRMs, email platforms, or automation systems.

  • Trigger internal workflows when key viewer actions occur.

For Analytics & BI

  • Integrate video stats into tools like:

    • Tableau

    • Looker

    • Power BI

    • Google Data Studio

    • Mode

  • Build automated dashboards and reports.

  • Slice video performance by geo, device, URL params, and more.

For Content Management

  • Manage videos, folders, metadata, and embed codes programmatically.

  • Build multi-brand or multi-client systems with dynamic video assignment.

For Enterprise Workflows

  • Run complex funnels, A/B tests, or segmentation analyses with large datasets.

  • Create real-time activity dashboards for campaign monitoring.

If you have questions or need support while building an integration, contact us our Customer Happiness Team at [email protected]
​

Did this answer your question?