API REST

API HTTP en JSON simple qui alimente le site, le flux d'authentification de la CLI et le serveur MCP.

URL de base

https://xvideodownloader.org

Authentification

Les requêtes anonymes fonctionnent pour les téléchargements simples dans la limite anonyme. Pour un compte persistant (limites plus élevées, historique, SVIP), envoyez Authorization: Bearer <token> — obtenez un jeton avec la commande auth login de la CLI ou en vous connectant sur le site.

Limites de débit

Formule gratuite (anonyme ou inscrit) : 2 téléchargements/jour, 720p max, 25 Mo par fichier. SVIP à vie : aucune limite quotidienne, ni de qualité ni de taille. Appliqué par IP pour les requêtes anonymes et par compte une fois authentifié.

Points de terminaison

POST/api/download

Créer une tâche de téléchargement à partir de l'URL d'une publication X/Twitter.

GET/api/downloads/{id}

Obtenir le statut et les métadonnées d'une tâche de téléchargement.

GET/api/file/{id}

Redirection 302 vers le fichier téléchargé. Ajoutez ?dl=1 pour le décompter de votre quota quotidien ; sans ce paramètre, c'est un simple aperçu.

GET/api/downloads

Lister votre historique de téléchargements. Authentification requise.

DELETE/api/downloads/{id}

Supprimer un enregistrement de téléchargement. Impossible de supprimer une tâche en cours.

GET/api/user/usage

Utilisation du jour par rapport à la limite quotidienne de votre formule.

GET/api/user/subscription

Formule actuelle et, pour les anciens abonnés, statut de l'abonnement.

Codes d'erreur

EMPTY_URL	Aucune URL fournie
INVALID_URL_FORMAT	L'URL ne commence pas par http(s)
UNSUPPORTED_HOST	Seuls x.com et twitter.com sont pris en charge
RATE_LIMIT	Limite quotidienne de téléchargements atteinte
FILE_SIZE_LIMIT	La vidéo dépasse la taille maximale de votre formule
VIDEO_NOT_FOUND	Vidéo introuvable ou impossible à extraire
PRIVATE_TWEET	La publication est privée ou protégée
GEO_BLOCKED	Le contenu source est géo-restreint

Exemple

Créez un téléchargement, puis interrogez-le jusqu'à ce qu'il soit terminé :

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

Spécification OpenAPI

Schéma complet des requêtes et réponses au format OpenAPI 3.0, pour la génération de code ou l'import dans vos outils API :

/openapi.json →