# Tavily Araması

**API:** Data API

**Endpoint:** `POST /v1/beta/tavily/search`

**Tags:** Web Search

Web'de arama yapar ve başlıklar, URL'ler ve içerik parçacıkları içeren sıralanmış sonuçlar döndürür. query zorunludur. Sonuç sayısını kontrol etmek için max_results, arama modunu seçmek için search_depth kullanın. Ek answer, images ve ham içerik yalnızca istendiğinde döndürülür. Kaynak kullanım bilgilerini almak için include_usage değerini ayarlayın; usage.credits bir Felo ücreti değildir.

### Fiyatlandırma referansı

- Ölçümlendirme: ölçümlendirilen yanıt birimleri.
- Referans istek tahmini: USD 0.016.
- Birim maliyet esası: USD 0.008.
- Kaynak birimi: `tavily_credit`.
- 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": {
    "query": {
      "type": "string",
      "description": "Tavily ile yürütülecek arama sorgusu.",
      "example": "Who is Leo Messi?"
    },
    "search_depth": {
      "type": "string",
      "enum": [
        "advanced",
        "basic",
        "fast",
        "ultra-fast"
      ],
      "default": "basic",
      "description": "Gecikme ile alaka düzeyi arasındaki dengeyi kontrol eder. advanced, daha yüksek gecikme ve maliyetle en yüksek alaka düzeyini sunar; basic dengelidir; fast ve ultra-fast daha düşük gecikme için optimize eder."
    },
    "chunks_per_source": {
      "type": "integer",
      "default": 3,
      "description": "Kaynak başına döndürülen maksimum ilgili parça sayısı.",
      "minimum": 1,
      "maximum": 3
    },
    "max_results": {
      "type": "integer",
      "default": 5,
      "description": "Döndürülecek maksimum arama sonucu sayısı.",
      "minimum": 0,
      "maximum": 20
    },
    "topic": {
      "type": "string",
      "enum": [
        "general",
        "news",
        "finance"
      ],
      "default": "general",
      "description": "Aramanın kategorisi."
    },
    "time_range": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month",
        "year",
        "d",
        "w",
        "m",
        "y"
      ],
      "description": "Sonuçları yayın tarihine göre filtrelemek için zaman aralığı."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "Belirtilen başlangıç tarihinden sonraki sonuçları döndürün.",
      "example": "2025-02-09"
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "Belirtilen bitiş tarihinden önceki sonuçları döndürün.",
      "example": "2025-12-29"
    },
    "include_answer": {
      "oneOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "enum": [
            "basic",
            "advanced"
          ]
        }
      ],
      "default": false,
      "description": "LLM tarafından oluşturulan bir yanıt ekleyin. true varsayılan yanıt modunu kullanır; basic veya advanced yanıt oluşturma modunu seçer."
    },
    "include_raw_content": {
      "oneOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "enum": [
            "markdown",
            "text"
          ]
        }
      ],
      "default": false,
      "description": "Her arama sonucu için temizlenmiş ve ayrıştırılmış içerik ekleyin. true veya markdown markdown döndürür; text düz metin döndürür ve gecikmeyi artırabilir."
    },
    "include_images": {
      "type": "boolean",
      "default": false,
      "description": "Görsel araması yapın ve sonuçları dahil edin."
    },
    "include_image_descriptions": {
      "type": "boolean",
      "default": false,
      "description": "include_images true olduğunda her görsel için açıklayıcı metin ekleyin."
    },
    "safe_search": {
      "type": "boolean",
      "default": false,
      "description": "Yetişkinlere yönelik veya güvenli olmayan içerikleri arama sonuçlarından filtreleyin. Yalnızca Enterprise; search_depth fast veya ultra-fast olduğunda desteklenmez."
    },
    "include_favicon": {
      "type": "boolean",
      "default": false,
      "description": "Her sonuç için favicon URL'sini ekleyin."
    },
    "include_domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Arama sonuçlarına özellikle dahil edilecek alan adları listesi.",
      "maxItems": 300
    },
    "exclude_domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Arama sonuçlarından özellikle hariç tutulacak alan adları listesi.",
      "maxItems": 150
    },
    "country": {
      "type": "string",
      "description": "Belirli bir ülkeden gelen arama sonuçlarını öne çıkarın. Yalnızca topic general olduğunda kullanılabilir.",
      "enum": [
        "afghanistan",
        "albania",
        "algeria",
        "andorra",
        "angola",
        "argentina",
        "armenia",
        "australia",
        "austria",
        "azerbaijan",
        "bahamas",
        "bahrain",
        "bangladesh",
        "barbados",
        "belarus",
        "belgium",
        "belize",
        "benin",
        "bhutan",
        "bolivia",
        "bosnia and herzegovina",
        "botswana",
        "brazil",
        "brunei",
        "bulgaria",
        "burkina faso",
        "burundi",
        "cambodia",
        "cameroon",
        "canada",
        "cape verde",
        "central african republic",
        "chad",
        "chile",
        "china",
        "colombia",
        "comoros",
        "congo",
        "costa rica",
        "croatia",
        "cuba",
        "cyprus",
        "czech republic",
        "denmark",
        "djibouti",
        "dominican republic",
        "ecuador",
        "egypt",
        "el salvador",
        "equatorial guinea",
        "eritrea",
        "estonia",
        "ethiopia",
        "fiji",
        "finland",
        "france",
        "gabon",
        "gambia",
        "georgia",
        "germany",
        "ghana",
        "greece",
        "guatemala",
        "guinea",
        "haiti",
        "honduras",
        "hungary",
        "iceland",
        "india",
        "indonesia",
        "iran",
        "iraq",
        "ireland",
        "israel",
        "italy",
        "jamaica",
        "japan",
        "jordan",
        "kazakhstan",
        "kenya",
        "kuwait",
        "kyrgyzstan",
        "latvia",
        "lebanon",
        "lesotho",
        "liberia",
        "libya",
        "liechtenstein",
        "lithuania",
        "luxembourg",
        "madagascar",
        "malawi",
        "malaysia",
        "maldives",
        "mali",
        "malta",
        "mauritania",
        "mauritius",
        "mexico",
        "moldova",
        "monaco",
        "mongolia",
        "montenegro",
        "morocco",
        "mozambique",
        "myanmar",
        "namibia",
        "nepal",
        "netherlands",
        "new zealand",
        "nicaragua",
        "niger",
        "nigeria",
        "north korea",
        "north macedonia",
        "norway",
        "oman",
        "pakistan",
        "panama",
        "papua new guinea",
        "paraguay",
        "peru",
        "philippines",
        "poland",
        "portugal",
        "qatar",
        "romania",
        "russia",
        "rwanda",
        "saudi arabia",
        "senegal",
        "serbia",
        "singapore",
        "slovakia",
        "slovenia",
        "somalia",
        "south africa",
        "south korea",
        "south sudan",
        "spain",
        "sri lanka",
        "sudan",
        "sweden",
        "switzerland",
        "syria",
        "taiwan",
        "tajikistan",
        "tanzania",
        "thailand",
        "togo",
        "trinidad and tobago",
        "tunisia",
        "turkey",
        "turkmenistan",
        "uganda",
        "ukraine",
        "united arab emirates",
        "united kingdom",
        "united states",
        "uruguay",
        "uzbekistan",
        "venezuela",
        "vietnam",
        "yemen",
        "zambia",
        "zimbabwe"
      ]
    },
    "auto_parameters": {
      "type": "boolean",
      "default": false,
      "description": "Arama parametrelerini sorgu içeriğine göre otomatik olarak yapılandırın."
    },
    "include_usage": {
      "type": "boolean",
      "default": false,
      "description": "Yanıta kaynak kullanım bilgilerini dahil edin. Bu, Felo faturalandırma bilgisi değildir."
    }
  },
  "required": [
    "query"
  ]
}
```

Example:

```json
{
  "query": "Python official documentation",
  "search_depth": "basic",
  "max_results": 2,
  "include_usage": true
}
```

## Responses

### 200 — Arama sonuçları başarıyla döndürüldü.

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": {
    "query": {
      "type": "string",
      "description": "Yürütülen arama sorgusu."
    },
    "answer": {
      "type": [
        "string",
        "null"
      ],
      "description": "Kısa, LLM tarafından oluşturulan yanıt. include_answer false olduğunda veya yanıt oluşturulmadığında null olarak bulunur."
    },
    "images": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Görsel URL'si."
          },
          "description": {
            "type": "string",
            "description": "Görsel açıklaması."
          }
        }
      }
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "Arama sonucunun başlığı."
          },
          "url": {
            "type": "string",
            "description": "Arama sonucunun URL'si."
          },
          "content": {
            "type": "string",
            "description": "Arama sonucunun içerik parçası."
          },
          "score": {
            "type": "number",
            "format": "float",
            "description": "Arama sonucunun alaka puanı."
          },
          "favicon": {
            "type": [
              "string",
              "null"
            ],
            "description": "Arama sonucunun favicon URL'si."
          },
          "raw_content": {
            "type": [
              "string",
              "null"
            ],
            "description": "Temizlenmiş ve ayrıştırılmış kaynak içeriği. include_raw_content istenmediğinde veya ham içerik mevcut olmadığında null."
          }
        }
      }
    },
    "response_time": {
      "type": "number",
      "format": "float",
      "description": "İsteğin tamamlanmasının aldığı süre (saniye)."
    },
    "usage": {
      "type": "object",
      "properties": {
        "credits": {
          "type": "integer",
          "description": "Bu istek tarafından tüketilen kaynak birimleri; USD veya Felo kredisi değil."
        }
      }
    },
    "request_id": {
      "type": "string",
      "description": "Benzersiz istek tanımlayıcısı."
    }
  }
}
```

Example:

```json
{
  "query": "Python official documentation",
  "answer": null,
  "images": [],
  "results": [
    {
      "title": "Python Documentation",
      "url": "https://docs.python.org/3/",
      "content": "Documentation for the Python programming language.",
      "score": 0.98,
      "raw_content": null
    }
  ],
  "response_time": 1.2,
  "usage": {
    "credits": 1
  },
  "request_id": "example-search-request"
}
```

### 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
{}
```
