Skip to main content
An Audience is a reusable group of people to include or exclude when targeting ads. Build custom audiences from customer lists or Whop People data, and create lookalikes to reach people similar to an existing audience. Use the Audiences API to create audiences, add people to an uploaded customer list, rename or refilter an audience, and monitor asynchronous processing. Whop People audiences can refresh automatically or keep a snapshot.

​
Endpoints

​
Attributes

​
string
required
Audience ID, prefixed adaud_.
​
string
required
Whether the audience targets a defined group of people or people similar to an existing audience.Available options: custom, lookalike
​
boolean
required
Whether Whop rebuilds membership from saved People filters twice a day. When false, People audiences keep the members matched at creation. Always false for uploaded lists, lookalikes, and engagement audiences.
​
string
required
When the audience was created, as an ISO 8601 timestamp.
​
string | null
required
Why a pending audience hasn’t started, or why a partial or failed one isn’t fully built. null when there is nothing to report.
​
object | null
required
Saved Whop People filters that define membership, using the same keys as GET /people. null for uploaded lists, engagement audiences, and lookalikes.
​
string | null
required
When the audience membership was last rebuilt, as an ISO 8601 timestamp. null until the first build completes.
​
number | null
required
For lookalikes: the upper bound of the similarity band as a fraction (0.02 = top 2%). null for custom audiences.
​
number | null
required
For lookalikes: the lower bound of the similarity band as a fraction. null for custom audiences and first-tier lookalikes.
​
object[]
required
Estimated match rates by ad network. Empty for engagement audiences and audiences not sent to a supported network.

Properties

​
number | null
required
Lower bound of the estimated match rate percentage. null until available.
​
string
required
The ad platform that provided the match-rate estimate.Available options: meta
​
string | null
required
Availability of the estimated match rate.Available options: calculating, available, unavailable
​
number | null
required
Upper bound of the estimated match rate percentage. null until available.
​
number
required
Members successfully uploaded to connected ad accounts. Always 0 for lookalikes and engagement audiences.
​
string
required
Audience display name.
​
string[]
required
Audience IDs on the ad networks Whop sends this audience to.
​
number
required
Members processed from the source so far. Always 0 for lookalikes and engagement audiences.
​
number
required
Processing progress from 0 to 100.
​
string | null
required
For lookalikes: the audience this lookalike was built from. null for custom audiences.
​
string
required
Membership source: an uploaded CSV, Whop People filters, or social engagement. Engagement audiences can no longer be created.Available options: csv_upload, people_filter, engagement
​
string
required
Current state of audience creation. syncing means Whop is sending matched rows to connected ad accounts. When a pending audience is waiting on something, such as an ad account to upload to, error_message says what. When status is partial or failed, error_message explains what went wrong.Available options: pending, processing, syncing, ready, partial, failed
​
number
required
Total members detected in the source — CSV rows for uploaded lists, matching people for automatic audiences. Always 0 for lookalikes and engagement audiences.
​
string
required
When the audience was last updated, as an ISO 8601 timestamp.
Audience