YouTube API

L'API YouTube vous permet de rechercher sur YouTube et de récupérer les métadonnées des vidéos via une interface unifiée. Chaque endpoint retourne du JSON structuré avec un suivi de l'utilisation des crédits.

Endpoints

Endpoint	Description
`POST /api/v1/youtube/search`	Rechercher sur YouTube avec des filtres (date, durée, type, qualité)
`POST /api/v1/youtube/metadata`	Obtenir les métadonnées structurées d'une vidéo (vues, likes, tags, description)

Authentification

En-tête	Valeur	Requis
`Authorization`	`Bearer YOUR_API_KEY`	Oui
`Content-Type`	`application/json`	Oui

YouTube Search

Bash

POST https://api.scavio.dev/api/v1/youtube/search

Recherchez sur YouTube et obtenez des résultats structurés. Prend en charge le filtrage par date de publication, durée, type de résultat, qualité vidéo, et plus encore.

Corps de la requête

Paramètre	Type	Défaut	Description
`search`	`string`	--	Requis. Requête de recherche (1-500 caractères).
`upload_date`	`string`	--	Filtrer par date de publication. Une des valeurs : `last_hour`, `today`, `this_week`, `this_month`, `this_year`
`type`	`string`	--	Filtrer par type de résultat. Une des valeurs : `video`, `channel`, `playlist`
`duration`	`string`	--	Filtrer par durée de la vidéo. Une des valeurs : `short` (moins de 4 min), `medium` (4-20 min), `long` (plus de 20 min)
`sort_by`	`string`	`relevance`	Ordre de tri. Une des valeurs : `relevance`, `date`, `view_count`, `rating`
`hd`	`boolean`	`false`	Vidéos HD uniquement
`4k`	`boolean`	`false`	Vidéos 4K uniquement
`subtitles`	`boolean`	`false`	Vidéos avec sous-titres uniquement
`creative_commons`	`boolean`	`false`	Vidéos sous licence Creative Commons uniquement
`live`	`boolean`	`false`	Live streams uniquement
`hdr`	`boolean`	`false`	Vidéos HDR uniquement
`360`	`boolean`	`false`	Vidéos à 360 degrés uniquement
`3d`	`boolean`	`false`	Vidéos 3D uniquement
`location`	`boolean`	`false`	Vidéos avec métadonnées de localisation uniquement
`vr180`	`boolean`	`false`	Vidéos VR180 uniquement

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/youtube/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "search": "langchain tutorial",
    "type": "video",
    "duration": "medium",
    "sort_by": "view_count",
    "upload_date": "this_year"
  }'

Exemple de réponse

JSON

{
  "data": {
    "results": [
      {
        "videoId": "sVcwVQRHIc8",
        "title": { "runs": [{ "text": "Learn RAG From Scratch - Python AI Tutorial" }] },
        "longBylineText": { "runs": [{ "text": "freeCodeCamp.org" }] },
        "publishedTimeText": { "simpleText": "1 year ago" },
        "lengthText": { "simpleText": "2:33:11" },
        "viewCountText": { "simpleText": "1,258,310 views" },
        "thumbnail": { "thumbnails": [{ "url": "https://i.ytimg.com/vi/sVcwVQRHIc8/hq720.jpg", "width": 360, "height": 202 }] }
      }
    ],
    "search": "langchain tutorial"
  },
  "response_time": 1230,
  "credits_used": 1,
  "credits_remaining": 999
}

Video Metadata

Bash

POST https://api.scavio.dev/api/v1/youtube/metadata

Obtenez les métadonnées structurées d'une vidéo YouTube, y compris le titre, la description, le nombre de vues, le nombre de likes, le nombre de commentaires, les tags, les miniatures, la date de publication, les informations sur la chaîne et les formats disponibles.

Corps de la requête

Paramètre	Type	Description
`video_id`	`string`	Requis. ID de la vidéo YouTube (ex. `dQw4w9WgXcQ`).

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/youtube/metadata' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"video_id": "sVcwVQRHIc8"}'

Exemple de réponse

JSON

