# Schnellstart für die Web-Search-API: Ihre erste Suche in zwei Minuten

> Web-Search-API schnell starten: Schlüssel holen, erste Suche mit curl, Python oder Node.js und Top-Seiten als Markdown lesen. Ohne KYC, mit Krypto zahlen.

- URL: https://llmwebsearch.com/de/docs/
- Zuletzt aktualisiert: 2026-10-22
- Herausgeber: LLMWebSearch (https://llmwebsearch.com)

Ein Endpoint erledigt die Arbeit: Senden Sie eine Frage an `/search` und erhalten Sie gerankte Ergebnisse zurück, mit den ersten Seiten bereits gelesen und zu Markdown bereinigt. Diese Seite führt von einem leeren Guthaben bis zum funktionierenden Aufruf und verweist dann auf jede weitere Seite der Docs.

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

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

1. **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.
2. **Paket mit Suchanfragen kaufen** — 5.000 Suchanfragen für 9,25 $ reicht locker, um die Suche in einen Agenten einzubinden und jede Option auszuprobieren.
3. **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_KEY auf.

## 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: eine Suchanfrage, die ersten 3 Seiten gelesen*

```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: Quellen und ihre Größe auflisten*

```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+: die erste gelesene Seite ausgeben*

```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.');

```

## 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](https://llmwebsearch.com/de/docs/response/) 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](https://llmwebsearch.com/de/docs/search/) 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/credits` ist 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](https://llmwebsearch.com/de/docs/errors/) listet jeden Status und die, bei denen ein erneuter Versuch sinnvoll ist.

## Wie geht es weiter?

- [Search-Endpoint](https://llmwebsearch.com/de/docs/search/) — Jeder Parameter von /search, mit Beispielen
- [Extract-Endpoint](https://llmwebsearch.com/de/docs/extract/) — 1 bis 20 URLs lesen, die Sie bereits haben
- [Antwortformat](https://llmwebsearch.com/de/docs/response/) — Jedes Feld und jeder content_status
- [Fehler](https://llmwebsearch.com/de/docs/errors/) — HTTP-Fehler, Seitenstatus, Retry-Regeln
- [Python](https://llmwebsearch.com/de/docs/python/) — requests, async httpx, eine Antwort mit Zitaten
- [Node.js](https://llmwebsearch.com/de/docs/node/) — fetch, ein kleiner Pool, dieselbe Zitat-Schleife
- [curl und jq](https://llmwebsearch.com/de/docs/curl/) — Terminal-Rezepte
- [MCP-Server](https://llmwebsearch.com/de/docs/mcp/) — search_web für Claude Code und Claude Desktop
- [LangChain und LlamaIndex](https://llmwebsearch.com/de/docs/langchain/) — Ein Tool und ein Retriever
- [OpenAI Function Calling](https://llmwebsearch.com/de/docs/openai/) — Tool-Schema, Loop und Agents SDK
- [n8n](https://llmwebsearch.com/de/docs/n8n/) — HTTP-Request-Tool für einen AI Agent
- [OpenClaw](https://llmwebsearch.com/de/docs/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.

---

LLMWebSearch: LLMWebSearch ist eine Websuch-API für KI-Agenten, die gerankte Ergebnisse mit dem Inhalt der Top-Seiten als Markdown liefert, bezahlt mit Krypto ohne Ausweis-Upload. Vorausbezahlte Credits ab 1,20 $/1K Suchanfragen verfallen nie. Ohne KYC — kein Ausweis, kein Selfie, keine Dokumente. Mit Krypto bezahlen.