Docs · hızlı başlangıç

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

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.

Son güncelleme: 22 Ekim 2026 · 5 dk okuma

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

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.

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

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

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

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ı 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ı 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ı her durum kodunu ve yeniden denemeye değer olanları listeler.

Bundan sonra nereye gitmeliyim?

Arama endpoint'i /search'ün her parametresi, örneklerle
Çıkarma endpoint'i Elinizdeki 1 ile 20 URL'yi okuyun
Yanıt formatı Her alan ve her content_status
Hatalar HTTP hataları, sayfa durumları, yeniden deneme kuralları
Python requests, async httpx, alıntılarla bir yanıt
Node.js fetch, küçük bir havuz, aynı alıntı döngüsü
curl ve jq Terminal tarifleri
MCP sunucusu Claude Code ve Claude Desktop için search_web
LangChain ve LlamaIndex Bir araç ve bir retriever
OpenAI function calling Araç şeması, döngü ve Agents SDK
n8n Bir AI Agent için HTTP Request aracı
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.