> ## 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 de transmisiones en vivo

> Un Livestream representa una transmisión de video en vivo en una experiencia.

Cuando termina una transmisión en vivo grabada, los miembros pueden ver la repetición y los moderadores pueden fijar las mejores grabaciones para destacarlas.

Usa la API de transmisiones en vivo para [listar las transmisiones en vivo de una experiencia](https://docs.whop.com/es/api-reference/livestreams/list-livestreams.md), [recuperar una](https://docs.whop.com/es/api-reference/livestreams/retrieve-livestream.md) con su grabación, y [fijar](https://docs.whop.com/es/api-reference/livestreams/pin-livestream.md) o [desfijar](https://docs.whop.com/es/api-reference/livestreams/unpin-livestream.md) grabaciones.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar transmisiones en vivo](https://docs.whop.com/es/api-reference/livestreams/list-livestreams.md) | GET `/livestreams` |
| [Recuperar transmisión en vivo](https://docs.whop.com/es/api-reference/livestreams/retrieve-livestream.md) | GET `/livestreams/{id}` |
| [Recuperar audiencia de la transmisión en vivo](https://docs.whop.com/es/api-reference/livestreams/retrieve-livestream-viewership.md) | GET `/livestreams/{id}/viewership` |
| [Añadir coanfitrión a la transmisión en vivo](https://docs.whop.com/es/api-reference/livestreams/add-livestream-co-host.md) | POST `/livestreams/{id}/add_co_host` |
| [Fijar transmisión en vivo](https://docs.whop.com/es/api-reference/livestreams/pin-livestream.md) | POST `/livestreams/{id}/pin` |
| [Quitar coanfitrión de la transmisión en vivo](https://docs.whop.com/es/api-reference/livestreams/remove-livestream-co-host.md) | POST `/livestreams/{id}/remove_co_host` |
| [Desfijar transmisión en vivo](https://docs.whop.com/es/api-reference/livestreams/unpin-livestream.md) | POST `/livestreams/{id}/unpin` |

## Atributos

**id** `string` *required*

ID de la transmisión en vivo, con el prefijo `lfeed_`.

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

Cuándo se creó la transmisión en vivo, como marca de tiempo ISO 8601.

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

Cuándo terminó la transmisión en vivo, como marca de tiempo ISO 8601. `null` mientras está en directo o antes de que empiece.

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

Cuándo se fijó la grabación o se movió por última vez, como marca de tiempo ISO 8601. Las transmisiones en vivo fijadas se ordenan por este valor, de la más reciente a la más antigua. `null` cuando no está fijada.

**recap** `object`

Los mejores momentos elegidos por IA a partir del chat, y la actividad del chat. Solo `retrieve` lo devuelve, y solo a los llamadores con el permiso `livestream:moderate`.

> [accordion] Propiedades
>
> **chat** `object | null` *required*
>
> Actividad del chat durante la transmisión en vivo. `null` mientras `status` es `pending`, antes de que termine la transmisión en vivo o cuando no se pudo iniciar el resumen.
>
> > [accordion] Propiedades
> >
> > **chatter\_count** `integer` *required*
> >
> > Cuántas personas distintas enviaron esos mensajes.
> >
> > **message\_count** `integer` *required*
> >
> > Mensajes de chat enviados desde un minuto antes de `recording_started_at`, o de `started_at` cuando la transmisión en vivo no se grabó, hasta un minuto después de `ended_at`.
> >
> > **per\_minute** `integer[]` *required*
> >
> > Mensajes de chat enviados en cada minuto desde `recording_started_at`, o `started_at` cuando la transmisión en vivo no se grabó, hasta `ended_at`. Los mensajes enviados fuera de ese intervalo se excluyen.
>
> **moments** `object[]` *required*
>
> Hasta 5 mejores momentos elegidos por IA a partir de las reacciones del chat, del más antiguo al más reciente. Vacío mientras `status` no es `ready`, cuando nada destacó o cuando no se pudieron elegir. Un momento se excluye una vez que su `message` se elimina del chat.
>
> > [accordion] Propiedades
> >
> > **description** `string` *required*
> >
> > Una frase sobre lo que pasó y cómo reaccionó el chat, en 140 caracteres como máximo.
> >
> > **end\_offset\_seconds** `integer` *required*
> >
> > Dónde termina la reacción del chat al momento, en segundos desde el mismo punto que `offset_seconds`. Nunca antes de `offset_seconds` y nunca después del `offset_seconds` del siguiente momento.
> >
> > **message** `object` *required*
> >
> > Mensaje de chat que mejor resume el momento.
> >
> > > [accordion] Propiedades
> > >
> > > **id** `string` *required*
> > >
> > > ID del mensaje de chat.
> > >
> > > **content** `string` *required*
> > >
> > > Texto del mensaje, con los espacios en blanco contraídos y recortado a 280 caracteres como máximo.
> > >
> > > **user\_name** `string | null` *required*
> > >
> > > Nombre visible de la persona que envió el mensaje. `null` cuando su cuenta ya no existe.
> >
> > **offset\_seconds** `integer` *required*
> >
> > Dónde empieza el momento, poco antes de que reaccionara el chat, en segundos desde `recording_started_at`, o desde `started_at` cuando la transmisión en vivo no se grabó.
> >
> > **title** `string` *required*
> >
> > Lo que pasó en la transmisión, en 60 caracteres como máximo.
>
> **status** `string` *required*
>
> `pending` mientras se genera el resumen y `ready` una vez generado. `unavailable` cuando la transmisión en vivo no ha terminado, no tuvo chat o no se pudo iniciar el resumen. Vuelve a recuperar la transmisión en vivo más tarde mientras esté en `pending`, o para reintentar un resumen que no se pudo iniciar.
>
> Opciones disponibles: `pending`, `ready`, `unavailable`

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

Cuándo se capturó el primer fotograma de la grabación, como marca de tiempo ISO 8601. Los desplazamientos dentro de la grabación se cuentan desde aquí, no desde `started_at`. `null` hasta que empieza la grabación.

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

Estado de la grabación. `null` cuando la transmisión en vivo no se grabó.

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

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

Un enlace temporal al archivo de video de la grabación. Vuelve a recuperar la transmisión en vivo para obtener un enlace nuevo. `null` hasta que la grabación esté lista o cuando se haya eliminado.

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

Cuándo empezó la transmisión en vivo, como marca de tiempo ISO 8601. `null` antes de que empiece.

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

Un enlace temporal a un fotograma fijo de la transmisión en vivo. `null` cuando no se capturó ninguno.

**title** `string` *required*

Título visible de la transmisión en vivo. `Untitled Livestream` cuando el anfitrión no estableció uno.

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

- [API de chat](https://docs.whop.com/es/developer/guides/chat.md)
- [Unpin Livestream](https://docs.whop.com/es/api-reference/livestreams/unpin-livestream.md)
- [Pin Livestream](https://docs.whop.com/es/api-reference/livestreams/pin-livestream.md)
