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
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,playlistoumovie.order:relevance(par défaut),viewCount,dateourating.dateliste les mises en ligne des plus récentes aux plus anciennes, commerecent.ratingtrie par nombre de mentions J’aime les résultats les plus vus de YouTube. Les rechercheschanneletplaylistacceptentrelevanceouviewCount.publishedAfter: une date ISO 8601, comme2026-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) oulong(plus de 20 minutes).features: n’importe lesquelles delive,4k,hd,subtitles,creative_commons,360,vr180,3d,hdr,locationetpurchased, sous forme de tableau ou de chaîne séparée par des virgules.exactSpelling:truerecherche la requête telle qu’elle est écrite, sans la correction orthographique de YouTube.pageToken: lenextPageTokende la page précédente. Les recherches de vidéos triées parrelevanceouviewCountsanspublishedAfteren renvoient un, et chaque page saute toutes les vidéos que les pages précédentes ont renvoyées.regionCodeetlanguageCode: 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) outime(les plus récents d’abord).includeReplies: facultatif,truepar défaut.
channel_videos :
tab:videos(par défaut),shortsoustreams.sort:latest(par défaut),popularouoldest.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:truene lit que les sous-titres automatiques,falseque 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
platformetaction. Les listes portentreturnedCount. searchetrecentrenvoientvideos. Chaque vidéo aposition,videoId,url,title,description, leschannelId,channelTitle,channelHandle,channelUrl,channelThumbnailetchannelIsVerifiedde la chaîne,publishedAt,publishedTimeText,duration(ISO 8601),durationSeconds,viewCount,likeCount,category,thumbnails,richThumbnail(l’aperçu animé),badgesetisFamilySafe. Un film ajoutemovieavec son affiche, son genre, son année, sa distribution et son réalisateur.- Une recherche renvoie aussi les
channels,playlists,shortsetshelvesque montre la page de résultats,totalResults(l’estimation de YouTube), ainsi quedidYouMeanoushowingResultsForquand YouTube corrige la requête. videoajoutetags,commentCount,subscriberCount,hasCaptions,chapters,mostReplayed,music,descriptionLinksetrelatedVideos. Les chapitres de l’auteur viennent en premier, et les chapitres automatiques portentautoGenerated: true.commentsrenvoiecomments, chacun aveccommentId,parentId(nullpour un commentaire de premier niveau),text,authorDisplayName,authorChannelId,authorProfileImageUrl,authorIsVerified,authorIsChannelOwner,isPinned,isHearted,likeCount,replyCount,publishedAtetupdatedAt.totalCountest le nombre affiché par YouTube, ettopLevelCountetreplyCountrépartissentreturnedCount.channelrenvoiechannelId,title,handle,description,country,publishedAt,subscriberCount,videoCount,viewCount,isVerified,keywords,links,thumbnails,bannerUrl,rssUrletuploadsPlaylistId.channel_videosrenvoievideosdans l’ordre desort, avec lechannelIdet lechannelTitlede la chaîne.transcriptrenvoie letextdes sous-titres, lessegmentshorodatés (startetdurationen secondes), lalanguagelue et lesavailableLanguages.truncated: truesignale 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 portecommentsDisabled: true. Une vidéo réservée aux membres portemembersOnly: trueet n’a pas deviewCount. - 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 avecBAD_PAYLOAD. Seules les requêtes terminées sont facturées.