{
  "data": {
    "title": "Learn RAG From Scratch - Python AI Tutorial",
    "description": "Learn how to implement RAG from scratch...",
    "upload_date": 20240417,
    "duration": 9191,
    "view_count": 1258310,
    "like_count": 23211,
    "comment_count": 295,
    "categories": ["Education"],
    "tags": ["rag", "langchain", "python", "llm"],
    "channel_id": "UC8butISFwT-Wl7EV0hUK0BQ",
    "channel_url": "https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ",
    "uploader": "freeCodeCamp.org",
    "uploader_id": "@freecodecamp",
    "uploader_url": "https://www.youtube.com/@freecodecamp",
    "video_id": "sVcwVQRHIc8",
    "is_live": false,
    "age_limit": 0,
    "thumbnails": [
      {
        "url": "https://i.ytimg.com/vi/sVcwVQRHIc8/maxresdefault.jpg",
        "width": 1280,
        "height": 720
      }
    ],
    "formats": []
  },
  "response_time": 890,
  "credits_used": 1,
  "credits_remaining": 998
}

Format de la réponse

Tous les endpoints YouTube retournent un wrapper de réponse cohérent :

Champ	Type	Description
`data`	`object \| null`	Le payload de la réponse. La forme dépend de l'endpoint. Search retourne `{results, search}` ; metadata retourne l'objet vidéo. `null` si la requête a échoué en amont.
`response_time`	`number`	Temps de réponse côté serveur en millisecondes
`credits_used`	`number`	Nombre de crédits consommés par cette requête
`credits_remaining`	`number`	Crédits restants dans votre période de facturation actuelle

Réponses d'erreur

Statut	Description
`401`	Non autorisé -- clé API manquante ou invalide
`429`	Limite de taux ou d'utilisation dépassée pour votre forfait
`502`	Erreur en amont -- réessayez après un court délai
`503`	Indisponible en amont -- réessayez plus tard

Voir Erreurs pour la référence complète des erreurs et les bonnes pratiques de réessai.

Liens connexes

Démarrage rapide -- obtenez votre clé API et effectuez votre première requête
API Google Search -- rechercher sur Google avec des données SERP structurées
API Amazon -- rechercher des produits et obtenir des détails par ASIN
Limites de débit -- limites par niveau de forfait
Erreurs -- codes d'erreur et gestion

YouTube API

Endpoints

Endpoint	Description
`POST /api/v1/youtube/search`	Rechercher sur YouTube avec des filtres (date, durée, type, qualité)
`POST /api/v1/youtube/metadata`	Obtenir les métadonnées structurées d'une vidéo (vues, likes, tags, description)

Authentification

En-tête	Valeur	Requis
`Authorization`	`Bearer YOUR_API_KEY`	Oui
`Content-Type`	`application/json`	Oui

YouTube Search

Bash

POST https://api.scavio.dev/api/v1/youtube/search

Recherchez sur YouTube et obtenez des résultats structurés. Prend en charge le filtrage par date de publication, durée, type de résultat, qualité vidéo, et plus encore.

Corps de la requête

Paramètre	Type	Défaut	Description
`search`	`string`	--	Requis. Requête de recherche (1-500 caractères).
`upload_date`	`string`	--	Filtrer par date de publication. Une des valeurs : `last_hour`, `today`, `this_week`, `this_month`, `this_year`
`type`	`string`	--	Filtrer par type de résultat. Une des valeurs : `video`, `channel`, `playlist`
`duration`	`string`	--	Filtrer par durée de la vidéo. Une des valeurs : `short` (moins de 4 min), `medium` (4-20 min), `long` (plus de 20 min)
`sort_by`	`string`	`relevance`	Ordre de tri. Une des valeurs : `relevance`, `date`, `view_count`, `rating`
`hd`	`boolean`	`false`	Vidéos HD uniquement
`4k`	`boolean`	`false`	Vidéos 4K uniquement
`subtitles`	`boolean`	`false`	Vidéos avec sous-titres uniquement
`creative_commons`	`boolean`	`false`	Vidéos sous licence Creative Commons uniquement
`live`	`boolean`	`false`	Live streams uniquement
`hdr`	`boolean`	`false`	Vidéos HDR uniquement
`360`	`boolean`	`false`	Vidéos à 360 degrés uniquement
`3d`	`boolean`	`false`	Vidéos 3D uniquement
`location`	`boolean`	`false`	Vidéos avec métadonnées de localisation uniquement
`vr180`	`boolean`	`false`	Vidéos VR180 uniquement

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/youtube/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "search": "langchain tutorial",
    "type": "video",
    "duration": "medium",
    "sort_by": "view_count",
    "upload_date": "this_year"
  }'

