Docs    YouTube

Créer un flux de recherche YouTube

Souhaitez-vous que votre fil d'actualité YouTube affiche des vidéos correspondant à une recherche, plutôt que toutes les vidéos d'une seule chaîne ?

Dans ce guide, nous allons créer un flux de recherche, puis affiner les critères. Cela implique de choisir le mode de tri des résultats, la durée des vidéos, leur date de publication, et bien plus encore.

Conditions requises: les flux de recherche nécessitent une version payante de YouTube Feed ainsi qu’une clé API YouTube. Chaque recherche effectuée par le plugin est transmise avec votre clé ; sans celle-ci, le flux reste vide.

Avant de commencer, assurez-vous que YouTube Feed est bien installé et activé, et que vous avez ajouté votre clé API.

Remarque : vous êtes déjà dans l'éditeur et vous vous trouvez dans le champ « Terme de recherche » ? Pour savoir quoi saisir dans ce champ, consultez la section « Comment fonctionne le champ « Terme de recherche » ? ». Les étapes ci-dessous expliquent comment créer un flux de recherche à partir de zéro.

Créer votre flux de recherche

Pour commencer, rendez-vous dans « Flux YouTube » → « Tous les flux » dans votre tableau de bord WordPress.

Le menu d'administration de WordPress avec l'option « Flux YouTube », puis « Tous les flux » sélectionnée

Cliquez ensuite sur « Ajouter un nouvel élément ».

L'écran « Tous les flux » avec une flèche pointant vers le bouton « Ajouter un nouveau »

Ensuite, sélectionnez « Recherche » comme type de flux.

Remarque : la chaîne est déjà sélectionnée. Pour créer votre flux à partir de la recherche uniquement, cliquez dessus pour la désélectionner.

L'étape « Sélectionner le type de flux » avec l'option « Recherche » sélectionnée et une coche dans son coin

Saisissez maintenant ce que vous souhaitez rechercher dans le champ « Terme de recherche ». Nous allons utiliser « latte art » dans cet exemple. Cliquez ensuite sur « Suivant ».

Le champ « Terme de recherche » dans lequel est saisi « latte art », avec une flèche pointant vers le bouton « Suivant »

Choisissez ensuite un modèle pour la mise en page des vidéos. Tous sont compatibles avec un flux de recherche, et vous pourrez le modifier ultérieurement.

Nous allons utiliser « Cards ». Cliquez ensuite sur « Suivant » pour terminer.

L'étape du modèle avec l'option « Cartes » sélectionnée et une flèche pointant vers le bouton « Suivant »

Votre flux est créé et s'alimente immédiatement de vidéos correspondantes. Voici à quoi il ressemble une fois que vous l'avez ajouté à une page.

Une page publiée présentant le flux final sous la forme d'une grille de vidéos de « latte art » accompagnées de leurs titres et des noms des chaînes

Pour modifier les critères de recherche d'un flux que vous avez déjà créé, ouvrez le flux et accédez à Paramètres » Type de flux. Vous y trouverez le même champ « Terme de recherche ».

Ensuite, saisissez votre nouveau terme. Pour l'enregistrer, cliquez sur « Enregistrer ».

L'éditeur de flux affichant le champ « Terme de recherche » sous « Type de flux », avec une flèche pointant vers le bouton « Enregistrer »

Remarque : le bouton « Mettre à jour » situé à côté du champ actualise l'aperçu, ce qui vous permet de voir quelles vidéos le nouveau terme fait apparaître avant de le valider. Dans tous les cas, cliquer sur « Enregistrer » valide la modification.

Comment fonctionne le champ de recherche ?

Ce champ constitue l'intégralité de la recherche ; il est donc utile de savoir comment il traite ce que vous saisissez.

  • Les espaces ne posent aucun problème. Pour le « latte art », saisissez-le exactement comme vous le feriez dans la barre de recherche de YouTube.
  • Une virgule lance une deuxième recherche. Les termes « latte art » et « flat white » déclenchent deux recherches distinctes au lieu d’une seule. C’est ce que signifie l’indication fournie par le champ lui-même lorsqu’il est précisé de séparer les termes par des virgules. Les vidéos correspondant au premier terme remplissent le fil d’actualité. Celles correspondant au deuxième terme s’affichent ensuite.
  • Le signe moins exclut les vidéos. « latte art -tutorial » permet de trouver des vidéos sur le latte art qui ne mentionnent pas de tutoriels.
  • Le terme « pipe » désigne l'un ou l'autre. Les vidéos sur le « latte art » ou le « coffee art » traitent de l'un ou de l'autre.
  • Les guillemets sont supprimés. La recherche « latte art » s’effectue en tant que deux mots distincts ; ainsi, une expression entre guillemets donne les mêmes résultats qu’une expression sans guillemets.

