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

# Ads API

> Ad, bir reklam grubu tarafından yayınlanan bağımsız kreatif birimdir. Bir reklamın metnini, kreatif varlıklarını ve hedef URL'sini içerir.

Ad, bir [reklam grubu](https://docs.whop.com/tr/api-reference/ad-groups/ad-group) tarafından yayınlanan bağımsız kreatif birimdir. Bir reklamın metnini, kreatif varlıklarını ve hedef URL'sini içerir.

Bir hesabın reklamlarını listelemek, reklam grupları içinde reklam oluşturmak, kreatif ayrıntılarını almak veya güncellemek, çalışmayı durdurması gereken reklamları silmek ve yayını duraklatmak ya da sürdürmek için Ads API'yi kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [List Ads](https://docs.whop.com/tr/api-reference/ads/list-ads.md) | GET `/ads` |
| [Retrieve an Ad](https://docs.whop.com/tr/api-reference/ads/retrieve-an-ad.md) | GET `/ads/{id}` |
| [Create an Ad](https://docs.whop.com/tr/api-reference/ads/create-an-ad.md) | POST `/ads` |
| [Duplicate an Ad](https://docs.whop.com/tr/api-reference/ads/duplicate-an-ad.md) | POST `/ads/{id}/duplicate` |
| [Pause an Ad](https://docs.whop.com/tr/api-reference/ads/pause-an-ad.md) | POST `/ads/{id}/pause` |
| [Unpause an Ad](https://docs.whop.com/tr/api-reference/ads/unpause-an-ad.md) | POST `/ads/{id}/unpause` |
| [Update an Ad](https://docs.whop.com/tr/api-reference/ads/update-an-ad.md) | PATCH `/ads/{id}` |
| [Delete an Ad](https://docs.whop.com/tr/api-reference/ads/delete-an-ad.md) | DELETE `/ads/{id}` |

## Özellikler

**id** `string` *required*

Reklamın `ad_` önekli benzersiz tanımlayıcısı.

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

Bu reklamın ait olduğu reklam kampanyası.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Başvurulan varlığın kimliği.

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

Bu reklamın ait olduğu reklam grubu.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Başvurulan varlığın kimliği.

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

Sepete ekleme olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

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

Whop pikseli tarafından atfedilen sepete ekleme olayları, son tıklama.

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

Reklamda gösterilen harekete geçirici mesaj düğmesi.

Kullanılabilir seçenekler: `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*

Tıklamaların gösterimlere bölümü, 0 ile 1 arasında.

**clicks** `number` *required*

Tıklama sayısı.

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

Kayıt tamamlama olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

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

Whop pikseli tarafından atfedilen kayıt tamamlama olayları, son tıklama.

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

İletişim olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**contacts** `number` *required*

Whop pikseli tarafından atfedilen iletişim olayları, son tıklama.

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

Whop'un bu reklama yönelik içerik incelemesi: tamamlanıp tamamlanmadığı, hangi reklam ağları için önerildiği ve ihlal ettiği içerik kuralları.

> [accordion] Özellikler
>
> **networks** `object[]` *required*
>
> Her ağın reklamı yayınlayıp yayınlayamayacağı. İnceleme tamamlanana kadar boştur.
>
> > [accordion] Özellikler
> >
> > **recommended** `boolean` *required*
> >
> > Reklamın Whop'un içerik politikasını ve bu ağın politikasını karşılayıp karşılamadığı.
> >
> > **title** `string` *required*
> >
> > Ağ. `whop`, Whop'un kendi içerik politikasıdır ve diğer her ağ da bunu gerektirir.
> >
> > Kullanılabilir seçenekler: `whop`, `meta`, `tiktok`, `google`
>
> **status** `string` *required*
>
> Whop içerik incelemesi tamamlandığında `reviewed`, çalışırken `in_review`, hiç çalışmadığında `not_reviewed`.
>
> Kullanılabilir seçenekler: `reviewed`, `in_review`, `not_reviewed`
>
> **tags** `object[]` *required*
>
> İncelemenin, herhangi bir ağda, reklamın ihlal ettiğini tespit ettiği her kural. Hiçbirini ihlal etmediğinde veya inceleme tamamlanmadığında boştur.
>
> > [accordion] Özellikler
> >
> > **message** `string` *required*
> >
> > İncelemenin bu kural için kaydettiği kanıt.
> >
> > **title** `string` *required*
> >
> > Whop içerik incelemesinin reklamın ihlal ettiğini tespit ettiği kural.

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

Harcamanın atfedilen sepete ekleme olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.

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

Harcamanın tıklamalara bölümü; tıklama yoksa 0.

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

Harcamanın atfedilen kayıt tamamlama olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.

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

Harcamanın atfedilen iletişim olaylarına bölümü; hedef iletişimler değilse ve hiçbiri atfedilmemişse null.

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

Harcamanın atfedilen potansiyel müşterilere bölümü; potansiyel müşteriler bir hedef değilse ve hiçbiri atfedilmemişse null.

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

1.000 gösterim başına harcama; gösterim yoksa 0.

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

Harcamanın atfedilen satın almalara bölümü; satın almalar bir hedef değilse ve hiçbiri atfedilmemişse null.

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

Harcamanın Whop pikseli tarafından atfedilen sonuçlara bölümü; Whop tarafından atfedilebilen hiçbir şey için optimizasyon yapılmıyorsa null.

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

Harcamanın atfedilen randevu olaylarına bölümü; hedef randevular değilse ve hiçbiri atfedilmemişse null.

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

Harcamanın atfedilen başvuru gönderme olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.

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

Harcamanın benzersiz tıklamalara bölümü; benzersiz tıklama yoksa null.

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

Harcamanın atfedilen içerik görüntüleme olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.

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

Reklamın oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

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

Bu reklamın kullandığı kreatif varlıklar. Orijinal varlığın biçimi null'dır; kare, dikey ve yatay girişler yerleşime özgü varyantlardır. Bir döngü (carousel) reklamı, her ek için sırayla biçimi null olan bir giriş döndürür.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Kreatif ekin dosya kimliği.
>
> **crop** `object | null` *required*
>
> Bu kreatif için kaydedilmiş kırpma penceresi, kaynak görsel pikselleri cinsinden. Orijinal varlık veya kırpılmamış bir biçim için null.
>
> > [accordion] Özellikler
> >
> > **height** `number` *required*
> >
> > Kırpma penceresinin kaynak piksel cinsinden yüksekliği.
> >
> > **width** `number` *required*
> >
> > Kırpma penceresinin kaynak piksel cinsinden genişliği.
> >
> > **x** `number` *required*
> >
> > Kırpma penceresinin kaynak piksel cinsinden sol kenarı.
> >
> > **y** `number` *required*
> >
> > Kırpma penceresinin kaynak piksel cinsinden üst kenarı.
>
> **format** `string | null` *required*
>
> Bu varlığın kapsadığı yerleşim varyantı veya orijinal varlık için null.
>
> Kullanılabilir seçenekler: `square`, `vertical`, `horizontal`
>
> **language** `string | null` *required*
>
> Her zaman `null`. Çeviriler artık kullanılamıyor.
>
> **media\_type** `string | null` *required*
>
> Varlığın türü: görsel veya video.
>
> **url** `string | null` *required*
>
> Varlığın CDN URL'si.

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

Tüm özel olay adları genelinde, Whop pikseli tarafından atfedilen özel (satıcı tanımlı) dönüşüm olayları, son tıklama.

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

Olay adınıza göre anahtarlanmış ve değer olarak son tıklama sayısını içeren, Whop pikseli tarafından atfedilen özel dönüşümler. Adlandırılmış özel olay atfedilmemişse boştur. Ad olmadan tetiklenen özel olaylar custom\_conversions içinde sayılır ancak burada yer almaz; bu nedenle bu değerlerin toplamı en fazla custom\_conversions kadardır.

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

Her özel olaya atfedilen dönüşüm değeri; custom\_event\_counts gibi olay adına göre anahtarlanır. whop.track'e iletilen değeri USD'ye normalleştirerek toplar; değer olmadan tetiklenen olaylar 0 katkıda bulunur.

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

Reklamın şu anda yayında olup olmadığı ve değilse nedeni. Aynı anda birden fazla durum geçerli olduğunda en yüksek önceliğe sahip olan döndürülür.

Kullanılabilir seçenekler: `rejected`, `in_review`, `draft`, `campaign_paused`, `paused`, `processing`, `revise_content`, `issues`, `scheduled`, `learning`, `active`

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

Reklamda gösterilen açıklama.

> [accordion] Özellikler
>
> **language** `string | null` *required*
>
> Her zaman `null`. Çeviriler artık kullanılamıyor.
>
> **text** `string` *required*
>
> İzleyicilere gösterilen metin.

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

Gösterimlerin erişime bölümü.

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

Reklamda gösterilen başlık.

> [accordion] Özellikler
>
> **language** `string | null` *required*
>
> Her zaman `null`. Çeviriler artık kullanılamıyor.
>
> **text** `string` *required*
>
> İzleyicilere gösterilen metin.

**impressions** `number` *required*

Gösterim sayısı.

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

Bu reklamı etkileyen açık sorunlar. Hiç yoksa boştur.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Sorunun benzersiz tanımlayıcısı.
>
> **category** `string` *required*
>
> Sorunun türü: yayınla ilgili bilgi, bir uyarı veya ilgilenilmesi gereken bir hata.
>
> Kullanılabilir seçenekler: `information`, `warning`, `error`
>
> **message** `string` *required*
>
> Sorunun ne olduğunu ve nasıl çözülebileceğini anlatan bir açıklama.
>
> **resource\_id** `string | null` *required*
>
> Sorunun bağlı olduğu kampanyanın, reklam grubunun veya reklamın kimliği.
>
> **resource\_type** `string` *required*
>
> Sorunun bağlı olduğu kaynağın türü.
>
> Kullanılabilir seçenekler: `ad_campaign`, `ad_group`, `ad`
>
> **title** `string` *required*
>
> Sorun için içerik üreticiye yönelik kısa bir başlık: içerik incelemesi reddinin belirttiği kural veya genel bir etiket.

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

Potansiyel müşteri olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**leads** `number` *required*

Whop pikseli tarafından atfedilen potansiyel müşteriler, son tıklama.

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

Reklama tıklayan kişilerden hedef sayfanızda gelen ve Whop pikseli tarafından kaydedilen sayfa görüntülemeleri. Her reklam platformunda aynı şekilde sayılır.

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

Reklam gövdesinde gösterilen birincil metin. Birden fazla giriş metin varyasyonları oluşturur.

> [accordion] Özellikler
>
> **language** `string | null` *required*
>
> Her zaman `null`. Çeviriler artık kullanılamıyor.
>
> **text** `string` *required*
>
> İzleyicilere gösterilen metin.

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

Piksel tarafından atfedilen satın almaların USD değeri.

**purchases** `number` *required*

Whop pikseli tarafından atfedilen satın almalar, son tıklama.

**reach** `number` *required*

Bunu gören benzersiz kişi sayısı.

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

Atfedilen sayısı sonuçları temsil eden Whop pikseli dönüşüm olayı: optimizasyon hedefi veya reklam grubu başına bütçe belirleyen kampanyalar için en yüksek hacimli atfedilen olay. Hedef Whop tarafından atfedilen bir olay değilse null.

Kullanılabilir seçenekler: `purchase`, `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `custom`, `messaging_conversation`

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

result\_event custom olduğunda satıcı tanımlı olay adı; standart olaylar için null.

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

result\_event'in arkasındaki, Whop pikseli tarafından atfedilen sayı. Bir kampanyanın reklam grupları farklı hedefleri optimize ettiğinde tek bir result\_event yoktur (null'dır) ve bu değer bunun yerine her reklam grubunun kendi atfedilen sonuçlarının toplamıdır. Whop tarafından atfedilebilen hiçbir şey için optimizasyon yapılmıyorsa null.

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

Satın alma değerinin harcamaya bölümü; ikisi de USD cinsinden (para biriminden bağımsız bir oran); harcama yoksa 0.

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

Randevu olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**schedules** `number` *required*

Whop pikseli tarafından atfedilen randevu olayları, son tıklama.

**spend** `number` *required*

spend\_currency cinsinden tahsil edilen tutar.

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

Tüm parasal metriklerin ISO 4217 para birimi kodu.

**status** `string` *required*

Reklamın etkin olup olmadığı. `active` ve `paused` sizin tarafınızdan ayarlanır; `in_review` ve `rejected` reklam incelemesinden gelir.

Kullanılabilir seçenekler: `active`, `paused`, `in_review`, `rejected`

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

Başvuru gönderme olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

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

Whop pikseli tarafından atfedilen başvuru gönderme olayları, son tıklama.

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

Reklamın görünen başlığı.

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

Benzersiz tıklamaların gösterimlere bölümü, 0 ile 1 arasında.

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

Whop pikseli tarafından bildirilen, kişi başına bir kez sayılan tıklayan kişiler.

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

Reklamın en son güncellendiği zaman, ISO 8601 zaman damgası olarak.

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

Reklamın bağlantı verdiği, sorgu dizesi olmadan URL. Parametreler `url_parameters` içinde yer alır; `url` üzerinde gönderdikleriniz oraya taşınır.

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

Ada göre anahtarlanmış, `url`'ye eklenen sorgu parametreleri. Whop'un tıklama atfetme parametreleri ayrılmıştır.

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

İçerik görüntüleme olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

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

Whop pikseli tarafından atfedilen içerik görüntüleme olayları, son tıklama.

```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

- [Ads API Genel Bakış](https://docs.whop.com/tr/api-reference/ads/overview.md)
- [Reklamlar](https://docs.whop.com/tr/api-reference/legacy/ads/ad.md)
- [Whop Ads ile reklam verin](https://docs.whop.com/tr/developer/ads/overview.md)
