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

> 라이브스트림(Livestream)은 경험 내의 라이브 영상 방송을 나타냅니다.

녹화된 라이브스트림이 종료되면 멤버는 다시보기를 시청할 수 있으며, 모더레이터는 가장 좋은 녹화본을 고정하여 소개할 수 있습니다.

Livestreams API를 사용하여 [경험의 라이브스트림 목록을 조회](https://docs.whop.com/ko/api-reference/livestreams/list-livestreams.md)하고, 녹화본과 함께 [단일 라이브스트림을 조회](https://docs.whop.com/ko/api-reference/livestreams/retrieve-livestream.md)하고, 녹화본을 [고정](https://docs.whop.com/ko/api-reference/livestreams/pin-livestream.md)하거나 [고정 해제](https://docs.whop.com/ko/api-reference/livestreams/unpin-livestream.md)할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [라이브스트림 목록 조회](https://docs.whop.com/ko/api-reference/livestreams/list-livestreams.md) | GET `/livestreams` |
| [라이브스트림 조회](https://docs.whop.com/ko/api-reference/livestreams/retrieve-livestream.md) | GET `/livestreams/{id}` |
| [라이브스트림 시청 현황 조회](https://docs.whop.com/ko/api-reference/livestreams/retrieve-livestream-viewership.md) | GET `/livestreams/{id}/viewership` |
| [라이브스트림 공동 진행자 추가](https://docs.whop.com/ko/api-reference/livestreams/add-livestream-co-host.md) | POST `/livestreams/{id}/add_co_host` |
| [라이브스트림 고정](https://docs.whop.com/ko/api-reference/livestreams/pin-livestream.md) | POST `/livestreams/{id}/pin` |
| [라이브스트림 공동 진행자 제거](https://docs.whop.com/ko/api-reference/livestreams/remove-livestream-co-host.md) | POST `/livestreams/{id}/remove_co_host` |
| [라이브스트림 고정 해제](https://docs.whop.com/ko/api-reference/livestreams/unpin-livestream.md) | POST `/livestreams/{id}/unpin` |

## 속성

**id** `string` *required*

라이브스트림 ID이며, 접두사는 `lfeed_`입니다.

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

라이브스트림이 생성된 시점으로, ISO 8601 타임스탬프입니다.

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

라이브스트림이 종료된 시점으로, ISO 8601 타임스탬프입니다. 라이브 중이거나 시작 전에는 `null`입니다.

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

녹화본이 고정되었거나 마지막으로 이동된 시점으로, ISO 8601 타임스탬프입니다. 고정된 라이브스트림은 이 값을 기준으로 최신순으로 정렬됩니다. 고정되지 않은 경우 `null`입니다.

**recap** `object`

AI가 채팅에서 선정한 주요 순간과 채팅 활동입니다. `retrieve`에서만 반환되며, `livestream:moderate` 권한이 있는 호출자에게만 반환됩니다.

> [accordion] 속성
>
> **chat** `object | null` *required*
>
> 라이브스트림 중의 채팅 활동입니다. `status`가 `pending`인 동안, 라이브스트림이 종료되기 전, 또는 요약을 시작할 수 없는 경우 `null`입니다.
>
> > [accordion] 속성
> >
> > **chatter\_count** `integer` *required*
> >
> > 해당 메시지를 보낸 서로 다른 사람의 수입니다.
> >
> > **message\_count** `integer` *required*
> >
> > `recording_started_at`(라이브스트림이 녹화되지 않은 경우 `started_at`) 1분 전부터 `ended_at` 1분 후까지 전송된 채팅 메시지입니다.
> >
> > **per\_minute** `integer[]` *required*
> >
> > `recording_started_at`(라이브스트림이 녹화되지 않은 경우 `started_at`)부터 `ended_at`까지 매분 전송된 채팅 메시지입니다. 해당 범위 밖에서 전송된 메시지는 제외됩니다.
>
> **moments** `object[]` *required*
>
> 채팅이 반응한 내용을 바탕으로 AI가 선정한 최대 5개의 주요 순간으로, 이른 순서대로 정렬됩니다. `status`가 `ready`가 아닌 동안, 눈에 띄는 순간이 없는 경우, 또는 선정할 수 없는 경우 비어 있습니다. 순간의 `message`가 채팅에서 삭제되면 해당 순간은 제외됩니다.
>
> > [accordion] 속성
> >
> > **description** `string` *required*
> >
> > 무슨 일이 있었고 채팅이 어떻게 반응했는지를 최대 140자로 설명하는 한 문장입니다.
> >
> > **end\_offset\_seconds** `integer` *required*
> >
> > 순간에 대한 채팅 반응이 끝나는 지점으로, `offset_seconds`와 같은 기준점으로부터의 초 단위입니다. `offset_seconds`보다 앞서지 않으며, 다음 순간의 `offset_seconds`보다 뒤에 있지 않습니다.
> >
> > **message** `object` *required*
> >
> > 순간을 가장 잘 요약하는 채팅 메시지입니다.
> >
> > > [accordion] 속성
> > >
> > > **id** `string` *required*
> > >
> > > 채팅 메시지의 ID입니다.
> > >
> > > **content** `string` *required*
> > >
> > > 공백이 축소되고 최대 280자로 잘린 메시지 텍스트입니다.
> > >
> > > **user\_name** `string | null` *required*
> > >
> > > 메시지를 보낸 사람의 표시 이름입니다. 해당 계정이 더 이상 존재하지 않는 경우 `null`입니다.
> >
> > **offset\_seconds** `integer` *required*
> >
> > 채팅이 반응하기 직전 순간이 시작되는 지점으로, `recording_started_at`(라이브스트림이 녹화되지 않은 경우 `started_at`)으로부터의 초 단위입니다.
> >
> > **title** `string` *required*
> >
> > 방송에서 일어난 일을 최대 60자로 나타낸 것입니다.
>
> **status** `string` *required*
>
> 요약이 생성되는 동안 `pending`, 생성이 완료되면 `ready`입니다. 라이브스트림이 종료되지 않았거나, 채팅이 없었거나, 요약을 시작할 수 없는 경우 `unavailable`입니다. `pending`인 동안 또는 시작할 수 없었던 요약을 재시도하려면 나중에 라이브스트림을 다시 조회하세요.
>
> 사용 가능한 옵션: `pending`, `ready`, `unavailable`

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

녹화본의 첫 프레임이 캡처된 시점으로, ISO 8601 타임스탬프입니다. 녹화본 내 오프셋은 `started_at`이 아닌 이 시점부터 계산됩니다. 녹화가 시작될 때까지 `null`입니다.

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

녹화 상태입니다. 라이브스트림이 녹화되지 않은 경우 `null`입니다.

사용 가능한 옵션: `recording`, `processing`, `completed`, `failed`

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

녹화 영상 파일에 대한 임시 링크입니다. 새 링크를 받으려면 라이브스트림을 다시 조회하세요. 녹화본이 준비될 때까지 또는 삭제된 경우 `null`입니다.

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

라이브스트림이 시작된 시점으로, ISO 8601 타임스탬프입니다. 시작 전에는 `null`입니다.

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

라이브스트림의 정지 프레임에 대한 임시 링크입니다. 캡처된 것이 없는 경우 `null`입니다.

**title** `string` *required*

라이브스트림의 표시 제목입니다. 진행자가 설정하지 않은 경우 `Untitled Livestream`입니다.

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