Exemple de réponse

JSON

{
  "data": {
    "results": [
      {
        "videoId": "sVcwVQRHIc8",
        "title": { "runs": [{ "text": "Learn RAG From Scratch - Python AI Tutorial" }] },
        "longBylineText": { "runs": [{ "text": "freeCodeCamp.org" }] },
        "publishedTimeText": { "simpleText": "1 year ago" },
        "lengthText": { "simpleText": "2:33:11" },
        "viewCountText": { "simpleText": "1,258,310 views" },
        "thumbnail": { "thumbnails": [{ "url": "https://i.ytimg.com/vi/sVcwVQRHIc8/hq720.jpg", "width": 360, "height": 202 }] }
      }
    ],
    "search": "langchain tutorial"
  },
  "response_time": 1230,
  "credits_used": 1,
  "credits_remaining": 999
}

Video Metadata

Bash

POST https://api.scavio.dev/api/v1/youtube/metadata

Corps de la requête

Paramètre	Type	Description
`video_id`	`string`	Requis. ID de la vidéo YouTube (ex. `dQw4w9WgXcQ`).

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/youtube/metadata' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"video_id": "sVcwVQRHIc8"}'

Exemple de réponse

JSON

{
  "data": {
    "title": "Learn RAG From Scratch - Python AI Tutorial",
    "description": "Learn how to implement RAG from scratch...",
    "upload_date": 20240417,
    "duration": 9191,
    "view_count": 1258310,
    "like_count": 23211,
    "comment_count": 295,
    "categories": ["Education"],
    "tags": ["rag", "langchain", "python", "llm"],
    "channel_id": "UC8butISFwT-Wl7EV0hUK0BQ",
    "channel_url": "https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ",
    "uploader": "freeCodeCamp.org",
    "uploader_id": "@freecodecamp",
    "uploader_url": "https://www.youtube.com/@freecodecamp",
    "video_id": "sVcwVQRHIc8",
    "is_live": false,
    "age_limit": 0,
    "thumbnails": [
      {
        "url": "https://i.ytimg.com/vi/sVcwVQRHIc8/maxresdefault.jpg",
        "width": 1280,
        "height": 720
      }
    ],
    "formats": []
  },
  "response_time": 890,
  "credits_used": 1,
  "credits_remaining": 998
}

Format de la réponse

Tous les endpoints YouTube retournent un wrapper de réponse cohérent :

Champ	Type	Description
`data`	`object \| null`	Le payload de la réponse. La forme dépend de l'endpoint. Search retourne `{results, search}` ; metadata retourne l'objet vidéo. `null` si la requête a échoué en amont.
`response_time`	`number`	Temps de réponse côté serveur en millisecondes
`credits_used`	`number`	Nombre de crédits consommés par cette requête
`credits_remaining`	`number`	Crédits restants dans votre période de facturation actuelle

Réponses d'erreur

Statut	Description
`401`	Non autorisé -- clé API manquante ou invalide
`429`	Limite de taux ou d'utilisation dépassée pour votre forfait
`502`	Erreur en amont -- réessayez après un court délai
`503`	Indisponible en amont -- réessayez plus tard

Voir Erreurs pour la référence complète des erreurs et les bonnes pratiques de réessai.

Liens connexes

Démarrage rapide -- obtenez votre clé API et effectuez votre première requête
API Google Search -- rechercher sur Google avec des données SERP structurées
API Amazon -- rechercher des produits et obtenir des détails par ASIN
Limites de débit -- limites par niveau de forfait
Erreurs -- codes d'erreur et gestion