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

# Audiences API

> Audience, reklamları hedeflerken dahil edilecek veya hariç tutulacak yeniden kullanılabilir bir kişi grubudur.

Müşteri listelerinden veya Whop People verilerinden özel hedef kitleler oluşturun ve mevcut bir hedef kitleye benzeyen kişilere ulaşmak için benzer hedef kitleler (lookalike) oluşturun.

Hedef kitle oluşturmak, yüklenmiş bir müşteri listesine kişi eklemek, bir hedef kitleyi yeniden adlandırmak veya yeniden filtrelemek ve eşzamansız işlemeyi izlemek için Audiences API'yi kullanın. Whop People hedef kitleleri otomatik olarak yenilenebilir veya bir anlık görüntüyü koruyabilir.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [List Audiences](https://docs.whop.com/tr/api-reference/audiences/list-audiences.md) | GET `/audiences` |
| [Create Audience](https://docs.whop.com/tr/api-reference/audiences/create-audience.md) | POST `/audiences` |
| [Add People](https://docs.whop.com/tr/api-reference/audiences/add-people.md) | POST `/audiences/{id}/add_people` |
| [Update Audience](https://docs.whop.com/tr/api-reference/audiences/update-audience.md) | PATCH `/audiences/{id}` |
| [Delete Audience](https://docs.whop.com/tr/api-reference/audiences/delete-audience.md) | DELETE `/audiences/{id}` |

## Özellikler

**id** `string` *required*

`adaud_` önekli hedef kitle kimliği.

**audience\_type** `string` *required*

Hedef kitlenin tanımlı bir kişi grubunu mu yoksa mevcut bir hedef kitleye benzeyen kişileri mi hedeflediği.

Kullanılabilir seçenekler: `custom`, `lookalike`

**auto\_refresh** `boolean` *required*

Whop'un üyeliği kayıtlı People filtrelerinden günde iki kez yeniden oluşturup oluşturmadığı. `false` olduğunda People hedef kitleleri oluşturma sırasında eşleşen üyeleri korur. Yüklenmiş listeler, benzer hedef kitleler ve etkileşim hedef kitleleri için her zaman `false`.

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

Hedef kitlenin oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**error\_message** `string | null` *required*

`pending` durumundaki bir hedef kitlenin neden başlamadığı veya `partial` ya da `failed` durumundaki bir hedef kitlenin neden tam olarak oluşturulmadığı. Bildirilecek bir şey olmadığında `null`.

**filters** `object | null` *required*

Üyeliği tanımlayan, `GET /people` ile aynı anahtarları kullanan kayıtlı Whop People filtreleri. Yüklenmiş listeler, etkileşim hedef kitleleri ve benzer hedef kitleler için `null`.

**last\_refreshed\_at** `string | null` *required*

Hedef kitle üyeliğinin en son yeniden oluşturulduğu zaman, ISO 8601 zaman damgası olarak. İlk oluşturma tamamlanana kadar `null`.

**lookalike\_ratio** `number | null` *required*

Benzer hedef kitleler için: benzerlik bandının kesir olarak üst sınırı (0.02 = ilk %2). Özel hedef kitleler için `null`.

**lookalike\_starting\_ratio** `number | null` *required*

Benzer hedef kitleler için: benzerlik bandının kesir olarak alt sınırı. Özel hedef kitleler ve birinci kademe benzer hedef kitleler için `null`.

**match\_rates** `object[]` *required*

Reklam ağına göre tahmini eşleşme oranları. Etkileşim hedef kitleleri ve desteklenen bir ağa gönderilmeyen hedef kitleler için boştur.

> [accordion] Özellikler
>
> **lower\_bound** `number | null` *required*
>
> Tahmini eşleşme oranı yüzdesinin alt sınırı. Kullanılabilir olana kadar `null`.
>
> **platform** `string` *required*
>
> Eşleşme oranı tahminini sağlayan reklam platformu.
>
> Kullanılabilir seçenekler: `meta`
>
> **status** `string | null` *required*
>
> Tahmini eşleşme oranının kullanılabilirliği.
>
> Kullanılabilir seçenekler: `calculating`, `available`, `unavailable`
>
> **upper\_bound** `number | null` *required*
>
> Tahmini eşleşme oranı yüzdesinin üst sınırı. Kullanılabilir olana kadar `null`.

**matched\_rows** `number` *required*

Bağlı reklam hesaplarına başarıyla yüklenen üyeler. Benzer hedef kitleler ve etkileşim hedef kitleleri için her zaman 0.

**name** `string` *required*

Hedef kitlenin görünen adı.

**platform\_audience\_ids** `string[]` *required*

Whop'un bu hedef kitleyi gönderdiği reklam ağlarındaki hedef kitle kimlikleri.

**processed\_rows** `number` *required*

Şimdiye kadar kaynaktan işlenen üyeler. Benzer hedef kitleler ve etkileşim hedef kitleleri için her zaman 0.

**progress\_percent** `number` *required*

0 ile 100 arasında işleme ilerlemesi.

**source\_audience\_id** `string | null` *required*

Benzer hedef kitleler için: bu benzer hedef kitlenin oluşturulduğu hedef kitle. Özel hedef kitleler için `null`.

**source\_type** `string` *required*

Üyelik kaynağı: yüklenmiş bir CSV, Whop People filtreleri veya sosyal etkileşim. Etkileşim hedef kitleleri artık oluşturulamaz.

Kullanılabilir seçenekler: `csv_upload`, `people_filter`, `engagement`

**status** `string` *required*

Hedef kitle oluşturmanın mevcut durumu. `pending` durumundaki bir hedef kitle, yüklenecek bir reklam hesabı gibi bir şeyi beklerken `error_message` neyi beklediğini belirtir. Durum `partial` veya `failed` olduğunda `error_message` neyin yanlış gittiğini açıklar.

Kullanılabilir seçenekler: `pending`, `processing`, `ready`, `partial`, `failed`

**total\_rows** `number` *required*

Kaynakta tespit edilen toplam üye sayısı — yüklenmiş listeler için CSV satırları, otomatik hedef kitleler için eşleşen kişiler. Benzer hedef kitleler ve etkileşim hedef kitleleri için her zaman 0.

**updated\_at** `string` *required*

Hedef kitlenin en son güncellendiği zaman, ISO 8601 zaman damgası olarak.

```json Audience theme={null}
{
	"id": "adaud_PastPurchasers123",
	"name": "Past purchasers",
	"status": "ready",
	"audience_type": "custom",
	"source_type": "people_filter",
	"source_audience_id": null,
	"lookalike_ratio": null,
	"lookalike_starting_ratio": null,
	"total_rows": 2500,
	"processed_rows": 2500,
	"matched_rows": 1830,
	"progress_percent": 100,
	"error_message": null,
	"platform_audience_ids": ["120246230799130686"],
	"filters": {
		"has_purchased": true,
		"country": "US"
	},
	"auto_refresh": true,
	"last_refreshed_at": "2025-12-01T01:00:00Z",
	"match_rates": [
		{
			"platform": "meta",
			"status": "available",
			"lower_bound": 68.2,
			"upper_bound": 74.5
		}
	],
	"created_at": "2025-12-01T00:00:00Z",
	"updated_at": "2025-12-01T01:00:00Z"
}
```


## Related topics

- [Delete Audience](https://docs.whop.com/tr/api-reference/audiences/delete-audience.md)
- [Update Audience](https://docs.whop.com/tr/api-reference/audiences/update-audience.md)
- [List Audiences](https://docs.whop.com/tr/api-reference/audiences/list-audiences.md)
