Skip to main content
Whop Ads ejecuta anuncios pagados en redes publicitarias externas directamente desde tu cuenta de Whop. El gasto en anuncios se cobra a la tarjeta o al saldo configurados en la cuenta, en todas sus campañas. Whop se encarga de la cuenta publicitaria, la revisión, el lanzamiento y la facturación. Dos llamadas a la API te llevan de cero a un anuncio activo: genera una creatividad y luego crea la campaña, el grupo de anuncios y el anuncio en una sola solicitud.

Recursos

Facturación y recuperación de pagos

El gasto se cobra a nivel de cuenta en todas las campañas. Un pago fallido bloquea la entrega con delivery_status: "payment_failed" y conserva el status activo/en pausa configurado de cada campaña. Corrige el método de pago de la cuenta y luego llama a Reintentar pagos de anuncios fallidos una vez para la cuenta. La respuesta pone en cola un intento en segundo plano; no confirma el pago. Tras la liquidación, las campañas activas pueden reanudarse y las campañas en pausa siguen en pausa, sujetas a otros requisitos de entrega. Consulta Pagar los anuncios para ver el flujo en el panel, un ejemplo de solicitud, el comportamiento ante solicitudes duplicadas y el manejo de campañas heredadas.

Configuración única

  • Scopes: media:generate, media:read, ad_campaign:create, ad_campaign:update, ad_campaign:basic:read.
  • Método de pago de anuncios: se conecta en el panel (saldo o tarjeta). Solo se necesita para lanzar; los borradores funcionan sin él.
1

Genera una creatividad

Se cobra de tu saldo (amount_charged; si el saldo no alcanza → 402 con un deposit_url). Consulta periódicamente GET /media/{id} hasta que status sea ready y luego usa file.id:
failed reembolsa el cargo: ajusta el prompt y vuelve a intentarlo. Video: "type": "video" más, opcionalmente, duration_seconds (5/10/15), resolution (480p–4k) y hasta 4 IDs de archivo en reference_media (el primero define el fotograma inicial).
2

Crea y lanza el anuncio en una sola solicitud

POST /ads con un ad_group y un ad_campaign en línea crea todo el árbol en una sola transacción y lo lanza:
¿Todavía no quieres gastar? Añade "status": "draft" a ad_campaign y lánzalo más tarde con PATCH /ad_campaigns/{id} {"status": "active"}.Para reutilizar contenedores existentes, pasa ad_group_id en lugar de ad_group, o ad_campaign_id en lugar de ad_campaign.
3

Supervisa

Consulta periódicamente GET /ads/{id}: delivery_status es el estado en vivo (un breve in_review para la moderación de contenido es normal), e issues[] incluye un message legible para cualquier cosa que la red publicitaria haya rechazado de forma asíncrona.Controla la entrega con pause / unpause en anuncios, grupos de anuncios o campañas. Edita los textos o las creatividades con PATCH /ads/{id}: enviar creatives reemplaza todo el conjunto, así que incluye la entrada base.

Errores

Cada validación es un 400 cuyo mensaje indica qué corregir: