Player API
Build on top of the player. Fully.
Whether you're a developer building a custom video product or a media team wiring up analytics, the VideoNest Player API puts complete control in your code: playback commands, event callbacks, state queries, and cross-frame messaging. No limits on what you can build.
const player = VideoNest.player('video-123'); // Subscribe to events player.on('play', () => { analytics.track('video_play'); }); player.on('ended', () => showNextVideo()); // Control playback player.seek(30); player.setVolume(0.5); // Read state const t = player.currentTime;
Capabilities
The full API surface, no access restrictions
Complete playback control
play(), pause(), seek(t), setVolume(v), setMuted(bool), requestFullscreen(). The full control set, callable from your JavaScript at any time.
Event callbacks
Subscribe to play, pause, ended, progress, timeupdate, error, and ad_start / ad_end. Fire analytics, trigger UI, or load the next video.
State queries
Read currentTime, duration, buffered, muted, volume, and paused at any point. Build custom progress bars, overlays, or chapter navigation on top of the player.
postMessage API
For iframe embeds, VideoNest supports postMessage control: send commands and receive events across frame boundaries. Works in page builders and sandboxed environments.
More player features
More to build with in the VideoNest player
Autoplay & Sound
Set when and how video plays: muted defaults, browser-compliant autoplay, and sound-on for approved CTV placements.
Learn more →
Branding Controls
Add your logo, set player colors, and remove platform watermarks. Fully white-labeled on Business plans.
Learn more →
Captions & Transcripts
VideoNest Audio auto-generates WebVTT captions and word-level JSON transcripts from every uploaded video.
Learn more →
Embed Options
One snippet for any CMS: WordPress, Webflow, Squarespace, or custom HTML. Fully responsive with per-placement overrides.
Learn more →
Player Customization
Control colors, control bar layout, and playback behavior to match your brand at every placement.
Learn more →
Vertical Video Player
Native 9:16 player format for mobile-first content, social embeds, and short-form video placements.
Learn more →FAQ
Video Player API: common questions
What can I do with the VideoNest Player API?+
The Player API exposes complete playback control (play, pause, seek, setVolume), event callbacks (play, ended, timeupdate, ad_start/ad_end), state queries, and a postMessage API for cross-frame control. Use it to build custom progress bars, chapter navigation, analytics integrations, and full custom video experiences.
Does the VideoNest Player API work with React or Vue?+
Yes. The Player API is framework-agnostic JavaScript. Use it directly or wrap it in a React hook or Vue composable. VideoNest also provides a React integration. See the React integration page for details.
Can I control the VideoNest player inside an iframe?+
Yes. VideoNest supports postMessage control for iframe embeds: send commands and receive events across frame boundaries. This works in sandboxed environments, page builders like Webflow and Squarespace, and any setup where the player loads in a separate frame.
Is the Player API available on all VideoNest plans?+
Player API access is included on Creator plans and above. See the VideoNest pricing page for a full comparison of plan features.
Where can I find the full Player API documentation?+
Full Player API documentation is available at docs.videonest.co, including method references, event listings, postMessage protocol details, and integration examples.