# WaveInflu E-posta Araması

**API:** Data API

**Endpoint:** `POST /v1/beta/waveinflu/email-lookup`

**Tags:** Creator Data

Bir içerik üretici profilinin iletişim bilgilerini arar. profile_url gönderin. Yanıt requestId, billingRequestId ve platform, profile_url ile status ve value içeren bir email nesnesi barındıran data içerir. Değeri null olan not_found e-postası geçerli bir arama sonucudur. billingRequestId bir sağlayıcı referansıdır, Felo faturalandırma makbuzu değildir.

### Fiyatlandırma referansı

- Ölçümlendirme: plan kaynak birimleri.
- Referans istek tahmini: USD 0.001991.
- Birim maliyet esası: USD 0.001991.
- Kaynak birimi: `email_lookup_point`.
- Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.
- Maliyet esasları, sıfır olduğunda dahi nihai müşteri fiyatını belirlemez.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "profile_url": {
      "type": "string"
    }
  }
}
```

Example:

```json
{
  "profile_url": "https://www.youtube.com/@example-creator"
}
```

## Responses

### 200 — E-posta araması tamamlandı

Headers:
- `X-Request-Id` (string) — Felo desteğiyle iletişime geçerken belirtilecek istek tanımlayıcısı.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "Destek ve izleme için istek kimliği.",
      "example": "req-b6a"
    },
    "billingRequestId": {
      "type": "string",
      "description": "Sağlayıcı faturalandırma referansı, Felo fatura makbuzu değil.",
      "example": "7c12fbeb-1f42-4ca0-88f0-353b72ee03f2"
    },
    "data": {
      "$ref": "#/components/schemas/ResponseEb32A34A5274_EmailLookupData"
    }
  }
}
```

Example:

```json
{
  "requestId": "example-request",
  "billingRequestId": "example-provider-billing",
  "data": {
    "platform": "youtube",
    "profile_url": "https://www.youtube.com/@example-creator",
    "email": {
      "status": "not_found",
      "value": null
    }
  }
}
```

### 400 — İstek işlenemedi. İstek parametrelerini kontrol edin.

### 401 — Geçerli bir Felo API anahtarı gerekir.

### 402 — Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

### 403 — Hesabın bu işlemi gerçekleştirme izni yok.

### 429 — İstek veya harcama sınırına ulaşıldı.

### 502 — Hizmet isteği tamamlayamadı.

### 503 — API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

### 504 — İstek işlenirken hizmet zaman aşımına uğradı.

### default — Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseEb32A34A5274_EmailLookupData

`#/components/schemas/ResponseEb32A34A5274_EmailLookupData`

```json
{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "description": "Profil URL'sinden ayrıştırılan platform: instagram, tiktok veya youtube.",
      "example": "instagram"
    },
    "profile_url": {
      "type": "string",
      "description": "Bu aramada kullanılan normalleştirilmiş içerik üretici profil URL'si.",
      "example": "https://www.youtube.com/@example-creator"
    },
    "email": {
      "$ref": "#/components/schemas/ResponseEb32A34A5274_EmailResult"
    }
  }
}
```

### ResponseEb32A34A5274_EmailResult

`#/components/schemas/ResponseEb32A34A5274_EmailResult`

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Arama sonucu: adres çözümlendiğinde `found`, aksi halde bulunamadı durumu. Bulunamadı sonucu normaldir ve yine tek bir geçerli arama olarak faturalandırılır.",
      "example": "found"
    },
    "value": {
      "type": [
        "string",
        "null"
      ],
      "description": "Birincil iletişim e-postası veya hiçbiri bulunamadığında null.",
      "example": "example@example.invalid"
    }
  }
}
```
