# Schnellstart für die URL-to-Markdown-API: Ihre erste Seite in zwei Minuten

> URL-to-Markdown-API schnell starten: Schlüssel holen, erste Seite mit curl, Python oder Node.js lesen und Credits prüfen. Ab 0,07 $/1K Seiten, ohne KYC.

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

Ein Endpoint, ein Parameter: Senden Sie eine URL an `/read` und erhalten Sie den Hauptinhalt der Seite als Markdown zurück. Diese Seite führt Sie von einem leeren Guthaben zu einem funktionierenden Aufruf und verweist dann auf alles Weitere.

**Kurze Antwort — Wie konvertiere ich eine URL mit einer API in Markdown?**

Senden Sie die URL an `GET https://webreaderapi.com/api/v1/read` mit Ihrem API-Schlüssel im Header `Authorization`. **WebReaderAPI** ruft die Seite ab, behält den Hauptinhalt und gibt ihn als Markdown mit Titel, Autor, Datum und Wortzahl zurück. Eine Seite kostet einen Credit (zwei, wenn ein Browser nötig ist), ab 0,07 $/1K Seiten Stand Oktober 2026. Ohne KYC; mit Krypto bezahlen.

## Die API in einer Tabelle

| Attribut | Wert |
| --- | --- |
| Basis-URL | `https://webreaderapi.com/api/v1` |
| Eine Seite lesen | `GET` oder `POST https://webreaderapi.com/api/v1/read` |
| Viele URLs oder eine ganze Website | `POST https://webreaderapi.com/api/v1/batch` und `POST https://webreaderapi.com/api/v1/crawl`, Ergebnisse von `GET https://webreaderapi.com/api/v1/jobs/{job_id}` |
| Verbleibende Credits | `GET https://webreaderapi.com/api/v1/credits` (kostenlos) |
| Authentifizierung | Senden Sie Ihren API-Schlüssel im Authorization-Header als Bearer-Token oder im api_key-Query-Parameter |
| Abrechnung | 1 Credit = 1 gelesene Seite ohne Browser; 2 Credits, wenn die Seite einen Browser braucht, um JavaScript auszuführen. Eine Suchanfrage, die fehlschlägt oder die eine robots.txt einer Website verweigert, wird nicht abgerechnet |
| Unser Crawler | `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`, robots.txt-Token `WebReaderAPI` |
| Kleinstes Pack | 10.000 Seiten für 3,75 $; Credits verfallen nie |

## Wie bekomme ich einen API-Schlüssel?

Drei Schritte, kein Formular auszufüllen. Der langsamste davon ist die Blockchain-Bestätigung Ihrer Aufladung.

1. **Mit Krypto aufladen** — Senden Sie mindestens 25 $ in BTC, USDT, USDC, ETH, SOL, LTC. Anmeldung mit Kontonummer; E-Mail ist optional.
2. **Kaufen Sie ein Credit-Pack** — 10.000 Seiten für 3,75 $ reicht, um alle Optionen mit Ihren eigenen URLs zu testen.
3. **Kopieren Sie Ihren API-Schlüssel** — Ihr API-Schlüssel ist im Dashboard bereit, sobald Ihre Krypto-Aufladung bestätigt ist und Sie ein Pack gekauft haben. Speichern Sie ihn in einer Umgebungsvariable namens WEBREADER_API_KEY.

## Wie sieht die erste Anfrage aus?

Sie ist ein einfacher HTTPS-GET mit der Seitenadresse im Parameter `url`. Kodieren Sie die Adresse, denn sie enthält ihre eigenen Zeichen `:` und `/`; curl erledigt das für Sie mit `--data-urlencode`. Die Standardeinstellungen passen bereits zu den meisten Artikeln und Dokumentationsseiten: Markdown-Ausgabe, nur der Hauptinhalt und ein Headless-Browser nur, wenn die Seite einen braucht.

*curl: eine Seite lesen*

```bash
curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/blog/first-post"
```

*Python: eine Seite lesen und speichern*

