# Show the videos in your app

> Put your approved Ondaclip videos in your own app: a delivery key on your server, a private list of videos, and a player per step.

Once your clips are approved and published, your app can show them. Your videos stay private. Your server fetches the list of published videos from Ondaclip, and every video address in that list is signed and works for a few hours only.

This page covers products in **Ondaclip Cloud**. If your product runs on your own infrastructure, your videos are published to your own storage: the **Integrate** page in the studio gives you the code for that setup.

## 1. Create a delivery key

In the studio, open your product, then **Integrate**. Under **Delivery keys**, name the key after the environment that will use it (`production`, `staging`) and select **Create key**.

Copy the key right away: you won't see it again. Save it on your server as an environment variable:

```bash
ONDACLIP_DELIVERY_KEY=ondk_...
```

Keep the key on the server. Never put it in a page, a mobile app or your repository. If a key leaks, revoke it in the same place: apps using it stop getting your videos right away.

Only workspace admins can create and revoke keys.

## 2. Fetch the list from your server

Your server sends the key to the address shown on the **Integrate** page:

```http
GET https://studio.ondaclip.com/api/delivery/<product>/manifest
Authorization: Bearer <your delivery key>
```

You get the published list: chapters, tutorials and their steps, in every language. Each video, poster and image is a full address that plays for 6 hours. Cache the list on your server for up to an hour, then fetch it again.

In Node:

```js
const KEY = process.env.ONDACLIP_DELIVERY_KEY

export async function tutorials(locale = "en-US") {
  const r = await fetch("https://studio.ondaclip.com/api/delivery/<product>/manifest", {
    headers: { Authorization: `Bearer ${KEY}` },
  })
  if (!r.ok) throw new Error(`Ondaclip: ${r.status}`)
  const manifest = await r.json()
  return manifest.chapters.map((chapter) => ({
    title: chapter.title[locale],
    tutorials: chapter.tutorials.map((t) => ({
      id: t.id,
      title: t.title[locale],
      thumbnail: t.thumbnail[locale],
      steps: t.steps.map((s) => ({
        title: s.title[locale],
        video: s.video[locale],
        poster: s.image[locale],
        transcript: s.transcript[locale],
      })),
    })),
  }))
}
```

In Python:

```python

KEY = os.environ["ONDACLIP_DELIVERY_KEY"]

def tutorials(locale="en-US"):
    url = "https://studio.ondaclip.com/api/delivery/<product>/manifest"
    manifest = requests.get(url, headers={"Authorization": f"Bearer {KEY}"}, timeout=10).json()
    return [{
        "title": chapter["title"][locale],
        "tutorials": [{
            "id": t["id"],
            "title": t["title"][locale],
            "steps": [{"title": s["title"][locale], "video": s["video"][locale], "poster": s["image"][locale]} for s in t["steps"]],
        } for t in chapter["tutorials"]],
    } for chapter in manifest["chapters"]]
```

The **Integrate** page gives you the same code with your product's address already filled in.

## 3. Play each step in a page

Your server passes the list to the page. One player per step is all you need:

```jsx
export function Tutorials({ chapters }) {
  return chapters.map((chapter) => (
    <section key={chapter.title}>
      <h2>{chapter.title}</h2>
      {chapter.tutorials.map((t) => (
        <article key={t.id}>
          <h3>{t.title}</h3>
          {t.steps.map((step) => (
            <figure key={step.video}>
              <video src={step.video} poster={step.poster} controls preload="none" />
              <figcaption>{step.title}</figcaption>
            </figure>
          ))}
        </article>
      ))}
    </section>
  ))
}
```

## Let your AI agent do it

Your AI agent can wire all of this for you. Ask it to "show our Ondaclip videos in the app": the `integration` tool of the [Ondaclip MCP server](/docs/for-ai-agents/) gives it the address and the code. It will ask you for the delivery key, since only a person can create one in the studio.

## When you publish again

Your app picks up new videos the next time your server fetches the list. Nothing to change in your code.

Source: https://ondaclip.com/docs/show-videos/
