# Web search API hızlı başlangıç: ilk aramanız iki dakikada

> Web search API hızlı başlangıç: API anahtarı alın, ilk aramanızı curl veya Python ile çalıştırın ve en iyi sayfaları Markdown olarak okuyun. Kripto ile ödeme.

- URL: https://llmwebsearch.com/tr/docs/
- Son güncelleme: 2026-10-22
- Yayıncı: LLMWebSearch (https://llmwebsearch.com)

Tek bir endpoint tüm işi yapar: bir soruyu `/search` adresine gönderin, sıralanmış sonuçları geri alın; ilk sayfalar zaten okunmuş ve Markdown'a dönüştürülmüştür. Bu sayfa boş bir bakiyeden çalışan bir çağrıya götürür, ardından docs'un diğer tüm sayfalarına yönlendirir.

**Kısa yanıt — AI agent'lar için bir web search API ile ilk aramamı nasıl çalıştırırım?**

Sorunuzu API anahtarınızla Bearer token olarak `POST https://llmwebsearch.com/api/v1/search` adresine gönderin. **LLMWebSearch** canlı bir web araması yapar ve en fazla 20 sıralanmış sonuç döner; ilk 3 sayfa okunur ve Markdown olarak döner. Ekim 2026 itibarıyla $1,20/1K arama üzerinden tek kredi tüm bu çağrıyı karşılar. KYC olmadan; kripto ile ödeme.

## Tek kartta API

| Özellik | Değer |
| --- | --- |
| Base URL | `https://llmwebsearch.com/api/v1` |
| Ara | `POST` veya `GET https://llmwebsearch.com/api/v1/search` |
| Elinizdeki URL'leri okuyun | `POST https://llmwebsearch.com/api/v1/extract` |
| Kalan krediler | `GET https://llmwebsearch.com/api/v1/credits`, ücretsiz |
| Kimlik doğrulama | API anahtarınızı Authorization header'ında Bearer token olarak ya da api_key sorgu parametresi olarak iletin |
| Faturalama | Bir kredi bir aramayı karşılar: en fazla 20 sıralı sonuç, ilk 3'ün sayfaları okunur ve Markdown olarak döndürülür. 4 ile 10 arası sayfa okumak 2 kredi eder. Hata ile biten bir çağrı hiçbir ücrete tabi değildir |
| Sayfa okuyucumuz | `LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/)`, robots.txt token `LLMWebSearch` |
| En küçük paket | $9,25 için 5.000 arama; krediler süresiz geçerlidir |

## API anahtarını nasıl alırım?

Kayıt formu yok. En uzun kısım, bakiyenizin yüklenmesini blockchain'in onaylamasını beklemektir.

1. **Bakiyenizi kripto ile yükleyin** — BTC, USDT, USDC, ETH, SOL, LTC olarak en az $25 gönderin. Bir hesap numarasıyla giriş yapın; e-posta adresi isteğe bağlıdır.
2. **Bir arama paketi satın alın** — Aramayı tek bir agent'a bağlamak ve her seçeneği denemek için $9,25 için 5.000 arama fazlasıyla yeter.
3. **Anahtarı kopyalayın** — Kripto ile yaptığınız bakiye yüklemesi onaylandığında ve bir paket satın alındığında, API anahtarınız dashboard'da sizi bekliyor. LLMWEBSEARCH_API_KEY adlı bir ortam değişkeninde saklayın.

## İlk arama neye benziyor?

Küçük bir JSON gövdesiyle tek bir HTTPS POST isteğidir. Yalnızca `q` zorunludur: bir kişinin yazacağı gibi soru veya anahtar kelimeler. Varsayılanlar çoğu agent'a zaten uygundur. 5 sıralı sonuç alırsınız ve ilk 3 sonucun arkasındaki sayfalar okunup her biri en fazla 6.000 karakterlik Markdown olarak döndürülür.

Aşağıdaki üç snippet aynı aramayı gönderir. Yığınınıza uyanı seçin, kabuğunuzda `LLMWEBSEARCH_API_KEY` ayarlayın ve çalıştırın.

*curl: tek arama, ilk 3 sayfa okunur*

```bash
curl -s "https://llmwebsearch.com/api/v1/search" \
  -H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3}'
```

*Python: kaynakları ve boyutlarını listele*

```python
import os

import requests

resp = requests.post(
    "https://llmwebsearch.com/api/v1/search",
    headers={"Authorization": "Bearer " + os.environ["LLMWEBSEARCH_API_KEY"]},
    json={"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3},
    timeout=60,
)
resp.raise_for_status()
data = resp.json()
print("credits used:", data["credits_used"])
for r in data["results"]:
    size = r.get("word_count", 0)
    print(r["position"], r["title"], r["url"], r["content_status"], size, "words")

```

*Node.js 18+: okunan ilk sayfayı yazdır*

```javascript
const res = await fetch('https://llmwebsearch.com/api/v1/search', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.LLMWEBSEARCH_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ q: 'how to rotate api keys without downtime', max_results: 5, read: 3 }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
const first = data.results.find((r) => r.content_status === 'ok');
console.log(first ? `${first.title}\n${first.url}\n\n${first.content.slice(0, 600)}` : 'No page could be read.');

```

## Geri ne dönüyor?

`query`, çağrının `created_at` cinsinden zamanı, `credits_used` cinsinden fiyat ve sıralı düzende bir `results` dizisi içeren bir JSON nesnesi. Her sonuçta `position`, `title`, `url`, `host` ve `snippet`, tarih bilindiğinde ise ayrıca `published_at` bulunur.

İzlemeniz gereken alan `content_status`. `ok` dediğinde, sayfa okunmuştur ve ana içeriği bir `word_count` ile birlikte `content` içinde yer alır. `read` ötesindeki sonuçlar `not_requested` der. Okunamayan bir sayfa nedenini söyler, örneğin `blocked_by_robots`. [Yanıt formatı](https://llmwebsearch.com/tr/docs/response/) sayfası her alanı açıklar.

## En sık hangi parametreleri değiştireceğim?

Neredeyse her agent için altı parametre yeterlidir. Hepsi isteğe bağlıdır.

| Parametre | Neyi değiştirir |
|---|---|
| `max_results` | Kaç sıralı sonuç döneceği, 1 ile 20 arasında |
| `read` | İlk sonuçlardan kaçının okunacağı, 0 ile 10 arasında |
| `max_chars` | Her sayfanın içerik uzunluğu üst sınırı, 500 ile 50.000 karakter arasında |
| `topic` ve `time_range` | Web sayfaları yerine haberler ve bir güncellik aralığı |
| `include_domains` | Yalnızca listelediğiniz sitelerden sonuçlar |
| `country` ve `language` | Aramanın nerede ve hangi dilde çalışacağı |

[Arama referansı](https://llmwebsearch.com/tr/docs/search/) her birini bir örnekle, ayrıca `format` ve `exclude_domains` ile belgeler.

## Bir çağrı kaç kredi kullanır?

Çoğu çağrı bir kredi kullanır. Tam kural seti:

- **Arama, 0 ile 3 sayfa okuma: 1 kredi.** Buna en fazla 20 sıralı sonuç dahildir.
- **Arama, 4 ile 10 sayfa okuma: 2 kredi.**
- **Extract:** URL'sini zaten bildiğiniz sayfaları okumak, içerikle birlikte döndürülen her başlamış 3 sayfalık grup için 1 kredi eder, çağrı başına en fazla 20 URL; reddedilen veya başarısız olan URL'ler sayılmaz.
- **Hatalar: 0 kredi.** Hatalı bir parametre, yanlış bir anahtar, boş bir bakiye veya başarısız bir arama hiçbir ücrete tabi değildir.
- **Okunamayan bir sayfa**, başarılı bir arama içinde fiyatını değiştirmez.
- **Bakiyenizi kontrol etmek** `GET https://llmwebsearch.com/api/v1/credits` ile ücretsizdir.

Arama kredilerinin son kullanma tarihi yoktur: bu ay kullanmadığınız krediler gelecek yıl da orada durur.

## Bir site okunmak istemediğinde ne olur?

Sonuç yine de başlığı, URL'si ve snippet'i ile görünür, ancak sayfa içeriği olmadan. Okuyucumuz robots.txt'ye uyar: kendini LLMWebSearch olarak tanıtır, bir sitenin onun için ya da tüm robotlar için yazdığı kurallara uyar ve okumasına izin verilmeyen her sayfanın içeriğini dışarıda bırakır. robots.txt dosyasında Content-Signal: ai-input=no ayarlayan bir site, sayfalarını sonuçlarınızın içeriğinden uzak tutar.

Bir site okuyucumuza ret yanıtı verdiğinde, sonuç `content_status: "target_refused"` ve sitenin kendi HTTP durum kodunu `target_status` içinde taşır. Bir site okuyucumuzu geri çevirdiğinde sonuç, içerik olmadan ve sitenin durumuyla döner: CAPTCHA'ları asla çözmeyiz, hesaplara giriş yapmayız veya bir engeli ya da ödeme duvarını aşmaya çalışmayız. [Hatalar sayfası](https://llmwebsearch.com/tr/docs/errors/) her durum kodunu ve yeniden denemeye değer olanları listeler.

## Bundan sonra nereye gitmeliyim?

- [Arama endpoint'i](https://llmwebsearch.com/tr/docs/search/) — /search'ün her parametresi, örneklerle
- [Çıkarma endpoint'i](https://llmwebsearch.com/tr/docs/extract/) — Elinizdeki 1 ile 20 URL'yi okuyun
- [Yanıt formatı](https://llmwebsearch.com/tr/docs/response/) — Her alan ve her content_status
- [Hatalar](https://llmwebsearch.com/tr/docs/errors/) — HTTP hataları, sayfa durumları, yeniden deneme kuralları
- [Python](https://llmwebsearch.com/tr/docs/python/) — requests, async httpx, alıntılarla bir yanıt
- [Node.js](https://llmwebsearch.com/tr/docs/node/) — fetch, küçük bir havuz, aynı alıntı döngüsü
- [curl ve jq](https://llmwebsearch.com/tr/docs/curl/) — Terminal tarifleri
- [MCP sunucusu](https://llmwebsearch.com/tr/docs/mcp/) — Claude Code ve Claude Desktop için search_web
- [LangChain ve LlamaIndex](https://llmwebsearch.com/tr/docs/langchain/) — Bir araç ve bir retriever
- [OpenAI function calling](https://llmwebsearch.com/tr/docs/openai/) — Araç şeması, döngü ve Agents SDK
- [n8n](https://llmwebsearch.com/tr/docs/n8n/) — Bir AI Agent için HTTP Request aracı
- [OpenClaw](https://llmwebsearch.com/tr/docs/openclaw/) — MCP üzerinden aramamız

## Hızlı başlangıç: sık sorulan sorular

### SDK'ya ihtiyacım var mı?

Hayır. LLMWebSearch düz bir HTTPS API'dir, bu yüzden herhangi bir HTTP istemcisi çalışır. Bu dokümanlarda Python, Node.js ve curl için kopyala-yapıştır kodlar ve MCP, LangChain, LlamaIndex, OpenAI function calling, n8n ve OpenClaw için araç tanımları yer alır. Hiçbir paket yayımlamıyoruz.

### API benim için yanıtı yazıyor mu?

Hayır. API yazılı bir yanıt değil kaynaklar döndürür: sayfaları kendi modeliniz okur, yanıtı yazar ve URL'leri alıntılar. Bu, modeli, prompt'u ve atıf stilini seçmekte sizi özgür bırakır.

### Anahtarı URL'ye koyabilir miyim?

Evet, `GET /search` isteğinin `api_key` sorgu parametresi olarak. `Authorization` başlığı daha güvenli seçenektir, çünkü URL'ler loglara ve shell geçmişine girer. Her agent, uygulama veya ekip arkadaşı için bir API anahtarı oluşturun ve dashboard'dan diğerlerine dokunmadan istediğinizi iptal edin.

### Denemek için ücretsiz katman var mı?

Hayır. Ücretsiz katman yoktur: 5.000 aramalık paket denemenin yoludur, minimum bakiye yüklemesinden satın alınır; yalnızca bu minimuma ulaşmak için eklediğiniz tutar, harcanmadığı sürece 30 gün içinde talep üzerine USDT veya USDC olarak geri döner.

---

LLMWebSearch: LLMWebSearch, AI ajanları için bir web arama API'sidir; sıralanmış sonuçları en iyi sayfaların Markdown içeriğiyle birlikte döndürür ve kripto ile ödenir, kimlik yüklemesi gerekmez. $1,20/1K arama kredilik ön ödemeli krediler hiç süresi dolmaz. KYC yok — kimlik yok, selfie yok, belge yok. Kripto ile ödeme.