Une recherche simple vous propose les résultats que YouTube juge les plus pertinents. Pour affiner votre recherche, ajoutez des filtres après vos mots-clés, dans le même champ.

Chaque filtre se compose d'un « & », d'un nom, d'un signe « = » et d'une valeur, sans espace de part et d'autre. Ainsi, pour afficher les vidéos de « latte art » les plus visionnées plutôt que les plus pertinentes, le champ se présente comme suit :

latte art&order=viewCount

Les filtres s'empilent, et leur ordre n'a pas d'importance. Celui-ci permet d'afficher les vidéos les plus visionnées dont la durée est comprise entre 4 et 20 minutes :

latte art&order=viewCount&videoDuration=medium

Voici les filtres qu'il faut connaître :

  • commandedate par ordre chronologique décroissant, viewCount pour les plus consultés, rating pour les mieux notés, ou title pour un classement alphabétique. Sans cette option, YouTube classe les résultats par pertinence, ce qui convient à la plupart des recherches thématiques.
  • durée de la vidéoshort pendant moins de 4 minutes, medium pour 4 à 20, long depuis plus de 20 ans.
  • publié le et publié avant — un moment dans le temps, exprimé sous forme de date, a T, l'heure et un Z, le tout dans une seule chaîne : 2026-01-01T00:00:00Z. En soi, publishedAfter vous offre tout depuis ce moment-là.
  • channelId — limite la recherche à un seul canal. Il s'agit de l'identifiant du canal, qui commence par UC, et non son @pseudo. Associé à des mots-clés, cette recherche ne permet de trouver que les vidéos de cette chaîne correspondant à ces mots-clés, ce qui, sur une petite chaîne, ne donne souvent aucun résultat.
  • type d'événementlive pour les diffusions en cours, upcoming pour celles qui sont programmées, completed pour ceux qui sont terminés.
  • vidéoDéfinitionhigh pour la HD uniquement.
  • légende de la vidéoclosedCaption pour les vidéos sous-titrées.
  • vidéo intégrabletrue pour les vidéos dont la lecture est autorisée en dehors de YouTube. Les flux diffusent les vidéos directement, ce qui exclut celles qui ne le permettent pas.
  • videoLicensecreativeCommon uniquement pour les vidéos sous licence Creative Commons.
  • code_région et pertinenceLangue — un code de pays ou de langue à deux lettres, tel que regionCode=GB ou relevanceLanguage=es, pour connaître les résultats en fonction de leur classement auprès de ce public.

Remarque : Le flux YouTube est toujours configuré type et maxResults pour vous, il n'est donc pas nécessaire d'ajouter l'un ou l'autre. Si vous en ajoutez un, ce paramètre sera envoyé deux fois. Le nombre de vidéos affichées dans votre flux est un paramètre défini dans le flux lui-même.

Créez votre terme de recherche

Au lieu de composer le texte manuellement, vous pouvez choisir ce que vous souhaitez voir apparaître dans le flux et copier le résultat. Tout ce qui suit s'exécute dans votre navigateur ; ainsi, rien de ce que vous saisissez n'est envoyé où que ce soit.

Que rechercher ?

Correspond au titre, à la description et aux mots-clés de la vidéo.
Séparez-les par des virgules ici. Une vidéo correspondant à l'un d'entre eux est éligible.
Séparer par des virgules ici.
L'identifiant de la chaîne, et non son @handle ni son URL. Il commence par UC.

Affiner la recherche

Plus de filtres
Code pays à deux lettres.
Code de langue à deux lettres.

Votre terme de recherche

Votre terme de recherche apparaît ici.

Collez ceci dans le flux Terme de recherche champ. Ne pas inclure type et maxResults, que le plugin définit lui-même.

Recherches que vous pouvez copier

Chacun de ces termes doit être saisi tel quel dans le champ « Terme de recherche ». Remplacez-les par vos propres mots.

  • Les dernières vidéos sur un sujet donnélatte art&order=date
  • Les vidéos les plus populaires sur un sujet donnélatte art&order=viewCount
  • Uniquement les vidéos pouvant être lues directement dans votre fil d'actualitélatte art&videoEmbeddable=true
  • Vidéos courtes, les plus récentes en premierlatte art&videoDuration=short&order=date
  • Les dernières vidéos d'une chaîne&channelId=UCxxxxxxxxxxxxxxxxxxxxxx&order=date
    C'est le seul cas qui commence par &: comme il n'y a pas de mots-clés, le champ s'ouvre directement sur un filtre.
  • Un fil d'actualité couvrant 2 sujetslatte art,flat white
    Chaque terme fait l'objet d'une recherche distincte. Les vidéos correspondant au premier terme s'affichent en premier. Pour afficher également celles correspondant au deuxième terme, augmentez le nombre de vidéos affichées dans le flux.
  • Vidéos publiées après la date de votre choixlatte art&publishedAfter=2026-01-01T00:00:00Z
  • Diffusions en direct en courslatte art&eventType=live
    Cela dépend du fait que quelqu'un diffuse un contenu en direct sur votre sujet à ce moment-là ; une recherche de niche reste donc vide tant qu'aucun flux n'a commencé.
  • Vidéos sous licence Creative Commons que vous pouvez réutiliserlatte art&videoLicense=creativeCommon