```python
import os

import requests

resp = requests.get(
    "https://webreaderapi.com/api/v1/read",
    headers={"Authorization": "Bearer " + os.environ["WEBREADER_API_KEY"]},
    params={"url": "https://example.com/blog/first-post"},
    timeout=70,
)
resp.raise_for_status()
page = resp.json()
print(page["title"], "-", page["word_count"], "words,", page["credits_used"], "credit(s)")
with open("first-post.md", "w", encoding="utf-8") as f:
    f.write(page["markdown"])

```

*Node.js 18+: eine Seite lesen*

```javascript
const params = new URLSearchParams({ url: 'https://example.com/blog/first-post' });
const res = await fetch(`https://webreaderapi.com/api/v1/read?${params}`, {
  headers: { Authorization: `Bearer ${process.env.WEBREADER_API_KEY}` },
});
const page = await res.json();
if (!res.ok) throw new Error(`${page.error.code}: ${page.error.message}`);
console.log(page.title, page.word_count, 'words');
console.log(page.markdown.slice(0, 500));

```

## Was kommt zurück?

Ein JSON-Objekt mit dem Markdown im Feld `markdown` und den Metadaten der Seite daneben: `title`, `description`, `author`, `published_at`, `language`, `site_name` und `word_count`. Zwei Felder helfen Ihnen zu prüfen, was passiert ist: `final_url` ist die Adresse nach Weiterleitungen, und `rendered` sagt Ihnen, ob ein Headless-Browser nötig war.

`credits_used` zeigt, was der Aufruf gekostet hat: 1 für eine einfache Seite, 2 wenn `rendered` gleich `true` ist, einen mehr, wenn Sie einen `country` gewählt haben. Die [Seite zum Antwortformat](https://webreaderapi.com/de/docs/response/) listet jedes Feld mit einem Beispiel auf.

## Welche Optionen werde ich am häufigsten nutzen?

Fünf Parameter decken die meisten Bedürfnisse ab. Alle sind optional.

| Parameter | Wofür |
|---|---|
| `format` | `text` oder bereinigtes `html` statt `markdown` erhalten |
| `main_content` | `false` festlegen, um die ganze Seite inklusive Menüs umzuwandeln |
| `render` | Den Headless-Browser erzwingen (`true`) oder verbieten (`false`); `auto` entscheidet |
| `include_links` | Die Links der Seite als separate Liste erhalten |
| `max_chars` | Lange Seiten kürzen, damit sie in das Kontextbudget eines Modells passen |

Die [Referenz zu /read](https://webreaderapi.com/de/docs/read/) beschreibt jeden Parameter, einschließlich `country`, `include_images` und `timeout`.

## Wie prüfe ich meine verbleibenden Credits?

Rufen Sie `GET https://webreaderapi.com/api/v1/credits` mit demselben API-Schlüssel auf. Es liefert `credits_remaining`, `credits_used_today` und Ihr `concurrency_limit` zurück und kostet nichts. Rufen Sie es am Anfang eines langen Jobs auf, damit der Job sauber stoppt, statt mitten drin an `402 insufficient_credits` zu scheitern.

Prepaid-Credits verfallen nie: Ungenutzte Seiten bleiben auf Ihrem Konto, bis Sie sie verwenden, sodass ein für ein Projekt gekauftes Paket seinen Wert für das nächste behält.

## Was passiert, wenn eine Seite Robots nicht erlaubt?

 Wir lesen die Seite nicht, und Ihnen wird nichts berechnet. Unser Crawler meldet sich als `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)` und befolgt die robots.txt der Seite. Eine nicht erlaubte Seite liefert `403 blocked_by_robots`; eine Seite, die die Anfrage auf andere Weise ablehnt, liefert `502 target_refused` mit dem eigenen Statuscode der Seite.

