Skip to main content
Crea audiencias personalizadas a partir de listas de clientes o de datos de Whop People, y crea audiencias similares (lookalikes) para llegar a personas parecidas a una audiencia existente. Usa la API de Audiences para crear audiencias, añadir personas a una lista de clientes subida, renombrar o volver a filtrar una audiencia y supervisar el procesamiento asíncrono. Las audiencias de Whop People pueden actualizarse automáticamente o conservar una instantánea.

Endpoints

Atributos

string
requerido
ID de la audiencia, con el prefijo adaud_.
string
requerido
Si la audiencia se dirige a un grupo definido de personas o a personas similares a una audiencia existente.Opciones disponibles: custom, lookalike
boolean
requerido
Si Whop reconstruye la membresía a partir de los filtros de People guardados dos veces al día. Cuando es false, las audiencias de People conservan los miembros que coincidieron al crearlas. Siempre false para listas subidas, lookalikes y audiencias de interacción.
string
requerido
Cuándo se creó la audiencia, como marca de tiempo ISO 8601.
string | null
requerido
Por qué una audiencia pending no ha empezado, o por qué una partial o failed no está completamente construida. null cuando no hay nada que informar.
object | null
requerido
Filtros de Whop People guardados que definen la membresía, con las mismas claves que GET /people. null para listas subidas, audiencias de interacción y lookalikes.
string | null
requerido
Cuándo se reconstruyó por última vez la membresía de la audiencia, como marca de tiempo ISO 8601. null hasta que se completa la primera construcción.
number | null
requerido
Para lookalikes: el límite superior de la franja de similitud como fracción (0.02 = el 2% superior). null para audiencias personalizadas.
number | null
requerido
Para lookalikes: el límite inferior de la franja de similitud como fracción. null para audiencias personalizadas y lookalikes de primer nivel.
object[]
requerido
Tasas de coincidencia estimadas por red publicitaria. Vacío para audiencias de interacción y audiencias no enviadas a una red compatible.

Propiedades

number | null
requerido
Límite inferior del porcentaje estimado de coincidencia. null hasta que esté disponible.
string
requerido
La plataforma de anuncios que proporcionó la estimación de la tasa de coincidencia.Opciones disponibles: meta
string | null
requerido
Disponibilidad de la tasa de coincidencia estimada.Opciones disponibles: calculating, available, unavailable
number | null
requerido
Límite superior del porcentaje estimado de coincidencia. null hasta que esté disponible.
number
requerido
Miembros subidos correctamente a las cuentas publicitarias conectadas. Siempre 0 para lookalikes y audiencias de interacción.
string
requerido
Nombre visible de la audiencia.
string[]
requerido
IDs de la audiencia en las redes publicitarias a las que Whop envía esta audiencia.
number
requerido
Miembros procesados desde la fuente hasta el momento. Siempre 0 para lookalikes y audiencias de interacción.
number
requerido
Progreso del procesamiento de 0 a 100.
string | null
requerido
Para lookalikes: la audiencia a partir de la cual se construyó este lookalike. null para audiencias personalizadas.
string
requerido
Fuente de la membresía: un CSV subido, filtros de Whop People o interacción en redes sociales. Ya no se pueden crear audiencias de interacción.Opciones disponibles: csv_upload, people_filter, engagement
string
requerido
Estado actual de la creación de la audiencia. Cuando una audiencia pending está esperando algo, como una cuenta publicitaria a la que subirla, error_message indica qué. Cuando el estado es partial o failed, error_message explica qué salió mal.Opciones disponibles: pending, processing, ready, partial, failed
number
requerido
Total de miembros detectados en la fuente: filas del CSV para listas subidas, personas coincidentes para audiencias automáticas. Siempre 0 para lookalikes y audiencias de interacción.
string
requerido
Cuándo se actualizó la audiencia por última vez, como marca de tiempo ISO 8601.
Audience