Kurze Antwort
Wie führe ich meine erste Suche mit einer Web-Search-API für AI Agents aus?
Senden Sie Ihre Frage an POST https://llmwebsearch.com/api/v1/search mit Ihrem API-Schlüssel als Bearer-Token. LLMWebSearch führt eine Live-Websuche aus und liefert bis zu 20 gerankte Ergebnisse, wobei die ersten 3 Seiten gelesen und als Markdown zurückgegeben werden. Ein Credit bezahlt diesen gesamten Aufruf, ab 1,20 $/1K Suchanfragen Stand Oktober 2026. Ohne KYC; mit Krypto bezahlen.
Die API auf einer Karte
| Base URL | https://llmwebsearch.com/api/v1 |
|---|---|
| Suchen | POST oder GET https://llmwebsearch.com/api/v1/search |
| URLs lesen, die Sie bereits haben | POST https://llmwebsearch.com/api/v1/extract |
| Verbleibende Credits | GET https://llmwebsearch.com/api/v1/credits, kostenlos |
| Authentifizierung | Übergeben Sie Ihren API-Schlüssel als Bearer-Token im Authorization-Header oder als api_key-Query-Parameter |
| Abrechnung | Ein Credit bezahlt eine Suchanfrage: bis zu 20 gerankte Ergebnisse, wobei die Seiten der ersten 3 gelesen und als Markdown zurückgegeben werden. Werden 4 bis 10 Seiten gelesen, sind es 2 Credits. Ein Aufruf, der mit einem Fehler endet, kostet nichts |
| Unser Seitenleser | LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/), robots.txt-Token LLMWebSearch |
| Kleinstes Paket | 5.000 Suchanfragen für 9,25 $; Credits verfallen nie |
Wie erhalte ich einen API-Schlüssel?
Es gibt kein Anmeldeformular. Das Warten auf die Blockchain-Bestätigung Ihrer Aufladung ist der längste Teil.
Guthaben mit Krypto aufladen
Senden Sie mindestens 25 $ in BTC, USDT, USDC, ETH, SOL, LTC. Melden Sie sich mit einer Kontonummer an; eine E-Mail-Adresse ist optional.
Paket mit Suchanfragen kaufen
5.000 Suchanfragen für 9,25 $ reicht locker, um die Suche in einen Agenten einzubinden und jede Option auszuprobieren.
Schlüssel kopieren
Sobald Ihre Krypto-Aufladung bestätigt und ein Pack gekauft ist, wartet Ihr API-Schlüssel im Dashboard. Bewahren Sie ihn in einer Umgebungsvariable namens
LLMWEBSEARCH_API_KEYauf.
Wie sieht die erste Suchanfrage aus?
Es ist ein einziger HTTPS POST mit einem kleinen JSON-Body. Nur q ist erforderlich: die Frage oder Keywords, so wie ein Mensch sie eintippen würde. Die Standardwerte passen bereits zu den meisten Agenten. Sie erhalten 5 gerankte Ergebnisse, und die Seiten hinter den ersten 3 werden gelesen und als Markdown mit bis zu 6.000 Zeichen pro Seite zurückgegeben.
Die drei Snippets unten senden dieselbe Suchanfrage. Wählen Sie das zu Ihrem Stack passende, setzen Sie LLMWEBSEARCH_API_KEY in Ihrer Shell und führen Sie es aus.
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}'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")
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.');
Was kommt zurück?
Ein JSON-Objekt mit Ihren query, dem Zeitpunkt des Aufrufs in created_at, dem Preis in credits_used und einem results-Array in gerankter Reihenfolge. Jedes Ergebnis hat seine position, title, url, host und snippet, plus published_at, wenn das Datum bekannt ist.
Das entscheidende Feld ist content_status. Steht dort ok, wurde die Seite gelesen und ihr Hauptinhalt liegt in content, mit einer word_count. Ergebnisse jenseits von read zeigen not_requested. Eine Seite, die nicht gelesen werden konnte, nennt den Grund, zum Beispiel blocked_by_robots. Die Seite response format erklärt jedes Feld.
Welche Parameter werde ich am häufigsten ändern?
Sechs Parameter decken nahezu jeden Agenten ab. Alle sind optional.
| Parameter | Was er ändert |
|---|---|
max_results | Wie viele gerankte Ergebnisse zurückkommen, von 1 bis 20 |
read | Wie viele der ersten Ergebnisse gelesen werden, von 0 bis 10 |
max_chars | Die Längenbegrenzung des Inhalts jeder Seite, 500 bis 50.000 Zeichen |
topic und time_range | News statt Webseiten, und ein Aktualitätsfenster |
include_domains | Ergebnisse nur von den von Ihnen gelisteten Seiten |
country und language | Wo und in welcher Sprache die Suche läuft |
Die search reference dokumentiert jeden einzelnen mit einem Beispiel, plus format und exclude_domains.
Wie viele Credits verbraucht ein Aufruf?
Die meisten Aufrufe verbrauchen einen. Die vollständigen Regeln:
- Suche, die 0 bis 3 Seiten liest: 1 Credit. Das umfasst bis zu 20 gerankte Ergebnisse.
- Suche, die 4 bis 10 Seiten liest: 2 Credits.
- Extract: Das Lesen von Seiten, deren URLs Sie bereits haben, kostet 1 Credit für jede angefangene Gruppe von 3 Seiten, die mit Inhalt zurückgegeben werden, bis zu 20 URLs pro Aufruf; abgelehnte oder fehlgeschlagene URLs werden nicht gezählt.
- Fehler: 0 Credit. Ein ungültiger Parameter, ein falscher Schlüssel, ein leeres Guthaben oder eine fehlgeschlagene Suche kostet nichts.
- Eine Seite, die nicht gelesen werden konnte, innerhalb einer erfolgreichen Suche ändert deren Preis nicht.
- Guthaben prüfen mit
GET https://llmwebsearch.com/api/v1/creditsist kostenlos.
Search-Credits verfallen nicht: Was Sie diesen Monat nicht verbrauchen, ist nächstes Jahr noch da.
Was passiert, wenn eine Website nicht gelesen werden möchte?
Das Ergebnis erscheint trotzdem, mit Titel, URL und Snippet, aber ohne Seiteninhalt. Unser Reader respektiert robots.txt: Er stellt sich als LLMWebSearch vor, befolgt die Regeln, die eine Website für ihn oder für alle Roboter schreibt, und lässt den Inhalt jeder Seite aus, die er nicht lesen darf. Eine Website, die in ihrer robots.txt Content-Signal: ai-input=no setzt, hält ihre Seiten aus dem Inhalt Ihrer Ergebnisse heraus.
Wenn eine Website unserem Reader eine Ablehnung entgegnet, trägt das Ergebnis content_status: "target_refused" und den eigenen HTTP-Status der Website in target_status. Wenn eine Website unseren Reader abweist, kommt das Ergebnis ohne Inhalt und mit dem Status der Website zurück: Wir lösen niemals CAPTCHAs, melden uns nicht in Konten an und umgehen weder eine Sperre noch eine Paywall. Die Seite errors listet jeden Status und die, bei denen ein erneuter Versuch sinnvoll ist.
Wie geht es weiter?
- Search-Endpoint Jeder Parameter von /search, mit Beispielen
- Extract-Endpoint 1 bis 20 URLs lesen, die Sie bereits haben
- Antwortformat Jedes Feld und jeder content_status
- Fehler HTTP-Fehler, Seitenstatus, Retry-Regeln
- Python requests, async httpx, eine Antwort mit Zitaten
- Node.js fetch, ein kleiner Pool, dieselbe Zitat-Schleife
- curl und jq Terminal-Rezepte
- MCP-Server search_web für Claude Code und Claude Desktop
- LangChain und LlamaIndex Ein Tool und ein Retriever
- OpenAI Function Calling Tool-Schema, Loop und Agents SDK
- n8n HTTP-Request-Tool für einen AI Agent
- OpenClaw Unsere Suche über MCP
Schnellstart: häufige Fragen
Brauche ich ein SDK?
Nein. LLMWebSearch ist eine reine HTTPS API, also funktioniert jeder HTTP-Client. Diese Docs enthalten Copy-and-paste-Code für Python, Node.js und curl sowie Tool-Definitionen für MCP, LangChain, LlamaIndex, OpenAI function calling, n8n und OpenClaw. Wir veröffentlichen kein Paket.
Schreibt die API die Antwort für mich?
Nein. Die API liefert Quellen, keine geschriebene Antwort: Ihr eigenes Modell liest die Seiten, schreibt die Antwort und zitiert die URLs. So bleiben Sie frei bei der Wahl von Modell, Prompt und Zitierstil.
Kann ich den API-Schlüssel in die URL setzen?
Ja, als Query-Parameter api_key von GET /search. Der Header Authorization ist die sicherere Wahl, weil URLs in Logs und in der Shell-History landen. Erstellen Sie einen API-Schlüssel pro Agent, App oder Teamkollegen und widerrufen Sie jeden davon im Dashboard, ohne die anderen zu berühren.
Gibt es eine kostenlose Teststufe?
Nein. Es gibt keine kostenlose Stufe: Das 5.000-Suchen-Pack ist der Weg, es auszuprobieren, gekauft ab der Mindestaufladung; was Sie nur eingezahlt haben, um diese Mindestaufladung zu erreichen, kommt auf Anfrage innerhalb von 30 Tagen in USDT oder USDC zurück, solange es unverbraucht ist.