API

Documentation API publique

OpenUtils YTDL expose une API publique simple pour récupérer les métadonnées d’une vidéo YouTube et lancer un téléchargement MP3 ou MP4 directement depuis vos intégrations.

Vue d’ensemble

L’API actuelle fournit trois endpoints publics : informations vidéo, flux audio MP3 et flux vidéo MP4. Les téléchargements sont streamés directement, sans stockage durable côté serveur.

Rate limit

L’API publique est protégée par une limitation de débit par IP au niveau du proxy. Si vous avez besoin d’un usage plus intensif, contactez-nous directement.

Informations vidéo

Retourne les métadonnées utiles pour afficher le titre, la miniature, la durée et les formats proposés.

GET/api/info?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ

Flux audio MP3

Stream audio MP3 directement en réponse HTTP.

GET/api/stream?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ

Flux vidéo MP4

Stream vidéo MP4 avec fusion audio/vidéo côté serveur.

GET/api/stream/video?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ&fmt=mp4-720

Paramètres

url : URL YouTube publique à convertir.
fmt : format vidéo cible. Valeurs supportées : mp4-720, mp4-1080.

Exemples cURL

curl "https://ytdl.openutils.net/api/info?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"

curl -L "https://ytdl.openutils.net/api/stream?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
  --output audio.mp3

curl -L "https://ytdl.openutils.net/api/stream/video?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ&fmt=mp4-720" \
  --output video.mp4

Réponses

L’endpoint info renvoie du JSON. Les endpoints stream renvoient directement le fichier audio ou vidéo dans la réponse HTTP.

Healthcheck

curl https://ytdl.openutils.net/api/health

GET /api/health permet de vérifier que le moteur yt-dlp + ffmpeg répond correctement.