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

> Une Audience est un groupe réutilisable de personnes à inclure ou à exclure lors du ciblage des annonces.

Créez des audiences personnalisées à partir de listes de clients ou de données Whop People, et créez des audiences similaires (lookalikes) pour atteindre des personnes proches d'une audience existante.

Utilisez l'API Audiences pour créer des audiences, ajouter des personnes à une liste de clients téléversée, renommer ou refiltrer une audience, et suivre le traitement asynchrone. Les audiences Whop People peuvent s'actualiser automatiquement ou conserver un instantané.

## Endpoints

| Endpoint | Requête |
| - | - |
| [List Audiences](https://docs.whop.com/fr/api-reference/audiences/list-audiences.md) | GET `/audiences` |
| [Create Audience](https://docs.whop.com/fr/api-reference/audiences/create-audience.md) | POST `/audiences` |
| [Add People](https://docs.whop.com/fr/api-reference/audiences/add-people.md) | POST `/audiences/{id}/add_people` |
| [Update Audience](https://docs.whop.com/fr/api-reference/audiences/update-audience.md) | PATCH `/audiences/{id}` |
| [Delete Audience](https://docs.whop.com/fr/api-reference/audiences/delete-audience.md) | DELETE `/audiences/{id}` |

## Attributs

**id** `string` *required*

ID de l'audience, préfixé par `adaud_`.

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

Indique si l'audience cible un groupe de personnes défini ou des personnes similaires à une audience existante.

Options disponibles : `custom`, `lookalike`

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

Indique si Whop reconstruit les membres à partir des filtres People enregistrés deux fois par jour. Lorsque `false`, les audiences People conservent les membres identifiés lors de la création. Toujours `false` pour les listes téléversées, les lookalikes et les audiences d'engagement.

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

Date de création de l'audience, sous forme d'horodatage ISO 8601.

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

La raison pour laquelle une audience `pending` n'a pas démarré, ou pour laquelle une audience `partial` ou `failed` n'est pas entièrement construite. `null` lorsqu'il n'y a rien à signaler.

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

Filtres Whop People enregistrés qui définissent les membres, avec les mêmes clés que `GET /people`. `null` pour les listes téléversées, les audiences d'engagement et les lookalikes.

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

Date de la dernière reconstruction des membres de l'audience, sous forme d'horodatage ISO 8601. `null` jusqu'à la fin de la première construction.

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

Pour les lookalikes : la borne supérieure de la tranche de similarité, sous forme de fraction (0.02 = les 2 % les plus proches). `null` pour les audiences personnalisées.

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

Pour les lookalikes : la borne inférieure de la tranche de similarité, sous forme de fraction. `null` pour les audiences personnalisées et les lookalikes de premier niveau.

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

Taux de correspondance estimés par réseau publicitaire. Vide pour les audiences d'engagement et les audiences non envoyées à un réseau pris en charge.

> [accordion] Propriétés
>
> **lower\_bound** `number | null` *required*
>
> Borne inférieure du pourcentage de correspondance estimé. `null` tant qu'il n'est pas disponible.
>
> **platform** `string` *required*
>
> La plateforme publicitaire qui a fourni l'estimation du taux de correspondance.
>
> Options disponibles : `meta`
>
> **status** `string | null` *required*
>
> Disponibilité du taux de correspondance estimé.
>
> Options disponibles : `calculating`, `available`, `unavailable`
>
> **upper\_bound** `number | null` *required*
>
> Borne supérieure du pourcentage de correspondance estimé. `null` tant qu'il n'est pas disponible.

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

Membres téléversés avec succès vers les comptes publicitaires connectés. Toujours 0 pour les lookalikes et les audiences d'engagement.

**name** `string` *required*

Nom d'affichage de l'audience.

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

ID de l'audience sur les réseaux publicitaires auxquels Whop envoie cette audience.

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

Membres traités depuis la source jusqu'à présent. Toujours 0 pour les lookalikes et les audiences d'engagement.

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

Progression du traitement, de 0 à 100.

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

Pour les lookalikes : l'audience à partir de laquelle ce lookalike a été construit. `null` pour les audiences personnalisées.

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

Source des membres : un CSV téléversé, des filtres Whop People ou l'engagement sur les réseaux sociaux. Les audiences d'engagement ne peuvent plus être créées.

Options disponibles : `csv_upload`, `people_filter`, `engagement`

**status** `string` *required*

État actuel de la création de l'audience. Lorsqu'une audience `pending` attend quelque chose, comme un compte publicitaire vers lequel téléverser, `error_message` indique quoi. Lorsque le statut est `partial` ou `failed`, `error_message` explique ce qui s'est mal passé.

Options disponibles : `pending`, `processing`, `ready`, `partial`, `failed`

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

Nombre total de membres détectés dans la source : lignes CSV pour les listes téléversées, personnes correspondantes pour les audiences automatiques. Toujours 0 pour les lookalikes et les audiences d'engagement.

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

Date de dernière mise à jour de l'audience, sous forme d'horodatage ISO 8601.

```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/fr/api-reference/audiences/delete-audience.md)
- [Update Audience](https://docs.whop.com/fr/api-reference/audiences/update-audience.md)
- [List Audiences](https://docs.whop.com/fr/api-reference/audiences/list-audiences.md)
