> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Livestreams API

> Een Livestream vertegenwoordigt een live video-uitzending in een experience.

Nadat een opgenomen livestream is afgelopen, kunnen leden de herhaling bekijken en kunnen moderators de beste opnames vastpinnen om ze uit te lichten.

Gebruik de Livestreams API om [de livestreams van een experience weer te geven](https://docs.whop.com/nl/api-reference/livestreams/list-livestreams.md), [er een op te halen](https://docs.whop.com/nl/api-reference/livestreams/retrieve-livestream.md) met de bijbehorende opname, en opnames [vast te pinnen](https://docs.whop.com/nl/api-reference/livestreams/pin-livestream.md) of [los te maken](https://docs.whop.com/nl/api-reference/livestreams/unpin-livestream.md).

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Livestreams weergeven](https://docs.whop.com/nl/api-reference/livestreams/list-livestreams.md) | GET `/livestreams` |
| [Livestream ophalen](https://docs.whop.com/nl/api-reference/livestreams/retrieve-livestream.md) | GET `/livestreams/{id}` |
| [Kijkcijfers van livestream ophalen](https://docs.whop.com/nl/api-reference/livestreams/retrieve-livestream-viewership.md) | GET `/livestreams/{id}/viewership` |
| [Co-host aan livestream toevoegen](https://docs.whop.com/nl/api-reference/livestreams/add-livestream-co-host.md) | POST `/livestreams/{id}/add_co_host` |
| [Livestream vastpinnen](https://docs.whop.com/nl/api-reference/livestreams/pin-livestream.md) | POST `/livestreams/{id}/pin` |
| [Co-host van livestream verwijderen](https://docs.whop.com/nl/api-reference/livestreams/remove-livestream-co-host.md) | POST `/livestreams/{id}/remove_co_host` |
| [Livestream losmaken](https://docs.whop.com/nl/api-reference/livestreams/unpin-livestream.md) | POST `/livestreams/{id}/unpin` |

## Attributen

**id** `string` *required*

Livestream-ID, met prefix `lfeed_`.

**created\_at** `string` *required*

Wanneer de livestream is aangemaakt, als ISO 8601-tijdstempel.

**ended\_at** `string | null` *required*

Wanneer de livestream is geëindigd, als ISO 8601-tijdstempel. `null` zolang deze live is of voordat deze begint.

**pinned\_at** `string | null` *required*

Wanneer de opname is vastgepind of voor het laatst is verplaatst, als ISO 8601-tijdstempel. Vastgepinde livestreams worden hierop gesorteerd, nieuwste eerst. `null` wanneer niet vastgepind.

**recap** `object`

Topmomenten die AI uit de chat heeft gekozen, en chatactiviteit. Alleen `retrieve` retourneert dit, en alleen aan aanroepers met de machtiging `livestream:moderate`.

> [accordion] Eigenschappen
>
> **chat** `object | null` *required*
>
> Chatactiviteit tijdens de livestream. `null` zolang `status` `pending` is, voordat de livestream eindigt, of wanneer de samenvatting niet kon worden gestart.
>
> > [accordion] Eigenschappen
> >
> > **chatter\_count** `integer` *required*
> >
> > Hoeveel verschillende mensen die berichten hebben verzonden.
> >
> > **message\_count** `integer` *required*
> >
> > Chatberichten verzonden vanaf een minuut vóór `recording_started_at`, of `started_at` wanneer de livestream niet is opgenomen, tot een minuut na `ended_at`.
> >
> > **per\_minute** `integer[]` *required*
> >
> > Chatberichten die in elke minuut zijn verzonden vanaf `recording_started_at`, of `started_at` wanneer de livestream niet is opgenomen, tot `ended_at`. Berichten die buiten die periode zijn verzonden, worden weggelaten.
>
> **moments** `object[]` *required*
>
> Maximaal 5 topmomenten die AI heeft gekozen op basis van waarop de chat reageerde, vroegste eerst. Leeg zolang `status` niet `ready` is, wanneer er niets opviel, of wanneer ze niet konden worden gekozen. Een moment wordt weggelaten zodra het bijbehorende `message` uit de chat is verwijderd.
>
> > [accordion] Eigenschappen
> >
> > **description** `string` *required*
> >
> > Eén zin over wat er gebeurde en hoe de chat reageerde, in maximaal 140 tekens.
> >
> > **end\_offset\_seconds** `integer` *required*
> >
> > Waar de reactie van de chat op het moment eindigt, in seconden vanaf hetzelfde punt als `offset_seconds`. Nooit vóór `offset_seconds`, en nooit na de `offset_seconds` van het volgende moment.
> >
> > **message** `object` *required*
> >
> > Chatbericht dat het moment het best samenvat.
> >
> > > [accordion] Eigenschappen
> > >
> > > **id** `string` *required*
> > >
> > > ID van het chatbericht.
> > >
> > > **content** `string` *required*
> > >
> > > Berichttekst, met samengevoegde witruimte en ingekort tot maximaal 280 tekens.
> > >
> > > **user\_name** `string | null` *required*
> > >
> > > Weergavenaam van de persoon die het bericht heeft verzonden. `null` wanneer diens account niet meer bestaat.
> >
> > **offset\_seconds** `integer` *required*
> >
> > Waar het moment begint, kort voordat de chat reageerde, in seconden vanaf `recording_started_at`, of vanaf `started_at` wanneer de livestream niet is opgenomen.
> >
> > **title** `string` *required*
> >
> > Wat er in de stream gebeurde, in maximaal 60 tekens.
>
> **status** `string` *required*
>
> `pending` terwijl de samenvatting wordt gegenereerd en `ready` zodra deze klaar is. `unavailable` wanneer de livestream niet is geëindigd, geen chat had, of de samenvatting niet kon worden gestart. Haal de livestream later opnieuw op zolang deze `pending` is, of om een samenvatting die niet kon worden gestart opnieuw te proberen.
>
> Beschikbare opties: `pending`, `ready`, `unavailable`

**recording\_started\_at** `string | null` *required*

Wanneer het eerste frame van de opname is vastgelegd, als ISO 8601-tijdstempel. Offsets in de opname tellen vanaf dit punt, niet vanaf `started_at`. `null` totdat de opname begint.

**recording\_status** `string | null` *required*

Status van de opname. `null` wanneer de livestream niet is opgenomen.

Beschikbare opties: `recording`, `processing`, `completed`, `failed`

**recording\_url** `string | null` *required*

Een tijdelijke link naar het videobestand van de opname. Haal de livestream opnieuw op voor een nieuwe link. `null` totdat de opname klaar is, of wanneer deze is verwijderd.

**started\_at** `string | null` *required*

Wanneer de livestream live ging, als ISO 8601-tijdstempel. `null` voordat deze begint.

**thumbnail\_url** `string | null` *required*

Een tijdelijke link naar een stilstaand beeld uit de livestream. `null` wanneer er geen is vastgelegd.

**title** `string` *required*

Weergavetitel van de livestream. `Untitled Livestream` wanneer de host er geen heeft ingesteld.

```json Livestream theme={null}
{
	"id": "lfeed_xxxxxxxxxxxxxxxxxxxxxx",
	"title": "Live edit: blue hour",
	"started_at": "2026-09-26T19:00:00.000Z",
	"ended_at": "2026-09-26T20:45:48.000Z",
	"recording_status": "completed",
	"recording_started_at": "2026-09-26T19:00:07.000Z",
	"pinned_at": "2026-09-27T09:00:00.000Z",
	"thumbnail_url": "https://img.whop.com/livestreams/lfeed_xxxxxxxxxxxxxxxxxxxxxx.jpg",
	"recording_url": "https://whop-livestreams-example.s3.amazonaws.com/room/lfeed_xxxxxxxxxxxxxxxxxxxxxx.mp4",
	"created_at": "2026-09-26T18:59:41.000Z"
}
```


## Related topics

- [Retrieve Livestream](https://docs.whop.com/nl/api-reference/livestreams/retrieve-livestream.md)
- [Pin Livestream](https://docs.whop.com/nl/api-reference/livestreams/pin-livestream.md)
- [Unpin Livestream](https://docs.whop.com/nl/api-reference/livestreams/unpin-livestream.md)