Trois petites erreurs peuvent empêcher une recherche de fonctionner, et aucune d'entre elles ne génère de message d'erreur. Chacune présente des symptômes qui lui sont propres ; commencez donc par celle qui correspond à ce que vous observez.

Un flux vide, issu d'une recherche commençant par &q=. Le champ correspond déjà au terme de recherche. Écriture &q=latte art envoie une requête vide et une vraie, et YouTube ne renvoie aucun résultat.

Les instructions plus anciennes utilisaient exactement ce format ; il est donc conseillé de vérifier toute recherche que vous auriez copiée ailleurs. Vos mots doivent apparaître en premier, à part.

Un filtre qui ne fait rien, simplement parce qu'il est placé après une virgule. Comme une virgule lance une deuxième recherche, un filtre placé après celle-ci est alors interprété comme des mots-clés. latte art,order=date recherches sur le « latte art », puis sur les mots « order=date ». Rien n'est classé par date.

Les filtres viennent après le signe « & », donc latte art&order=date C'est la version qui fonctionne.

Une correspondance approximative de mots-clés, obtenue en plaçant une expression entre guillemets. Les guillemets sont supprimés avant le lancement de la recherche ; les mots qu'ils renferment sont donc recherchés séparément. Les résultats sont identiques à ceux obtenus sans guillemets.

Pour affiner les résultats, ajoutez un mot plus précis ou supprimez un mot en l'accompagnant d'un signe moins, comme dans latte art -tutorial.

Et voilà ! Vous savez désormais comment créer un flux de recherche YouTube et définir précisément les vidéos qui y apparaissent. Découvrez ensuite notre guide sur l'affichage de votre flux à l'aide d'un shortcode afin de l'ajouter à d'autres pages de votre site.

Questions fréquemment posées

Vous trouverez ci-dessous les réponses à certaines des questions les plus fréquentes concernant les flux de recherche YouTube.

Pourquoi mon flux de recherche est-il vide ?

La plupart des flux de recherche vides s'expliquent par deux causes. La première est l'absence de clé API, car chaque recherche est envoyée avec celle-ci. La seconde est un terme de recherche écrit sous la forme &q=your words, qui envoie une requête vide en plus de la vraie. Pour y remédier, supprimez le &q= pour que tes mots ressortent d'eux-mêmes.

Pourquoi mon fil d'actualité affiche-t-il des vidéos qui n'ont aucun rapport avec ma recherche ?

Commencez par rechercher une virgule dans le champ « Terme de recherche ». Tout ce qui suit la virgule constitue une deuxième recherche distincte. Ses résultats s'ajoutent à ceux du premier terme. Ils apparaissent à la fin, dès que le flux affiche davantage de vidéos que celles trouvées lors de la première recherche. Si le texte suivant la virgule était destiné à servir de filtre, il doit plutôt être placé après un « & », comme dans latte art&order=date.

Puis-je effectuer une recherche sur une seule chaîne ?

Oui. Ajouter &channelId= suivi par le identifiant de la chaîne, qui commence par UC. Un @handle ou une URL de canal ne fonctionnera pas à la place.

Comment rechercher une expression exacte ?

Les guillemets sont supprimés avant le lancement de la recherche, donc "latte art" et latte art afficher les mêmes vidéos. Pour affiner une recherche sur une expression générale, ajoutez un mot qui la précise, ou excluez-en un à l'aide du signe moins, comme dans latte art -tutorial.

Puis-je trier les résultats de recherche comme je le souhaite ?

Vous pouvez trier les résultats par date, nombre de vues, note ou titre à l'aide de la order filtre. Tout ce qui ne relève pas de ces 4 critères est déterminé par le classement par pertinence propre à YouTube, qui correspond au résultat obtenu lorsque vous quittez order . Le tri s'effectue au cours de la recherche elle-même, donc order=date C'est ce qui permet à YouTube de proposer les vidéos les plus récentes correspondant à la recherche. Dans un flux de recherche, l'option de tri « Les plus récentes » propre à ce flux conserve l'ordre dans lequel les résultats ont été affichés.

soutien

Vous n'avez pas trouvé votre réponse dans la documentation ?

Contacter le support