Vidalytics API Overview
A guide to the Public API and Advanced Stats API — what they do, who they are for, and how to get started.
Vidalytics offers a powerful API ecosystem designed for automation, analytics, integrations, and advanced data workflows. There are two API layers available, each built for a different level of use.
Availability & Restrictions
- Public API — available on Premium plans and above
- Advanced Stats API — available on Premium plans and above, with advanced filters, segmentation, bulk requests, and near real-time endpoints requiring an Enterprise plan
- Monthly request limits apply (see usage limits below)
The Two API Layers
Public API For video management, workflow automation, CRM integrations, and embed code generation. If you want to manage your video library programmatically, sync viewer interactions with your marketing stack, or automate publishing, this is your starting point.
Advanced Stats API For pulling detailed video analytics — including timelines, segmented data, and near real-time viewer activity — directly into your BI tools and data pipelines. Built for enterprise reporting stacks, automated dashboards, and cross-platform attribution analysis.
What the Public API Enables
Access and Analyze Video Data Retrieve performance insights and video metadata to power your reporting workflows or custom dashboards.
Automate CRM Events Sync viewer interactions — plays, completions, opt-ins, and conversions — with your CRM, email platform, automation tool, or custom back-end system. Perfect for behavior-based marketing automations.
Manage Your Video Library Programmatically rename videos, move them between folders, update settings, and add tags or classifications at scale.
Generate and Customize Embed Codes Dynamically fetch embed codes to automate video publishing across landing pages, CMS platforms, headless websites, and multi-brand setups.
For all available endpoints visit the Vidalytics API Docs.
What the Advanced Stats API Enables
Timeline Stats (Premium and Enterprise) Pull hourly or daily stats for any video — plays, views, conversions, engagement data, and watch-time trends. Useful for trend lines, campaign comparisons, and time-of-day performance analysis.
Advanced Filters (Enterprise only) Filter analytics using the same filters available inside Vid Stats — geo, device, browser, URL parameters, referrer data, and traffic breakdowns.
Segmented Reporting (Enterprise only) Break down results by country, device type, browser, OS, and more. Ideal for identifying your highest and lowest performing audience segments.
Bulk Requests — Up to 50 Videos (Enterprise only) Query multiple videos in a single API call. Built for large libraries, variant testing, and multi-brand reporting environments.
Near Real-Time Metrics (Enterprise only) A dedicated endpoint showing how many viewers are watching right now, with approximately a one-minute delay. Useful for live dashboards, traffic monitoring, and volume checks on high-performing campaigns.
How to Get Started
Generate your API token — go to Account Settings → Global Settings, create an API token, and store it securely.
Read the documentation — all endpoints, examples, and schemas are available at api-docs.vidalytics.com.
Start integrating — use your preferred tools: Python, Node.js, PHP, Zapier, Make, BI tools, or internal dashboards. Use your API token to pull stats, filter data, sync events, manage videos, generate embed codes, and build enterprise data flows.
API Usage Limits
| Plan | Monthly Requests | Throttling After Limit |
|---|---|---|
| Premium | 3,000 | ~1 request/hour |
| Enterprise | 30,000 | ~10 requests/hour |
| Agency | 3,000 | ~1 request/hour |
A Few Things to Keep in Mind
- Stats refresh every 2 hours (except the near real-time endpoint)
- Bulk stats endpoints allow up to 50 video IDs per request
- The Session API returns up to 1,000 results per call
- Maximum date range is 1 month per request
Benefits by Use Case
Automation — sync video events to CRMs and email platforms, trigger internal workflows when key viewer actions occur, and eliminate manual data entry entirely.
Analytics and BI — integrate video stats directly into Tableau, Looker, Power BI, Google Data Studio, or any other BI tool. Build automated dashboards and slice performance by geo, device, URL parameters, and more.
Content Management — manage videos, folders, metadata, and embed codes programmatically. Build multi-brand or multi-client systems with dynamic video assignment at scale.
Enterprise Workflows — run complex funnels, A/B test analyses, and segmentation studies with large datasets. Create real-time activity dashboards for campaign monitoring across your entire video library.
If you have any questions or need support while building an integration, feel free to reach out to our Customer Happiness Team at hi@vidalytics.com.