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

# Ekonomik Zekâ API'si

> Ekonomik Zekâ, Whop'un bir hesap için öneri motorudur.

Her öneri tek bir eylemdir: sahibin gördüğü bir başlık, Whop AI'ın yürüttüğü adım adım bir özet ve beklediği sonuç. Whop bunları hesabın satışlarından, sitesinden, reklamlarından ve sahibinin söylediklerinden oluşturur.

Ekonomik Zekâ API'sini bir hesabın önerilerini listelemek, belirli bir hedef için yeni öneriler istemek ve her birini `queued` durumundan `ready` durumuna, ardından sahibi çalıştırdığında `executed` durumuna veya daha yeni bir öneri yerini aldığında ya da siz kullanımdan kaldırdığınızda `superseded` durumuna kadar takip etmek için kullanın.

Hesap tercihlerinden `economic_intelligence_offers` değerini okuyun ve bunu açmak için anahtarlarından birini `economic_intelligence_duration_key` olarak gönderin.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Ekonomik Zekâyı Listele](https://docs.whop.com/tr/api-reference/economic-intelligence/list-economic-intelligence.md) | GET `/economic_intelligence` |
| [Öneriyi Güncelle](https://docs.whop.com/tr/api-reference/economic-intelligence/update-recommendation.md) | PATCH `/economic_intelligence/{id}` |

## Öznitelikler

**id** `string` *required*

`reca_` önekli öneri kimliği veya kaydedilmemiş bir kurulum önerisi için `create_business`. Kaydedilmemiş bir öneriyi çalıştırmadan önce kimlik doğrulaması yapın ve yeniden listeleyin.

**account\_id** `string | null` *required*

Bu önerinin ait olduğu hesabın `biz_` önekli kimliği veya kişisel ilk kurulum için null.

**acknowledged\_at** `string | null` *required*

Çalıştırılan işlemin ilk kez görüldü olarak işaretlendiği zaman, ISO 8601 zaman damgası olarak veya işaretlenmediyse `null`.

**action\_type** `string | null` *required*

Önerilen eylem türü veya bir tür atanmadıysa `null`. Yeni değerler eklenebilir; bilinmeyen türleri sorunsuz şekilde ele alın.

**ai\_chat\_id** `string | null` *required*

Öneriyi çalıştıran sohbet; yalnızca onu çalıştıran kullanıcıya gösterilir, aksi halde `null`.

**created\_at** `string | null` *required*

Önerinin oluşturulduğu zaman, ISO 8601 zaman damgası olarak veya kaydedilmemiş bir öneri için null.

**executed\_at** `string | null` *required*

Önerinin yürütüldüğü zaman, ISO 8601 zaman damgası olarak veya yürütülmediyse `null`.

**expected\_tool\_calls** `object[] | null` *required*

Yürütme sırasına göre beklenen API işlemleri veya araçlar ya da hiçbir yürütme planı kaydedilmediyse null.

> [accordion] Özellikler
>
> **description** `string | null` *required*
>
> İşlemin ve etkilenen kaynağın kısa açıklaması veya eski öneriler için null.
>
> **tool\_name** `string` *required*
>
> API işlemi veya asistan aracı adı.

**input** `string | null` *required*

Kendi ifadenizle ne istediğiniz veya sizin girdiniz olmadan oluşturulan öneriler için `null`.

**inputs** `object[]` *required*

Bu önerinin size bıraktığı kararlar. Çalışmadan önce her biri için bir seçenek belirleyin veya bir `whop_ai` önerisi için kendinizinkini yazın; karar verilecek bir şey yoksa boştur.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Yanıtladığınızda girdiyi tanımlar.
>
> **answer** `string | null` *required*
>
> Çalıştırmanın kullandığı değer: seçeneklerden biri veya bir `whop_ai` önerisi için kendi metniniz. Bir çalıştırma başlayana kadar `null`.
>
> **label** `string` *required*
>
> Neyi seçtiğiniz, örneğin günlük reklam bütçesi.
>
> **options** `string[]` *required*
>
> En güçlüden başlayarak önerilen üç değer. Bunlardan biriyle veya bir `whop_ai` önerisi için kendi metninizle yanıt verebilirsiniz.
>
> **template** `string` *required*
>
> Seçilen yanıtla doldurulacak bir \{answer} boşluğu içeren bir plan cümlesi.

**prompt** `string | null` *required*

Whop AI için adım adım talimatlar veya talimat yoksa `null`.

**reasoning** `string | null` *required*

Öneriyi destekleyen kanıtlar ve metrikler veya gerekçe sağlanmadıysa `null`.

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

Çalıştırmanın ürettiği sonucun görüntüleneceği yer, örneğin yayınlanan web sitesi veya oluşturulan ürün, ya da sonuç yalnızca sohbetteyse `null`.

**run\_by\_user\_id** `string | null` *required*

Çalıştırmayı başlatan `user_` önekli kullanıcı veya çalıştırılmadıysa ya da bir kullanıcı olmadan (örneğin bir API anahtarıyla) başlatıldıysa `null`.

**run\_ended\_at** `string | null` *required*

Çalıştırmanın sona erdiği zaman (yürütülmüş veya tamamlanmamış olsun), ISO 8601 zaman damgası olarak veya sona ermediyse `null`.

**run\_started\_at** `string | null` *required*

Çalıştırmanın Whop AI veya önerinin API çağrıları tarafından başlatıldığı zaman, ISO 8601 zaman damgası olarak veya çalıştırılmadıysa `null`.

**sentiment** `string | null` *required*

Kullanıcının bu öneriyi nasıl derecelendirdiği veya derecelendirmediyse `null`

Kullanılabilir seçenekler: `positive`, `negative`

**status** `string` *required*

Oluşturulmayı beklerken `queued`; oluşturulurken veya işi hazırlanırken `pending`; çalıştırılmaya hazır olduğunda `ready`; Whop AI veya önerinin API çağrıları onu yürütürken `running`; yürütüldüğünde `executed`; çalıştırma onu yürütmeden sona erdiğinde `incomplete`; reddedildiğinde veya yerine başkası geldiğinde `superseded`.

Kullanılabilir seçenekler: `queued`, `pending`, `ready`, `running`, `executed`, `incomplete`, `superseded`

**superseded\_at** `string | null` *required*

Önerinin reddedildiği veya yerine başkasının geldiği zaman, ISO 8601 zaman damgası olarak veya ikisi de gerçekleşmediyse `null`.

**target\_url** `string | null`

Piksel kurulumu için seçilen web sitesi URL'si veya bu öneri için web sitesi kaydedilmediyse `null`.

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

Önerilen eylem ve beklenen faydası veya oluşturulana kadar `null`.

**user\_feedback** `string | null` *required*

Kullanıcının yazılı geri bildirimi veya herhangi bir geri bildirim sağlamadıysa `null`.

```json EconomicIntelligence theme={null}
{
	"id": "reca_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"status": "executed",
	"action_type": "cut_losing_ad_spend",
	"title": "Move $180 from 3 dead ad groups into BATCH#3, +1.7x return",
	"reasoning": "Three ad groups spent $180 over 14 days with no purchases, while BATCH#3 returned 2.4x on the same audience.",
	"prompt": "Pause the three ad groups with no purchases in the last 14 days and add their combined daily budget to BATCH#3.",
	"input": "more sales from ads",
	"inputs": [
		{
			"id": "audience",
			"label": "Guide audience",
			"options": ["Daily drivers", "Show cars"],
			"template": "Guide audience: {answer}",
			"answer": "Daily drivers"
		}
	],
	"expected_tool_calls": [
		{
			"tool_name": "updateAdCampaign",
			"description": "Increase the BATCH#3 campaign budget"
		}
	],
	"target_url": null,
	"result_url": null,
	"ai_chat_id": "aich_xxxxxxxxxxxxxx",
	"run_by_user_id": "user_xxxxxxxxxxxxxx",
	"created_at": "2026-09-14T09:00:00.000Z",
	"run_started_at": "2026-09-14T15:02:11.000Z",
	"run_ended_at": "2026-09-14T15:04:37.000Z",
	"executed_at": "2026-09-14T15:04:37.000Z",
	"acknowledged_at": "2026-09-14T15:10:02.000Z",
	"superseded_at": null,
	"sentiment": "positive",
	"user_feedback": null
}
```


## Related topics

- [Yapay Zekâ ve MCP](https://docs.whop.com/tr/developer/guides/ai_and_mcp.md)
- [Deneyler API'si](https://docs.whop.com/tr/api-reference/experiments/experiment.md)
- [Kartlar API'si](https://docs.whop.com/tr/api-reference/cards/card.md)
