---
title: YouTube
description: Interagir avec les vidéos, chaînes et playlists YouTube
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="youtube"
  color="#FF0000"
/>

{/* MANUAL-CONTENT-START:intro */}
[YouTube](https://www.youtube.com/) est la plus grande plateforme de partage de vidéos au monde, hébergeant des milliards de vidéos et servant plus de 2 milliards d'utilisateurs connectés mensuellement.

Avec les capacités étendues de l'API YouTube, vous pouvez :

- **Rechercher du contenu** : trouver des vidéos pertinentes dans la vaste bibliothèque de YouTube en utilisant des mots-clés, filtres et paramètres spécifiques
- **Accéder aux métadonnées** : récupérer des informations détaillées sur les vidéos, y compris les titres, descriptions, nombres de vues et métriques d'engagement
- **Analyser les tendances** : identifier le contenu populaire et les sujets tendance dans des catégories ou régions spécifiques
- **Extraire des insights** : recueillir des données sur les préférences du public, la performance du contenu et les modèles d'engagement

Dans Sim, l'intégration YouTube permet à vos agents de rechercher et d'analyser programmatiquement le contenu YouTube dans le cadre de leurs flux de travail. Cela permet des scénarios d'automatisation puissants qui nécessitent des informations vidéo à jour. Vos agents peuvent rechercher des vidéos instructives, étudier les tendances de contenu, recueillir des informations à partir de chaînes éducatives ou surveiller des créateurs spécifiques pour de nouveaux téléchargements. Cette intégration comble le fossé entre vos flux de travail IA et le plus grand référentiel vidéo du monde, permettant des automatisations plus sophistiquées et conscientes du contenu. En connectant Sim avec YouTube, vous pouvez créer des agents qui restent à jour avec les dernières informations, fournissent des réponses plus précises et apportent plus de valeur aux utilisateurs - le tout sans nécessiter d'intervention manuelle ou de code personnalisé.
{/* MANUAL-CONTENT-END */}

## Instructions d'utilisation

Intégrez YouTube dans le flux de travail. Permet de rechercher des vidéos, obtenir les détails d'une vidéo, obtenir des informations sur une chaîne, récupérer toutes les vidéos d'une chaîne, obtenir les playlists d'une chaîne, récupérer les éléments d'une playlist, trouver des vidéos similaires et obtenir les commentaires d'une vidéo.

## Outils

### `youtube_search`

Recherchez des vidéos sur YouTube en utilisant l'API YouTube Data. Prend en charge le filtrage avancé par chaîne, plage de dates, durée, catégorie, qualité, sous-titres et plus encore.

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `query` | chaîne | Oui | Requête de recherche pour les vidéos YouTube |
| `maxResults` | nombre | Non | Nombre maximum de vidéos à retourner (1-50) |
| `apiKey` | chaîne | Oui | Clé API YouTube |
| `channelId` | chaîne | Non | Filtrer les résultats pour un ID de chaîne YouTube spécifique |
| `publishedAfter` | chaîne | Non | Ne renvoyer que les vidéos publiées après cette date (format RFC 3339 : "2024-01-01T00:00:00Z") |
| `publishedBefore` | chaîne | Non | Ne renvoyer que les vidéos publiées avant cette date (format RFC 3339 : "2024-01-01T00:00:00Z") |
| `videoDuration` | chaîne | Non | Filtrer par durée de vidéo : "short" (moins de 4 minutes), "medium" (4-20 minutes), "long" (plus de 20 minutes), "any" |
| `order` | chaîne | Non | Trier les résultats par : "date", "rating", "relevance" (par défaut), "title", "videoCount", "viewCount" |
| `videoCategoryId` | chaîne | Non | Filtrer par ID de catégorie YouTube (ex. : "10" pour Musique, "20" pour Jeux vidéo) |
| `videoDefinition` | chaîne | Non | Filtrer par qualité vidéo : "high" (HD), "standard", "any" |
| `videoCaption` | chaîne | Non | Filtrer par disponibilité des sous-titres : "closedCaption" (avec sous-titres), "none" (sans sous-titres), "any" |
| `regionCode` | chaîne | Non | Renvoyer des résultats pertinents pour une région spécifique (code pays ISO 3166-1 alpha-2, ex. : "US", "FR") |
| `relevanceLanguage` | chaîne | Non | Renvoyer les résultats les plus pertinents pour une langue (code ISO 639-1, ex. : "en", "fr") |
| `safeSearch` | chaîne | Non | Niveau de filtrage du contenu : "moderate" (par défaut), "none", "strict" |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `items` | tableau | Tableau de vidéos YouTube correspondant à la requête de recherche |

### `youtube_video_details`

Obtenir des informations détaillées sur une vidéo YouTube spécifique.

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `videoId` | chaîne | Oui | ID de la vidéo YouTube |
| `apiKey` | chaîne | Oui | Clé API YouTube |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `videoId` | chaîne | ID de la vidéo YouTube |
| `title` | chaîne | Titre de la vidéo |
| `description` | chaîne | Description de la vidéo |
| `channelId` | chaîne | ID de la chaîne |
| `channelTitle` | chaîne | Nom de la chaîne |
| `publishedAt` | chaîne | Date et heure de publication |
| `duration` | chaîne | Durée de la vidéo au format ISO 8601 |
| `viewCount` | nombre | Nombre de vues |
| `likeCount` | nombre | Nombre de j'aime |
| `commentCount` | nombre | Nombre de commentaires |
| `thumbnail` | chaîne | URL de la miniature de la vidéo |
| `tags` | tableau | Tags de la vidéo |

### `youtube_channel_info`

Obtenir des informations détaillées sur une chaîne YouTube.

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `channelId` | chaîne | Non | ID de la chaîne YouTube \(utilisez soit channelId soit username\) |
| `username` | chaîne | Non | Nom d'utilisateur de la chaîne YouTube \(utilisez soit channelId soit username\) |
| `apiKey` | chaîne | Oui | Clé API YouTube |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `channelId` | chaîne | ID de la chaîne YouTube |
| `title` | chaîne | Nom de la chaîne |
| `description` | chaîne | Description de la chaîne |
| `subscriberCount` | nombre | Nombre d'abonnés |
| `videoCount` | nombre | Nombre de vidéos |
| `viewCount` | nombre | Nombre total de vues de la chaîne |
| `publishedAt` | chaîne | Date de création de la chaîne |
| `thumbnail` | chaîne | URL de la miniature de la chaîne |
| `customUrl` | chaîne | URL personnalisée de la chaîne |

### `youtube_channel_videos`

Obtenir toutes les vidéos d'une chaîne YouTube spécifique, avec options de tri.

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `channelId` | chaîne | Oui | ID de la chaîne YouTube dont il faut récupérer les vidéos |
| `maxResults` | nombre | Non | Nombre maximum de vidéos à retourner \(1-50\) |
| `order` | chaîne | Non | Ordre de tri : "date" \(plus récentes d'abord\), "rating", "relevance", "title", "viewCount" |
| `pageToken` | chaîne | Non | Jeton de page pour la pagination |
| `apiKey` | chaîne | Oui | Clé API YouTube |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `items` | tableau | Tableau des vidéos de la chaîne |

### `youtube_channel_playlists`

Obtenir toutes les playlists d'une chaîne YouTube spécifique.

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `channelId` | chaîne | Oui | ID de la chaîne YouTube dont il faut récupérer les playlists |
| `maxResults` | nombre | Non | Nombre maximum de playlists à retourner \(1-50\) |
| `pageToken` | chaîne | Non | Jeton de page pour la pagination |
| `apiKey` | chaîne | Oui | Clé API YouTube |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `items` | tableau | Tableau des playlists de la chaîne |

### `youtube_playlist_items`

Obtenir les vidéos d'une playlist YouTube.

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `playlistId` | chaîne | Oui | ID de la playlist YouTube |
| `maxResults` | nombre | Non | Nombre maximum de vidéos à retourner |
| `pageToken` | chaîne | Non | Jeton de page pour la pagination |
| `apiKey` | chaîne | Oui | Clé API YouTube |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `items` | tableau | Tableau de vidéos dans la playlist |

### `youtube_comments`

Obtenir les commentaires d'une vidéo YouTube.

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `videoId` | chaîne | Oui | ID de la vidéo YouTube |
| `maxResults` | nombre | Non | Nombre maximum de commentaires à retourner |
| `order` | chaîne | Non | Ordre des commentaires : time (chronologique) ou relevance (pertinence) |
| `pageToken` | chaîne | Non | Jeton de page pour la pagination |
| `apiKey` | chaîne | Oui | Clé API YouTube |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `items` | tableau | Tableau des commentaires de la vidéo |

## Notes

- Catégorie : `tools`
- Type : `youtube`
