REST API

Schlichte JSON-HTTP-API hinter der Website, dem Auth-Ablauf der CLI und dem MCP-Server.

Basis-URL

https://xvideodownloader.org

Authentifizierung

Anonyme Anfragen funktionieren für einfache Downloads innerhalb des anonymen Limits. Für ein dauerhaftes Konto (höhere Limits, Download-Verlauf, SVIP) senden Sie Authorization: Bearer <token> – ein Token erhalten Sie über den CLI-Befehl auth login oder durch Anmeldung auf der Website.

Rate Limits

Gratis-Tarif (anonym oder registriert): 2 Downloads/Tag, maximal 720p, 25 MB pro Datei. Lebenslanges SVIP: kein Tageslimit, keine Qualitäts- oder Größenbegrenzung. Bei anonymen Anfragen pro IP, bei angemeldeten pro Konto.

Endpunkte

POST/api/download

Eine Download-Aufgabe aus einer X-/Twitter-Beitrags-URL anlegen.

GET/api/downloads/{id}

Status und Metadaten einer Download-Aufgabe abrufen.

GET/api/file/{id}

302-Weiterleitung zur heruntergeladenen Datei. Mit ?dl=1 zählt der Abruf gegen Ihr Tageskontingent; ohne den Parameter ist es eine reine Vorschau.

GET/api/downloads

Ihren Download-Verlauf auflisten. Erfordert Authentifizierung.

DELETE/api/downloads/{id}

Einen Download-Eintrag löschen. Laufende Aufgaben können nicht gelöscht werden.

GET/api/user/usage

Heutige Nutzung im Verhältnis zum Tageslimit Ihres Tarifs.

GET/api/user/subscription

Aktueller Tarif und – für Bestandsabonnenten – der Abostatus.

Fehlercodes

EMPTY_URL	Keine URL angegeben
INVALID_URL_FORMAT	URL beginnt nicht mit http(s)
UNSUPPORTED_HOST	Nur x.com und twitter.com werden unterstützt
RATE_LIMIT	Tägliches Download-Limit erreicht
FILE_SIZE_LIMIT	Video überschreitet die Dateigrößengrenze des Tarifs
VIDEO_NOT_FOUND	Video konnte nicht gefunden oder extrahiert werden
PRIVATE_TWEET	Der Beitrag ist privat oder geschützt
GEO_BLOCKED	Der Inhalt ist regional gesperrt

Beispiel

Download anlegen und dann abfragen, bis er fertig ist:

curl -X POST https://xvideodownloader.org/api/download \
  -H "Content-Type: application/json" \
  -d '{"url": "https://x.com/user/status/123456789"}'

OpenAPI-Spezifikation

Vollständiges Request-/Response-Schema im Format OpenAPI 3.0 für Codegenerierung oder Import in API-Tools:

/openapi.json →