> ## 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, bir deneyimdeki canlı video yayınını temsil eder.

Kaydedilen bir canlı yayın sona erdikten sonra üyeler tekrarını izleyebilir, moderatörler ise en iyi kayıtları öne çıkarmak için sabitleyebilir.

Bir deneyimin [canlı yayınlarını listelemek](https://docs.whop.com/tr/api-reference/livestreams/list-livestreams.md), kaydıyla birlikte [birini almak](https://docs.whop.com/tr/api-reference/livestreams/retrieve-livestream.md) ve kayıtları [sabitlemek](https://docs.whop.com/tr/api-reference/livestreams/pin-livestream.md) veya [sabitlemesini kaldırmak](https://docs.whop.com/tr/api-reference/livestreams/unpin-livestream.md) için Livestreams API'sini kullanın.

## Uç noktalar

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

## Öznitelikler

**id** `string` *required*

`lfeed_` önekli canlı yayın kimliği.

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

Canlı yayının oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

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

Canlı yayının sona erdiği zaman, ISO 8601 zaman damgası olarak. Yayın sürerken veya başlamadan önce `null` olur.

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

Kaydın sabitlendiği veya en son taşındığı zaman, ISO 8601 zaman damgası olarak. Sabitlenmiş canlı yayınlar buna göre, en yeniden eskiye sıralanır. Sabitlenmemişse `null` olur.

**recap** `object`

Yapay zekânın sohbetten seçtiği öne çıkan anlar ve sohbet etkinliği. Yalnızca `retrieve` bunu döndürür ve yalnızca `livestream:moderate` iznine sahip çağıranlara.

> [accordion] Properties
>
> **chat** `object | null` *required*
>
> Canlı yayın sırasındaki sohbet etkinliği. `status` değeri `pending` iken, canlı yayın sona ermeden önce veya özet başlatılamadığında `null` olur.
>
> > [accordion] Properties
> >
> > **chatter\_count** `integer` *required*
> >
> > Bu mesajları kaç farklı kişinin gönderdiği.
> >
> > **message\_count** `integer` *required*
> >
> > `recording_started_at` zamanından (canlı yayın kaydedilmediyse `started_at`) bir dakika öncesinden `ended_at` zamanından bir dakika sonrasına kadar gönderilen sohbet mesajları.
> >
> > **per\_minute** `integer[]` *required*
> >
> > `recording_started_at` zamanından (canlı yayın kaydedilmediyse `started_at`) `ended_at` zamanına kadar her dakikada gönderilen sohbet mesajları. Bu aralığın dışında gönderilen mesajlar dahil edilmez.
>
> **moments** `object[]` *required*
>
> Yapay zekânın sohbetin tepki verdiği şeylerden seçtiği, en erkenden başlayarak en fazla 5 öne çıkan an. `status` değeri `ready` değilken, öne çıkan bir şey olmadığında veya anlar seçilemediğinde boştur. Bir anın `message` mesajı sohbetten kaldırıldığında o an listeden çıkarılır.
>
> > [accordion] Properties
> >
> > **description** `string` *required*
> >
> > Ne olduğunu ve sohbetin nasıl tepki verdiğini anlatan, en fazla 140 karakterlik tek bir cümle.
> >
> > **end\_offset\_seconds** `integer` *required*
> >
> > Sohbetin ana verdiği tepkinin bittiği yer; `offset_seconds` ile aynı noktadan itibaren saniye cinsinden. Hiçbir zaman `offset_seconds` değerinden önce ve bir sonraki anın `offset_seconds` değerinden sonra olmaz.
> >
> > **message** `object` *required*
> >
> > Anı en iyi özetleyen sohbet mesajı.
> >
> > > [accordion] Properties
> > >
> > > **id** `string` *required*
> > >
> > > Sohbet mesajının kimliği.
> > >
> > > **content** `string` *required*
> > >
> > > Boşlukları daraltılmış ve en fazla 280 karaktere kısaltılmış mesaj metni.
> > >
> > > **user\_name** `string | null` *required*
> > >
> > > Mesajı gönderen kişinin görünen adı. Hesabı artık mevcut değilse `null` olur.
> >
> > **offset\_seconds** `integer` *required*
> >
> > Anın başladığı yer, sohbet tepki vermeden kısa bir süre önce; `recording_started_at` zamanından (canlı yayın kaydedilmediyse `started_at` zamanından) itibaren saniye cinsinden.
> >
> > **title** `string` *required*
> >
> > Yayında ne olduğu, en fazla 60 karakterle.
>
> **status** `string` *required*
>
> Özet oluşturulurken `pending`, oluşturulduğunda `ready` olur. Canlı yayın sona ermediyse, sohbet yoksa veya özet başlatılamadıysa `unavailable` olur. `pending` durumundayken veya başlatılamayan bir özeti yeniden denemek için canlı yayını daha sonra tekrar alın.
>
> Kullanılabilir seçenekler: `pending`, `ready`, `unavailable`

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

Kaydın ilk karesinin yakalandığı zaman, ISO 8601 zaman damgası olarak. Kayıt içindeki ofsetler `started_at` zamanından değil, buradan itibaren sayılır. Kayıt başlayana kadar `null` olur.

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

Kaydın durumu. Canlı yayın kaydedilmediyse `null` olur.

Kullanılabilir seçenekler: `recording`, `processing`, `completed`, `failed`

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

Kaydın video dosyasına geçici bir bağlantı. Yeni bir bağlantı için canlı yayını tekrar alın. Kayıt hazır olana kadar veya silindiyse `null` olur.

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

Canlı yayının başladığı zaman, ISO 8601 zaman damgası olarak. Başlamadan önce `null` olur.

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

Canlı yayından alınmış bir durağan kareye geçici bir bağlantı. Hiç kare yakalanmadıysa `null` olur.

**title** `string` *required*

Canlı yayının görünen başlığı. Yayıncı bir başlık belirlemediyse `Untitled Livestream` olur.

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