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
| 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.
Mit Krypto aufladen
Senden Sie mindestens 25 $ in BTC, USDT, USDC, ETH, SOL, LTC. Anmeldung mit Kontonummer; E-Mail ist optional.
Kaufen Sie ein Credit-Pack
10.000 Seiten für 3,75 $ reicht, um alle Optionen mit Ihren eigenen URLs zu testen.
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 -sG "https://webreaderapi.com/api/v1/read" \
-H "Authorization: Bearer $WEBREADER_API_KEY" \
--data-urlencode "url=https://example.com/blog/first-post"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"])
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 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 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 erklärt, welche Fehler einen erneuten Versuch wert sind und welche endgültig sind.
Wie geht es weiter?
- Referenz zum /read-Endpoint lesen Jeder Parameter von /read, mit Beispielen
- Batch und Crawling Bis zu 100 URLs pro Batch oder eine ganze Website
- Antwortformat Jedes Feld der Antwort
- Fehler und robots.txt Codes, Ursachen und Regeln für erneute Versuche
- Python requests, async httpx, RAG-Chunking
- Node.js fetch, ein kleiner Pool, Crawl-Polling
- curl und jq Rezepte für das Terminal
- MCP-Server Ein read_url-Tool für Claude und Cursor
- LangChain und LlamaIndex Loader und Tools für RAG
- OpenAI Function Calling Ein read_url-Tool-Schema und -Loop
- n8n HTTP-Request-Tool für einen AI Agent
- 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.