Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

Vidalytics API Overview 

Public API + Advanced Stats API

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

  • Premium: 3,000 requests

  • Enterprise: 30,000 requests

  • Agency: 3,000 requests

Throttling After Limit Is Reached

  • 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 hi@vidalytics.com
​