> ## 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 de Ads

> Un Ad es la unidad creativa individual que entrega un grupo de anuncios. Contiene los textos, los recursos creativos y la URL de destino de un anuncio.

Un Ad es la unidad creativa individual que entrega un [grupo de anuncios](https://docs.whop.com/es/api-reference/ad-groups/ad-group). Contiene los textos, los recursos creativos y la URL de destino de un anuncio.

Usa la API de Ads para listar los anuncios de una cuenta, crear anuncios dentro de grupos de anuncios, obtener o actualizar los detalles creativos, eliminar anuncios que deban dejar de ejecutarse y pausar o reanudar la entrega.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Ads](https://docs.whop.com/es/api-reference/ads/list-ads.md) | GET `/ads` |
| [Obtener un Ad](https://docs.whop.com/es/api-reference/ads/retrieve-an-ad.md) | GET `/ads/{id}` |
| [Crear un Ad](https://docs.whop.com/es/api-reference/ads/create-an-ad.md) | POST `/ads` |
| [Duplicar un Ad](https://docs.whop.com/es/api-reference/ads/duplicate-an-ad.md) | POST `/ads/{id}/duplicate` |
| [Pausar un Ad](https://docs.whop.com/es/api-reference/ads/pause-an-ad.md) | POST `/ads/{id}/pause` |
| [Reanudar un Ad](https://docs.whop.com/es/api-reference/ads/unpause-an-ad.md) | POST `/ads/{id}/unpause` |
| [Actualizar un Ad](https://docs.whop.com/es/api-reference/ads/update-an-ad.md) | PATCH `/ads/{id}` |
| [Eliminar un Ad](https://docs.whop.com/es/api-reference/ads/delete-an-ad.md) | DELETE `/ads/{id}` |

## Atributos

**id** `string` *required*

Identificador único del anuncio, con el prefijo `ad_`.

**ad\_campaign** `object` *required*

La campaña publicitaria a la que pertenece este anuncio.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El id de la entidad referenciada.

**ad\_group** `object` *required*

El grupo de anuncios al que pertenece este anuncio.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El id de la entidad referenciada.

**added\_to\_cart\_value** `number` *required*

Valor en USD atribuido a los eventos de añadir al carrito. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**added\_to\_carts** `number` *required*

Eventos de añadir al carrito atribuidos por el píxel de Whop, último clic.

**call\_to\_action** `string | null` *required*

El botón de llamada a la acción que se muestra en el anuncio.

Opciones disponibles: `learn_more`, `shop_now`, `sign_up`, `subscribe`, `get_started`, `book_now`, `apply_now`, `contact_us`, `download`, `order_now`, `buy_now`, `get_quote`, `message_page`, `whatsapp_message`, `instagram_message`, `call_now`, `get_directions`, `send_updates`, `get_offer`, `watch_more`, `listen_now`, `play_game`, `open_link`, `no_button`, `get_offer_view`, `get_event_tickets`, `see_menu`, `request_time`, `event_rsvp`, `see_details`, `view_instagram_profile`, `donate_now`, `see_more`, `visit_site`

**click\_through\_rate** `number` *required*

Clics divididos entre impresiones, entre 0 y 1.

**clicks** `number` *required*

El número de clics.

**completed\_registration\_value** `number` *required*

Valor en USD atribuido a los eventos de registro completado. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**completed\_registrations** `number` *required*

Eventos de registro completado atribuidos por el píxel de Whop, último clic.

**contact\_value** `number` *required*

Valor en USD atribuido a los eventos de contacto. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**contacts** `number` *required*

Eventos de contacto atribuidos por el píxel de Whop, último clic.

**content\_review** `object` *required*

La revisión de contenido de Whop para este anuncio: si ha terminado, para qué redes publicitarias se recomienda y qué reglas de contenido incumple.

> [accordion] Propiedades
>
> **networks** `object[]` *required*
>
> Si cada red puede ejecutar el anuncio. Vacío hasta que termina la revisión.
>
> > [accordion] Propiedades
> >
> > **recommended** `boolean` *required*
> >
> > Si el anuncio cumple la política de contenido de Whop y la de esta red.
> >
> > **title** `string` *required*
> >
> > La red. `whop` es la propia política de contenido de Whop, que todas las demás redes también exigen.
> >
> > Opciones disponibles: `whop`, `meta`, `tiktok`, `google`
>
> **status** `string` *required*
>
> `reviewed` una vez que termina la revisión de contenido de Whop, `in_review` mientras se ejecuta, `not_reviewed` cuando nunca se ejecutó.
>
> Opciones disponibles: `reviewed`, `in_review`, `not_reviewed`
>
> **tags** `object[]` *required*
>
> Todas las reglas que la revisión determinó que el anuncio incumple, en cualquier red. Vacío cuando no incumple ninguna o la revisión no ha terminado.
>
> > [accordion] Propiedades
> >
> > **message** `string` *required*
> >
> > La evidencia que registró la revisión para esta regla.
> >
> > **title** `string` *required*
> >
> > La regla que la revisión de contenido de Whop determinó que el anuncio incumple.

**cost\_per\_added\_to\_cart** `number | null` *required*

Gasto dividido entre los eventos de añadir al carrito atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**cost\_per\_click** `number` *required*

Gasto dividido entre clics; 0 cuando no hay clics.

**cost\_per\_completed\_registration** `number | null` *required*

Gasto dividido entre los eventos de registro completado atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**cost\_per\_contact** `number | null` *required*

Gasto dividido entre los eventos de contacto atribuidos; null cuando los contactos no son el objetivo y no hay ninguno atribuido.

**cost\_per\_lead** `number | null` *required*

Gasto dividido entre los leads atribuidos; null cuando los leads no son un objetivo y no hay ninguno atribuido.

**cost\_per\_mille** `number` *required*

Gasto por cada 1.000 impresiones; 0 cuando no hay impresiones.

**cost\_per\_purchase** `number | null` *required*

Gasto dividido entre las compras atribuidas; null cuando las compras no son un objetivo y no hay ninguna atribuida.

**cost\_per\_result** `number | null` *required*

Gasto dividido entre los resultados atribuidos por el píxel de Whop; null cuando no se está optimizando para nada atribuible por Whop.

**cost\_per\_schedule** `number | null` *required*

Gasto dividido entre los eventos de agendamiento atribuidos; null cuando los agendamientos no son el objetivo y no hay ninguno atribuido.

**cost\_per\_submitted\_application** `number | null` *required*

Gasto dividido entre los eventos de envío de solicitud atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**cost\_per\_unique\_click** `number | null` *required*

Gasto dividido entre clics únicos; null cuando no hay clics únicos.

**cost\_per\_viewed\_content** `number | null` *required*

Gasto dividido entre los eventos de visualización de contenido atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

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

Cuándo se creó el anuncio, como marca de tiempo ISO 8601.

**creatives** `object[]` *required*

Los recursos creativos que usa este anuncio. El recurso original tiene un format null; las entradas square, vertical y horizontal son variantes específicas de cada ubicación. Un anuncio de carrusel devuelve una entrada con format null por cada adjunto, en orden.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El id de archivo del adjunto creativo.
>
> **crop** `object | null` *required*
>
> El área de recorte guardada para esta creatividad, en píxeles de la imagen original. Null para el recurso original o para un formato que no se ha recortado.
>
> > [accordion] Propiedades
> >
> > **height** `number` *required*
> >
> > Alto del área de recorte en píxeles de origen.
> >
> > **width** `number` *required*
> >
> > Ancho del área de recorte en píxeles de origen.
> >
> > **x** `number` *required*
> >
> > Borde izquierdo del área de recorte en píxeles de origen.
> >
> > **y** `number` *required*
> >
> > Borde superior del área de recorte en píxeles de origen.
>
> **format** `string | null` *required*
>
> La variante de ubicación que cubre este recurso, o null para el recurso original.
>
> Opciones disponibles: `square`, `vertical`, `horizontal`
>
> **language** `string | null` *required*
>
> Siempre `null`. Las traducciones ya no están disponibles.
>
> **media\_type** `string | null` *required*
>
> El tipo de recurso, imagen o video.
>
> **url** `string | null` *required*
>
> URL del recurso en la CDN.

**custom\_conversions** `number` *required*

Eventos de conversión personalizados (definidos por el comerciante) atribuidos por el píxel de Whop, último clic, en todos los nombres de eventos personalizados.

**custom\_event\_counts** `object` *required*

Conversiones personalizadas atribuidas por el píxel de Whop, indexadas por el nombre de tu evento, con su recuento de último clic como valor. Vacío cuando no hay eventos personalizados con nombre atribuidos. Los eventos personalizados disparados sin nombre se cuentan en custom\_conversions pero se omiten aquí, por lo que estos valores suman como máximo custom\_conversions.

**custom\_event\_values** `object` *required*

Valor de conversión atribuido a cada evento personalizado, indexado por nombre de evento como custom\_event\_counts. Suma el valor pasado a whop.track, normalizado a USD; los eventos disparados sin valor aportan 0.

**delivery\_status** `string` *required*

Si el anuncio se está entregando ahora mismo y, si no, por qué. Cuando se aplican varios estados a la vez, se devuelve el de mayor precedencia.

Opciones disponibles: `rejected`, `in_review`, `draft`, `campaign_paused`, `paused`, `processing`, `revise_content`, `issues`, `scheduled`, `learning`, `active`

**descriptions** `object[]` *required*

La descripción que se muestra en el anuncio.

> [accordion] Propiedades
>
> **language** `string | null` *required*
>
> Siempre `null`. Las traducciones ya no están disponibles.
>
> **text** `string` *required*
>
> El texto que se muestra a los espectadores.

**frequency** `number | null` *required*

Impresiones divididas entre el alcance.

**headlines** `object[]` *required*

El titular que se muestra en el anuncio.

> [accordion] Propiedades
>
> **language** `string | null` *required*
>
> Siempre `null`. Las traducciones ya no están disponibles.
>
> **text** `string` *required*
>
> El texto que se muestra a los espectadores.

**impressions** `number` *required*

El número de impresiones.

**issues** `object[]` *required*

Problemas abiertos que afectan a este anuncio. Vacío cuando no hay ninguno.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> Identificador único del problema.
>
> **category** `string` *required*
>
> El tipo de problema: información sobre la entrega, una advertencia o un error que requiere atención.
>
> Opciones disponibles: `information`, `warning`, `error`
>
> **message** `string` *required*
>
> Una descripción de en qué consiste el problema y cómo puede resolverse.
>
> **resource\_id** `string | null` *required*
>
> El ID de la campaña, el grupo de anuncios o el anuncio al que está asociado el problema.
>
> **resource\_type** `string` *required*
>
> El tipo de recurso al que está asociado el problema.
>
> Opciones disponibles: `ad_campaign`, `ad_group`, `ad`
>
> **title** `string` *required*
>
> Un título breve del problema, orientado al creador: la regla que indica un rechazo de la revisión de contenido, o una etiqueta genérica.

**lead\_value** `number` *required*

Valor en USD atribuido a los eventos de lead. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**leads** `number` *required*

Leads atribuidos por el píxel de Whop, último clic.

**link\_clicks** `number` *required*

Vistas de página en tu destino de personas que hicieron clic en el anuncio, registradas por el píxel de Whop. Se cuentan de la misma forma en todas las plataformas de anuncios.

**primary\_texts** `object[]` *required*

El texto principal que se muestra en el cuerpo del anuncio. Varias entradas crean variaciones de texto.

> [accordion] Propiedades
>
> **language** `string | null` *required*
>
> Siempre `null`. Las traducciones ya no están disponibles.
>
> **text** `string` *required*
>
> El texto que se muestra a los espectadores.

**purchase\_value** `number` *required*

Valor en USD de las compras atribuidas por el píxel.

**purchases** `number` *required*

Compras atribuidas por el píxel de Whop, último clic.

**reach** `number` *required*

El número de personas únicas que vieron esto.

**result\_event** `string | null` *required*

El evento de conversión del píxel de Whop cuyo recuento atribuido representa los resultados: el objetivo de optimización, o el evento atribuido de mayor volumen en las campañas con presupuesto por grupo de anuncios. Null cuando el objetivo no es un evento atribuido por Whop.

Opciones disponibles: `purchase`, `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `custom`, `messaging_conversation`

**result\_event\_name** `string | null` *required*

El nombre del evento definido por el comerciante cuando result\_event es custom; null para los eventos estándar.

**results** `number | null` *required*

El recuento atribuido por el píxel de Whop detrás de result\_event. Cuando los grupos de anuncios de una campaña optimizan objetivos distintos no hay un único result\_event (es null), y esto es en cambio la suma de los resultados atribuidos de cada grupo de anuncios. Null cuando no se está optimizando para nada atribuible por Whop.

**return\_on\_ad\_spend** `number` *required*

Valor de compra dividido entre el gasto, ambos en USD (una proporción independiente de la moneda); 0 cuando no hay gasto.

**schedule\_value** `number` *required*

Valor en USD atribuido a los eventos de agendamiento. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**schedules** `number` *required*

Eventos de agendamiento atribuidos por el píxel de Whop, último clic.

**spend** `number` *required*

El importe cobrado, en spend\_currency.

**spend\_currency** `string | null` *required*

El código de moneda ISO 4217 de todas las métricas monetarias.

**status** `string` *required*

Si el anuncio está habilitado. `active` y `paused` los estableces tú; `in_review` y `rejected` provienen de la revisión de anuncios.

Opciones disponibles: `active`, `paused`, `in_review`, `rejected`

**submitted\_application\_value** `number` *required*

Valor en USD atribuido a los eventos de envío de solicitud. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**submitted\_applications** `number` *required*

Eventos de envío de solicitud atribuidos por el píxel de Whop, último clic.

**title** `string | null` *required*

Título visible del anuncio.

**unique\_click\_through\_rate** `number | null` *required*

Clics únicos divididos entre impresiones, entre 0 y 1.

**unique\_clicks** `number` *required*

Personas que hicieron clic, informadas por el píxel de Whop, contadas una vez por persona.

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

Cuándo se actualizó el anuncio por última vez, como marca de tiempo ISO 8601.

**url** `string | null` *required*

La URL a la que enlaza el anuncio, sin su cadena de consulta. Los parámetros van en `url_parameters`; cualquiera que envíes en `url` se mueve allí.

**url\_parameters** `object` *required*

Parámetros de consulta añadidos a `url`, indexados por nombre. Los parámetros de atribución de clics de Whop están reservados.

**viewed\_content\_value** `number` *required*

Valor en USD atribuido a los eventos de visualización de contenido. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**viewed\_contents** `number` *required*

Eventos de visualización de contenido atribuidos por el píxel de Whop, último clic.

```json Ad theme={null}
{
	"id": "ad_xxxxxxxxxxxxx",
	"ad_campaign": {
		"id": "adcamp_xxxxxxxxxx"
	},
	"ad_group": {
		"id": "adgrp_xxxxxxxxxxx"
	},
	"added_to_cart_value": 540,
	"added_to_carts": 18,
	"call_to_action": "shop_now",
	"click_through_rate": 0.034,
	"clicks": 420,
	"completed_registration_value": 0,
	"completed_registrations": 12,
	"contact_value": 0,
	"contacts": 8,
	"content_review": {
		"status": "reviewed",
		"networks": [
			{
				"title": "whop",
				"recommended": true
			},
			{
				"title": "meta",
				"recommended": true
			},
			{
				"title": "tiktok",
				"recommended": false
			},
			{
				"title": "google",
				"recommended": true
			}
		],
		"tags": [
			{
				"title": "Unrealistic earnings or investment claims",
				"message": "The ad promises viewers they will make $10,000 a month."
			}
		]
	},
	"cost_per_added_to_cart": 7.22,
	"cost_per_click": 0.31,
	"cost_per_completed_registration": 10.83,
	"cost_per_contact": 16.25,
	"cost_per_lead": 9.29,
	"cost_per_mille": 14.5,
	"cost_per_purchase": 21.67,
	"cost_per_result": 21.67,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.37,
	"cost_per_viewed_content": 0.54,
	"created_at": "2026-06-01T12:00:00Z",
	"creatives": [
		{
			"id": "file_xxxxxxxxxxxx",
			"crop": {
				"height": 1080,
				"width": 1080,
				"x": 120,
				"y": 0
			},
			"format": "square",
			"media_type": "image",
			"url": "https://img.whop.com/file_xxxxxxxxxxxx.jpg",
			"language": null
		}
	],
	"custom_conversions": 4,
	"custom_event_counts": {
		"QualifiedCall": 3,
		"BookedDemo": 1
	},
	"custom_event_values": {
		"QualifiedCall": 1500,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"descriptions": [
		{
			"language": null,
			"text": "Limited spots available this week."
		}
	],
	"frequency": 1.8,
	"headlines": [
		{
			"language": null,
			"text": "Join Pickaxe Pro"
		}
	],
	"impressions": 9000,
	"issues": [
		{
			"id": "adiss_xxxxxxxxxxx",
			"category": "error",
			"title": "Ad issue",
			"message": "The ad's creative violates the ad network's policies. Edit the creative and resubmit for review.",
			"resource_id": "ad_xxxxxxxxxxxxx",
			"resource_type": "ad"
		}
	],
	"lead_value": 700,
	"leads": 14,
	"link_clicks": 336,
	"primary_texts": [
		{
			"language": null,
			"text": "Build sharper trading habits with daily lessons."
		}
	],
	"purchase_value": 1820,
	"purchases": 6,
	"reach": 5000,
	"result_event": "purchase",
	"result_event_name": null,
	"results": 6,
	"return_on_ad_spend": 14,
	"schedule_value": 0,
	"schedules": 0,
	"spend": 130,
	"spend_currency": "usd",
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"title": "Pickaxe Pro launch ad",
	"unique_click_through_rate": 0.028,
	"unique_clicks": 350,
	"updated_at": "2026-06-02T12:00:00Z",
	"url": "https://whop.com/pickaxe",
	"url_parameters": {
		"utm_campaign": "pickaxe-launch"
	},
	"viewed_content_value": 0,
	"viewed_contents": 240
}
```


## Related topics

- [Descripción general de la API de Ads](https://docs.whop.com/es/api-reference/ads/overview.md)
- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
- [Estabilidad de la API](https://docs.whop.com/es/api-reference/stability.md)
