Connect ViewStream to your site, apps and systems.

iframe

The simplest embed. Works in any CMS. Options: autoplay=1 (muted), start=<seconds>, lang=he|en|ru|ar, config=<name>.

<iframe src="https://player.viewstream.co.il/e/acme/live/main"
        allow="autoplay; fullscreen; picture-in-picture" allowfullscreen
        style="aspect-ratio:16/9;width:100%;border:0"></iframe>

<!-- a video or a clip -->
<iframe src="https://player.viewstream.co.il/e/acme/vod/<asset-id>" …></iframe>
<iframe src="https://player.viewstream.co.il/e/acme/clip/<clip-id>" …></iframe>

Player tag

The player inside your page, with access to its events. Several players on one page load the player code once.

<script async src="https://player.viewstream.co.il/embed.js"
        data-src="https://cdn.example.net/live/acme/main/master.m3u8"
        data-tenant="acme"
        data-config="news"
        data-lang="he"></script>

<script>
document.addEventListener('vs:ready', function (e) {
  var player = e.detail.player;   // a Video.js player
  player.on('play',  function () { /* … */ });
  player.on('ended', function () { /* … */ });
});
</script>

Catch-up: list and search

Scope channels:read. Play play_start–play_end: the programme's real start and end, found by AI, not the guide times.

# your channels and their ids
curl -s "$API/channels" "${H[@]}"

# programmes of one day
curl -s "$API/channels/<channel-id>/catchup?from=2026-10-05T00:00:00Z&to=2026-10-06T00:00:00Z" "${H[@]}"

# search titles, guide text and AI summaries
curl -s -G "$API/channels/<channel-id>/catchup/search" \
     --data-urlencode "q=ריבית" "${H[@]}"

AI summary and presenters

Scope assets:read. A Hebrew summary, verified presenters and topics for a programme.

curl -s "$API/programmes/<programme-id>/summary" "${H[@]}"

{
  "status": "ready",
  "summary": "…",
  "presenters": ["…"],
  "presenters_source": "series",
  "topics": ["…", "…"],
  "words": 104,
  "updated_at": "2026-10-06T18:12:40Z"
}

Subtitles

Scope assets:read. Every subtitle language of a programme, video or clip, each with a ready-to-use WebVTT file, or the timed cues as JSON.

# languages, status and the WebVTT URL of each track
curl -s "$API/subtitles/subjects/<programme-id>" "${H[@]}" \
  | jq '.languages[] | {lang, status, vtt: .track.vtt_url}'

# the cues of one track as JSON
curl -s "$API/subtitles/tracks/<track-id>/cues" "${H[@]}"

The same in JavaScript

From your server (Node 18 or later, no libraries).

const API = 'https://api.viewstream.co.il/v1';
const vs = (path) => fetch(API + path, {
  headers: { Authorization: `Bearer ${process.env.VS_KEY}` },
}).then((r) => r.ok ? r.json() : Promise.reject(r.status));

const { items } = await vs(`/channels/${channelId}/catchup`);
for (const p of items.filter((p) => p.status === 'recorded')) {
  const s = await vs(`/programmes/${p.id}/summary`);
  console.log(p.title, s.presenters.join(', '), s.summary);
}

A video page

The API key stays on the server. Pages are cached and refreshed by tag.

// app/v/[id]/page.tsx
import { createViewStream } from '@viewstream/next/server';
import { ViewStreamPlayer } from '@viewstream/next/client';

const vs = createViewStream(); // VIEWSTREAM_API_KEY, VIEWSTREAM_TENANT

export default async function Page({ params }) {
  const { id } = await params;
  const video = await vs.assets.get(id);
  return <ViewStreamPlayer tenant="acme" kind="vod" id={video.id} />;
}

Publish in Studio, the site updates

Point a webhook at this route with asset.published, clip.final and artifact.published. Signatures are checked, and the affected pages are revalidated at once.

// app/api/viewstream/webhook/route.ts
import { viewstreamWebhook } from '@viewstream/next/webhook';

export const POST = viewstreamWebhook({
  secret: process.env.VIEWSTREAM_WEBHOOK_SECRET,
});