Wenn eine Website unsere Suchanfrage ablehnt, geben wir ihre Antwort zurück: Wir lösen nie CAPTCHAs, melden uns nie in Konten an und versuchen nie, eine Sperre oder eine Paywall zu umgehen. Die [Fehlerseite](https://webreaderapi.com/de/docs/errors/) erklärt, welche Fehler einen erneuten Versuch wert sind und welche endgültig sind.

## Wie geht es weiter?

- [Referenz zum /read-Endpoint lesen](https://webreaderapi.com/de/docs/read/) — Jeder Parameter von /read, mit Beispielen
- [Batch und Crawling](https://webreaderapi.com/de/docs/crawl/) — Bis zu 100 URLs pro Batch oder eine ganze Website
- [Antwortformat](https://webreaderapi.com/de/docs/response/) — Jedes Feld der Antwort
- [Fehler und robots.txt](https://webreaderapi.com/de/docs/errors/) — Codes, Ursachen und Regeln für erneute Versuche
- [Python](https://webreaderapi.com/de/docs/python/) — requests, async httpx, RAG-Chunking
- [Node.js](https://webreaderapi.com/de/docs/node/) — fetch, ein kleiner Pool, Crawl-Polling
- [curl und jq](https://webreaderapi.com/de/docs/curl/) — Rezepte für das Terminal
- [MCP-Server](https://webreaderapi.com/de/docs/mcp/) — Ein read_url-Tool für Claude und Cursor
- [LangChain und LlamaIndex](https://webreaderapi.com/de/docs/langchain/) — Loader und Tools für RAG
- [OpenAI Function Calling](https://webreaderapi.com/de/docs/openai/) — Ein read_url-Tool-Schema und -Loop
- [n8n](https://webreaderapi.com/de/docs/n8n/) — HTTP-Request-Tool für einen AI Agent
- [OpenClaw](https://webreaderapi.com/de/docs/openclaw/) — Den MCP-Server neben web_fetch hinzufügen

## Schnellstart: häufige Fragen

### Gibt es ein SDK zum Installieren?

Nein. WebReaderAPI ist eine einfache HTTPS-API, daher funktioniert jeder HTTP-Client. Die Docs enthalten Copy-Paste-Code für Python, Node.js und curl sowie Tool-Definitionen für MCP, LangChain, LlamaIndex und OpenAI function calling. Nichts wird als Paket veröffentlicht.

### Kann ich den API-Schlüssel in der URL statt in einem Header senden?

Ja, als Query-Parameter `api_key`. Der Header `Authorization: Bearer` ist sicherer, weil URLs oft in Logs und im Browserverlauf landen. Erstellen Sie mehrere API-Schlüssel, zum Beispiel einen pro Agent oder Projekt, und widerrufen Sie jeden davon in Ihrem Dashboard.

### Verbraucht eine fehlgeschlagene Seite einen Credit?

Nein. 1 Credit = 1 gelesene Seite ohne Browser; 2 Credits, wenn die Seite einen Browser braucht, um JavaScript auszuführen. Eine Suchanfrage, die fehlschlägt oder die eine robots.txt einer Website verweigert, wird nicht abgerechnet. Nur eine Seite, die mit Inhalt zurückkommt, wird berechnet.

### Kann ich es vor dem Kauf testen?

Es gibt keine kostenlose Stufe. Es gibt keine kostenlose Stufe: Das kleinste Pack ist der Weg zum Testen, bezahlt aus der Mindest-Aufladung, und der Betrag, der nur zur Erreichung dieses Minimums eingezahlt wurde, kann auf Anfrage innerhalb von 30 Tagen in USDT oder USDC zurückgesendet werden, solange er unverbraucht ist.

---

WebReaderAPI: WebReaderAPI ist eine Web-Reader-API für KI-Agenten, die jede öffentliche Webseite in sauberes Markdown umwandelt und die Sie mit Krypto bezahlen – ohne ID-Upload. Prepaid-Credits ab 0,07 $/1K Seiten verfallen nie, und robots.txt wird respektiert. Ohne KYC – keine ID, kein Selfie, keine Dokumente. Mit Krypto bezahlen.