Dokumentation

ParseJet-Dokumentation

ParseJet extrahiert Text aus beliebigen Dateien oder URLs. Ein API-Aufruf verarbeitet PDF, DOCX, YouTube, Webseiten, Bilder, Audio, Video und 25+ weitere Formate.

Schnellstart

Erhalten Sie Ihr erstes Parse-Ergebnis in unter 60 Sekunden. Keine Anmeldung erforderlich.

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Add your API key to requests
curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
  "text": "Extracted text content...",
  "title": "Document Title",
  "source_type": "webpage",
  "metadata": { "url": "https://example.com" }
}

Authentifizierung

ParseJet bietet drei Zugriffsebenen. Sie können die API sofort ohne Authentifizierung nutzen.

Kernkonzepte

Unterstützte Formate

ParseJet erkennt das Format automatisch anhand der Dateiendung oder des URL-Musters. Sie müssen das Format nicht angeben – senden Sie einfach die Datei oder URL an /v1/parse/auto und ParseJet erledigt den Rest.

Credits

Jede API-Anfrage verbraucht Credits basierend auf der Komplexität des zu parsenden Formats. Einfache Textdateien kosten 1 Credit, YouTube-Transkripte kosten 5. Ihr monatliches Credit-Kontingent hängt von Ihrem Tarif ab.

Ausgabeformat

Standardmäßig gibt ParseJet den rohen extrahierten Text zurück. Fügen Sie ?output_format=markdown zu einer Anfrage hinzu, um nachbearbeitete Ausgabe mit erkannten Überschriften, Listen, Tabellen und Codeblöcken zu erhalten.

Anleitung

Eine PDF parsen

Extrahieren Sie Text aus jeder PDF-Datei, einschließlich gescannter Dokumente und mehrseitiger Berichte.

PDF-Datei hochladen

curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

In Markdown konvertieren

Fügen Sie output_format=markdown hinzu, um die Dokumentstruktur zu erhalten:

curl -X POST https://api.parsejet.com/v1/parse/auto/file?output_format=markdown \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Anleitung

YouTube-Transkripte

Erhalten Sie das vollständige Transkript eines beliebigen YouTube-Videos. Unterstützt automatisch generierte Untertitel in über 100 Sprachen.

Transkript abrufen

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID"}'

Sprache angeben

Verwenden Sie den language-Parameter für nicht-englische Videos:

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID", "language": "ja"}'

Oder automatisch erkennen lassen

Der Endpunkt /v1/parse/auto/url erkennt YouTube-URLs automatisch:

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtu.be/VIDEO_ID"}'

Anleitung

Web-Scraping

Extrahiere den Hauptinhalt von jeder Webseite. ParseJet entfernt automatisch Navigation, Werbung, Sidebars und Boilerplate.

curl -X POST https://api.parsejet.com/v1/parse/webpage \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/blog/article"}'

Anleitung

Office-Dokumente

Parse Word (DOCX), Excel (XLSX), PowerPoint (PPTX) und CSV-Dateien. Lade einfach die Datei hoch — ParseJet erkennt das Format automatisch.

# Works with any Office format
curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

# Also works with spreadsheets
curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

API-Referenz

Antwortformat

Alle Endpunkte liefern die gleiche JSON-Struktur:

{
  "text": "Extracted text content...",
  "title": "Document Title",
  "source_type": "pdf",
  "metadata": { "pages": 12, "author": "Jane Doe" }
}

Der empfohlene Endpunkt. Erkennt das Format automatisch anhand der Dateiendung oder URL. Akzeptiert file (multipart) oder url (Formularfeld), nicht beides.

curl -X POST https://api.parsejet.com/v1/parse/auto \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Parse jede URL. Unterscheidet automatisch zwischen YouTube und regulären Webseiten.

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Parse jede hochgeladene Datei. Erkennt Format anhand der Dateiendung, greift auf inhaltsbasierte Erkennung zurück.

curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Extrahiere Hauptinhalt von einer Webseite. Entfernt Navigation, Werbung und Boilerplate.

curl -X POST https://api.parsejet.com/v1/parse/webpage \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

Extrahiere Transkript von einem YouTube-Video. Metadaten enthalten video_id, Kanal und Dauer.

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID", "language": "en"}'

Parse Audio-Dateien. Unterstützt MP3, WAV, M4A, OGG, FLAC, WebM. Max. 25MB.

curl -X POST https://api.parsejet.com/v1/parse/audio \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "language=en"

Extrahiere Audio aus Video zur Transkription. Unterstützt MP4, MKV, AVI, MOV, WebM.

curl -X POST https://api.parsejet.com/v1/parse/video \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "language=en"

Parse EPUB-E-Book. Extrahiert nach Kapiteln organisierten Text.

curl -X POST https://api.parsejet.com/v1/parse/epub \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Parse RSS- oder Atom-Feed. Unterstützt auch OPML via /v1/parse/opml.

curl -X POST https://api.parsejet.com/v1/parse/feed \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

Analysiere Bild. Unterstützt JPG, PNG, GIF, BMP, WebP, TIFF. Max. 20MB.

curl -X POST https://api.parsejet.com/v1/parse/image \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "prompt=Describe this image"

Extrahiere Text aus Bild via OCR.

curl -X POST https://api.parsejet.com/v1/parse/image/ocr \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

SDKs

Offizielle SDKs

npm install parsejet

import { ParseJet } from "parsejet";

const client = new ParseJet({ apiKey: "pj_YOUR_KEY" });

// Parse a URL
const result = await client.parse.url("https://example.com");
console.log(result.text);

// Parse a file
const result = await client.parse.file(buffer, "report.pdf");
console.log(result.text);

pip install parsejet

from parsejet import ParseJet

client = ParseJet(api_key="pj_YOUR_KEY")

# Parse a URL
result = client.parse.url("https://example.com")
print(result.text)

# Parse a file
with open("report.pdf", "rb") as f:
    result = client.parse.file(f, "report.pdf")
    print(result.text)

KI-Agenten

MCP-Server

Verwende ParseJet als MCP (Model Context Protocol) Server mit Claude Code, Cursor oder jedem MCP-kompatiblen KI-Agenten.

Installieren

npm install -g @parsejet/mcp-server

Claude Code

Füge zu deiner Projektdatei .claude/settings.json hinzu:

{
  "mcpServers": {
    "parsejet": {
      "command": "npx",
      "args": ["-y", "@parsejet/mcp-server"],
      "env": {
        "PARSEJET_API_KEY": "pj_YOUR_KEY"
      }
    }
  }
}

Cursor

Gehe zu Einstellungen → MCP-Server, füge einen neuen Server hinzu:

{
  "mcpServers": {
    "parsejet": {
      "command": "npx",
      "args": ["-y", "@parsejet/mcp-server"],
      "env": {
        "PARSEJET_API_KEY": "pj_YOUR_KEY"
      }
    }
  }
}

Claude.ai (Remote)

Für Claude.ai Web, verwende den Remote-HTTP-Endpunkt — keine lokale Installation nötig:

Endpoint:  https://api.parsejet.com/mcp
Transport: Streamable HTTP
Auth:      Bearer pj_YOUR_KEY (in Authorization header)

Gehe zu Claude.ai → Einstellungen → Integrationen → MCP-Server hinzufügen → Gib die obige URL ein.

Verfügbare Tools

Ratenbegrenzungen & Preise

ParseJet verwendet ein kreditbasiertes System. Jede Anfrage verbraucht Credits basierend auf der Formatkomplexität.

Antwort-Header enthalten X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset und bei 429-Antworten Retry-After.

Fehlercodes

Alle Fehler geben JSON mit den Feldern error und message zurück.