> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube API

> Recherchez sur YouTube et lisez en JSON des vidéos, des commentaires, des chaînes, les mises en ligne d’une chaîne et des transcriptions, avec vues, mentions J’aime, dates de publication, chapitres et texte des sous-titres.

Lisez les données publiques de YouTube en JSON via l’API de tâches asynchrones. Envoyez `taskType` `SOCIAL` avec `platform` `youtube`, et choisissez ce que vous lisez avec `action`. Une requête terminée coûte **0.5 crédit**.

## Requête

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "SOCIAL", "payload": { "platform": "youtube", "action": "search", "query": "wireless earbuds review", "limit": 10 } }'
```

Soumettez la tâche, puis interrogez `GET /v1/async/task/{id}` ou recevez son webhook. Voir [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md).

## Actions

| `action` | Contenu lu | Obligatoire |
| - | - | - |
| `search` (par défaut) | Les résultats de recherche YouTube | `query` |
| `recent` | Les dernières mises en ligne pour une requête, des plus récentes aux plus anciennes | `query` |
| `video` | La page de lecture d’une vidéo | `videoId` |
| `comments` | Les commentaires d’une vidéo et leurs réponses | `videoId` |
| `channel` | Les informations et les liens d’une chaîne | `channel` |
| `channel_videos` | Les vidéos, Shorts ou diffusions en direct d’une chaîne | `channel` |
| `transcript` | Les sous-titres d’une vidéo | `videoId` |

`videoId` accepte un identifiant de vidéo ou une URL de vidéo YouTube (lecture, `youtu.be`, Shorts ou intégration). `channel` accepte un identifiant de chaîne (`UC...`), un `@handle` ou une URL de chaîne.

## Paramètres

`search` et `recent` :

* `query` : obligatoire. La requête de recherche.
* `limit` : entier facultatif de 1 à 50, avec 10 par défaut.
* `type` : `video` (par défaut), `all`, `shorts`, `channel`, `playlist` ou `movie`.
* `order` : `relevance` (par défaut), `viewCount`, `date` ou `rating`. `date` liste les mises en ligne des plus récentes aux plus anciennes, comme `recent`. `rating` trie par nombre de mentions J’aime les résultats les plus vus de YouTube. Les recherches `channel` et `playlist` acceptent `relevance` ou `viewCount`.
* `publishedAfter` : une date ISO 8601, comme `2026-11-01T00:00:00Z`. Renvoie les vidéos publiées après cette date.
* `videoDuration` : `short` (moins de 3 minutes), `medium` (de 3 à 20 minutes) ou `long` (plus de 20 minutes).
* `features` : n’importe lesquelles de `live`, `4k`, `hd`, `subtitles`, `creative_commons`, `360`, `vr180`, `3d`, `hdr`, `location` et `purchased`, sous forme de tableau ou de chaîne séparée par des virgules.
* `exactSpelling` : `true` recherche la requête telle qu’elle est écrite, sans la correction orthographique de YouTube.
* `pageToken` : le `nextPageToken` de la page précédente. Les recherches de vidéos triées par `relevance` ou `viewCount` sans `publishedAfter` en renvoient un, et chaque page saute toutes les vidéos que les pages précédentes ont renvoyées.
* `regionCode` et `languageCode` : la région YouTube (`US`, `KR`, `JP`) et la langue de l’interface (`en`, `ko`, `ja`) de la recherche.

`comments` :

* `limit` : entier facultatif de 1 à 500, avec 100 par défaut. Les réponses comptent dans la limite.
* `order` : `relevance` (par défaut, les meilleurs commentaires selon YouTube) ou `time` (les plus récents d’abord).
* `includeReplies` : facultatif, `true` par défaut.

`channel_videos` :

* `tab` : `videos` (par défaut), `shorts` ou `streams`.
* `sort` : `latest` (par défaut), `popular` ou `oldest`.
* `limit` : entier facultatif de 1 à 50, avec 20 par défaut.

`transcript` :

* `languages` : les langues de sous-titres par ordre de préférence, comme `["en", "ko"]`. Sans ce paramètre, la lecture prend les sous-titres par défaut de la vidéo, puis l’anglais, puis la première piste.
* `isGenerated` : `true` ne lit que les sous-titres automatiques, `false` que ceux de l’auteur de la vidéo.
* `trackName` : le nom de la piste de sous-titres à lire.
* `translateTo` : un code de langue. YouTube traduit les sous-titres dans cette langue.
* `maxSegments` : entier facultatif de 1 à 5 000, avec 2 000 par défaut.

## Exemple de réponse

```json theme={"theme":"css-variables"}
{
  "platform": "youtube",
  "action": "search",
  "query": "wireless earbuds review",
  "order": "relevance",
  "totalResults": 4523475,
  "returnedCount": 1,
  "videos": [
    {
      "position": 1,
      "videoId": "YdJh6QdOGME",
      "url": "https://www.youtube.com/watch?v=YdJh6QdOGME",
      "title": "Earbuds Awards 2026 - Best Bluetooth Earbuds by Category!",
      "channelId": "UCZZ4ivUawsXRktLKej8d6Xw",
      "channelTitle": "Mike O'Brien",
      "channelHandle": "@MikeOBrienMedia",
      "channelIsVerified": true,
      "publishedAt": "2026-11-17T15:39:37Z",
      "publishedTimeText": "21 hours ago",
      "duration": "PT16M35S",
      "durationSeconds": 995,
      "viewCount": 62618,
      "likeCount": 957,
      "category": "Science & Technology",
      "badges": ["New"],
      "thumbnails": { "high": "https://i.ytimg.com/vi/YdJh6QdOGME/hqdefault.jpg" }
    }
  ],
  "nextPageToken": "eyJyIjpbIllkSmg2UWRPR01FIl19"
}
```

## Champs du résultat

* Chaque réponse reprend `platform` et `action`. Les listes portent `returnedCount`.
* `search` et `recent` renvoient `videos`. Chaque vidéo a `position`, `videoId`, `url`, `title`, `description`, les `channelId`, `channelTitle`, `channelHandle`, `channelUrl`, `channelThumbnail` et `channelIsVerified` de la chaîne, `publishedAt`, `publishedTimeText`, `duration` (ISO 8601), `durationSeconds`, `viewCount`, `likeCount`, `category`, `thumbnails`, `richThumbnail` (l’aperçu animé), `badges` et `isFamilySafe`. Un film ajoute `movie` avec son affiche, son genre, son année, sa distribution et son réalisateur.
* Une recherche renvoie aussi les `channels`, `playlists`, `shorts` et `shelves` que montre la page de résultats, `totalResults` (l’estimation de YouTube), ainsi que `didYouMean` ou `showingResultsFor` quand YouTube corrige la requête.
* `video` ajoute `tags`, `commentCount`, `subscriberCount`, `hasCaptions`, `chapters`, `mostReplayed`, `music`, `descriptionLinks` et `relatedVideos`. Les chapitres de l’auteur viennent en premier, et les chapitres automatiques portent `autoGenerated: true`.
* `comments` renvoie `comments`, chacun avec `commentId`, `parentId` (`null` pour un commentaire de premier niveau), `text`, `authorDisplayName`, `authorChannelId`, `authorProfileImageUrl`, `authorIsVerified`, `authorIsChannelOwner`, `isPinned`, `isHearted`, `likeCount`, `replyCount`, `publishedAt` et `updatedAt`. `totalCount` est le nombre affiché par YouTube, et `topLevelCount` et `replyCount` répartissent `returnedCount`.
* `channel` renvoie `channelId`, `title`, `handle`, `description`, `country`, `publishedAt`, `subscriberCount`, `videoCount`, `viewCount`, `isVerified`, `keywords`, `links`, `thumbnails`, `bannerUrl`, `rssUrl` et `uploadsPlaylistId`.
* `channel_videos` renvoie `videos` dans l’ordre de `sort`, avec le `channelId` et le `channelTitle` de la chaîne.
* `transcript` renvoie le `text` des sous-titres, les `segments` horodatés (`start` et `duration` en secondes), la `language` lue et les `availableLanguages`. `truncated: true` signale une transcription coupée à `maxSegments`.
* Une vidéo dont les mentions J’aime sont masquées porte `likesHidden: true`, et une vidéo aux commentaires désactivés porte `commentsDisabled: true`. Une vidéo réservée aux membres porte `membersOnly: true` et n’a pas de `viewCount`.
* Une vidéo, une chaîne ou une piste de sous-titres qui n’existe pas, ou qui exige un spectateur connecté, comme une vidéo soumise à une limite d’âge, termine la tâche avec `PAGE_UNAVAILABLE`. Des paramètres incompatibles la terminent avec `BAD_PAYLOAD`. Seules les requêtes terminées sont facturées.

## Voir aussi

* [Instagram](https://docs.querying.ai/fr/engines/instagram.md)
* [Threads](https://docs.querying.ai/fr/engines/threads.md)
* [Vue d’ensemble des moteurs](https://docs.querying.ai/fr/engines/overview.md)
* [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.