> ## 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.

# API Livestreams

> Un Livestream représente une diffusion vidéo en direct dans une expérience.

Une fois un livestream enregistré terminé, les membres peuvent regarder la rediffusion et les modérateurs peuvent épingler les meilleurs enregistrements pour les mettre en avant.

Utilisez l'API Livestreams pour [lister les livestreams d'une expérience](https://docs.whop.com/fr/api-reference/livestreams/list-livestreams.md), [en récupérer un](https://docs.whop.com/fr/api-reference/livestreams/retrieve-livestream.md) avec son enregistrement, et [épingler](https://docs.whop.com/fr/api-reference/livestreams/pin-livestream.md) ou [désépingler](https://docs.whop.com/fr/api-reference/livestreams/unpin-livestream.md) des enregistrements.

## Endpoints

| Endpoint | Requête |
| - | - |
| [List Livestreams](https://docs.whop.com/fr/api-reference/livestreams/list-livestreams.md) | GET `/livestreams` |
| [Retrieve Livestream](https://docs.whop.com/fr/api-reference/livestreams/retrieve-livestream.md) | GET `/livestreams/{id}` |
| [Retrieve Livestream Viewership](https://docs.whop.com/fr/api-reference/livestreams/retrieve-livestream-viewership.md) | GET `/livestreams/{id}/viewership` |
| [Add Livestream Co-host](https://docs.whop.com/fr/api-reference/livestreams/add-livestream-co-host.md) | POST `/livestreams/{id}/add_co_host` |
| [Pin Livestream](https://docs.whop.com/fr/api-reference/livestreams/pin-livestream.md) | POST `/livestreams/{id}/pin` |
| [Remove Livestream Co-host](https://docs.whop.com/fr/api-reference/livestreams/remove-livestream-co-host.md) | POST `/livestreams/{id}/remove_co_host` |
| [Unpin Livestream](https://docs.whop.com/fr/api-reference/livestreams/unpin-livestream.md) | POST `/livestreams/{id}/unpin` |

## Attributs

**id** `string` *required*

ID du livestream, préfixé par `lfeed_`.

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

Date de création du livestream, sous forme de timestamp ISO 8601.

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

Date de fin du livestream, sous forme de timestamp ISO 8601. `null` pendant le direct ou avant son début.

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

Date à laquelle l'enregistrement a été épinglé ou déplacé pour la dernière fois, sous forme de timestamp ISO 8601. Les livestreams épinglés sont triés selon cette valeur, du plus récent au plus ancien. `null` lorsqu'il n'est pas épinglé.

**recap** `object`

Les meilleurs moments sélectionnés par l'IA à partir du chat, ainsi que l'activité du chat. Seul `retrieve` le renvoie, et uniquement aux appelants disposant de la permission `livestream:moderate`.

> [accordion] Properties
>
> **chat** `object | null` *required*
>
> L'activité du chat pendant le livestream. `null` lorsque `status` vaut `pending`, avant la fin du livestream, ou lorsque le récapitulatif n'a pas pu être lancé.
>
> > [accordion] Properties
> >
> > **chatter\_count** `integer` *required*
> >
> > Le nombre de personnes distinctes ayant envoyé ces messages.
> >
> > **message\_count** `integer` *required*
> >
> > Messages de chat envoyés depuis une minute avant `recording_started_at` (ou `started_at` lorsque le livestream n'a pas été enregistré) jusqu'à une minute après `ended_at`.
> >
> > **per\_minute** `integer[]` *required*
> >
> > Messages de chat envoyés chaque minute depuis `recording_started_at` (ou `started_at` lorsque le livestream n'a pas été enregistré) jusqu'à `ended_at`. Les messages envoyés en dehors de cette période sont exclus.
>
> **moments** `object[]` *required*
>
> Jusqu'à 5 meilleurs moments sélectionnés par l'IA à partir des réactions du chat, du plus ancien au plus récent. Vide lorsque `status` n'est pas `ready`, lorsque rien ne s'est démarqué ou lorsqu'ils n'ont pas pu être sélectionnés. Un moment est exclu dès que son `message` est supprimé du chat.
>
> > [accordion] Properties
> >
> > **description** `string` *required*
> >
> > Une phrase décrivant ce qui s'est passé et comment le chat a réagi, en 140 caractères maximum.
> >
> > **end\_offset\_seconds** `integer` *required*
> >
> > Moment où la réaction du chat à ce moment se termine, en secondes à partir du même point de référence que `offset_seconds`. Jamais avant `offset_seconds`, et jamais après le `offset_seconds` du moment suivant.
> >
> > **message** `object` *required*
> >
> > Le message de chat qui résume le mieux le moment.
> >
> > > [accordion] Properties
> > >
> > > **id** `string` *required*
> > >
> > > ID du message de chat.
> > >
> > > **content** `string` *required*
> > >
> > > Texte du message, avec les espaces regroupés et tronqué à 280 caractères maximum.
> > >
> > > **user\_name** `string | null` *required*
> > >
> > > Nom d'affichage de la personne qui a envoyé le message. `null` lorsque son compte n'existe plus.
> >
> > **offset\_seconds** `integer` *required*
> >
> > Début du moment, peu avant la réaction du chat, en secondes à partir de `recording_started_at`, ou de `started_at` lorsque le livestream n'a pas été enregistré.
> >
> > **title** `string` *required*
> >
> > Ce qui s'est passé pendant le stream, en 60 caractères maximum.
>
> **status** `string` *required*
>
> `pending` pendant la génération du récapitulatif et `ready` une fois celui-ci prêt. `unavailable` lorsque le livestream n'est pas terminé, n'a pas eu de chat ou que le récapitulatif n'a pas pu être lancé. Récupérez à nouveau le livestream plus tard tant qu'il est `pending`, ou pour relancer un récapitulatif qui n'a pas pu être lancé.
>
> Options disponibles : `pending`, `ready`, `unavailable`

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

Moment où la première image de l'enregistrement a été capturée, sous forme de timestamp ISO 8601. Les décalages dans l'enregistrement sont comptés à partir de ce moment, et non à partir de `started_at`. `null` jusqu'au début de l'enregistrement.

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

État de l'enregistrement. `null` lorsque le livestream n'a pas été enregistré.

Options disponibles : `recording`, `processing`, `completed`, `failed`

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

Un lien temporaire vers le fichier vidéo de l'enregistrement. Récupérez à nouveau le livestream pour obtenir un nouveau lien. `null` jusqu'à ce que l'enregistrement soit prêt, ou lorsqu'il a été supprimé.

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

Moment où le livestream a démarré, sous forme de timestamp ISO 8601. `null` avant son début.

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

Un lien temporaire vers une image fixe du livestream. `null` lorsqu'aucune n'a été capturée.

**title** `string` *required*

Titre d'affichage du livestream. `Untitled Livestream` lorsque l'hôte n'en a pas défini.

```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

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