Passer au contenu principal
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

Soumettez la tâche, puis interrogez GET /v1/async/task/{id} ou recevez son webhook. Voir Tâches asynchrones.

Actions

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

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