SingleEmbed

SingleEmbed displays one video. It accepts either an API-driven apiKey + videoId pair, or a pre-fetched video object — not both.

API-driven

The embed fetches the video from the SEEEN API using your credentials.

import { SingleEmbed } from "@seeen/embed/single";

<SingleEmbed apiKey="YOUR_KEY" videoId="1234" />

Pre-fetched

Supply a VideoItem directly when you already have the data.

<SingleEmbed
  video={{
    id: "1",
    title: "My Video",
    src: "https://example.com/video.m3u8",
    poster: "https://example.com/thumb.jpg",
  }}
/>

Start at a specific time

Pass startTime in seconds, or add ?t=30 to the page URL (same as YouTube).

<SingleEmbed apiKey="YOUR_KEY" videoId="1234" startTime={42} />

Props

Prop	Type	Required	Description
apiKey	string	optional	Your SEEEN API key. Required in API-driven mode.
videoId	string	optional	The video ID to fetch. Required in API-driven mode.
video	VideoItem	optional	Pre-fetched video data. Required in pre-fetched mode.
activeMoment	Moment	optional	Pre-selects a moment (chapter), seeking to it on first play.
activeMomentId	string	optional	Pre-selects a moment by ID, resolved against the video's moments. Falls back to the `_seeen_moment` URL parameter. Ignored when `activeMoment` is set.
autoplay	boolean	optional	Start playing automatically on load. Most browsers require `muted`.
gaMeasurementId	string	optional	Google Analytics 4 measurement ID (e.g. `"G-XXXXXXXXXX"`).
momentEndSplash	boolean	optional	Show a "Watch Again / Resume Video" splash when the active moment ends.
momentNavBehavior	"seek" | "moment"	optional	What clicking a moment in the moments nav does. `"moment"` (default) treats it like `activeMomentId`, stopping at the moment's end and showing the end splash; `"seek"` only jumps to it.
momentsNavPosition	"above" | "below" | "none"	optional	Position of the moments navigation bar. Defaults to `"above"`. Set to `"none"` to hide it.
muted	boolean	optional	Mute the video on load. Required for autoplay in most browsers.
overlays	CtaOverlay[]	optional	CTA image overlays displayed at fixed positions over the video.
share	boolean	optional	Show the social share popover. Defaults to `undefined` (show if the API returns icons). Set to `false` to force-hide.
startTime	number	optional	Start playback at this position in seconds. Falls back to the `?t=` query parameter.