youtube/
search-suggestions

Obtenez les suggestions d’autocomplétion que la barre de recherche de YouTube propose pour une requête partielle, classées comme les spectateurs les voient, pour la langue et la région de votre choix.

YouTube Search Suggestions API

Autocomplétion
Langue et région
Prix fixe par requête
0,5 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

YouTube Search Suggestions

Les suggestions de recherche sont les complétions que la barre de recherche de YouTube propose pendant qu’un spectateur tape encore, classées selon sa langue et son pays. Elles montrent la formulation réelle de la demande autour d’un terme de départ, ce qui en fait une source directe pour la recherche de mots-clés, les titres de vidéos, les tags et les idées de contenu.

Fonctionnalités de la YouTube Search Suggestions API

  • L’ordre vu par les spectateursrank indique la position de chaque suggestion dans la liste déroulante, à partir de 1 pour la première complétion.
  • Choix du marchélanguage et region basculent les suggestions vers un autre marché, par exemple es et MX pour les recherches en espagnol du Mexique.
  • Un lien de recherche pour chaque expressionChaque suggestion est accompagnée de l’URL des résultats YouTube pour cette expression, ainsi que de la requête de départ et du marché utilisés.

Paramètres de la YouTube Search Suggestions API

ParamètresObligatoireDescription
queryObligatoireLe début d’une recherche à compléter, jusqu’à 100 caractères.
languageFacultatifCode de langue des suggestions, par exemple en, es ou pt-BR. Valeur par défaut : en.
regionFacultatifCode pays à deux lettres du marché de recherche, par exemple US ou GB. Valeur par défaut : US.

Comment utiliser la YouTube Search Suggestions API

Envoyez le début d’une recherche et récupérez les complétions classées.

  1. Envoyez {"query": "iphone 17"} en POST à /v1/youtube/search-suggestions, en ajoutant language et region pour un autre marché.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les suggestions dans results.items par ordre de rang ; suivez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"iphone 17"}'

# Each item is one suggestion: keyword, rank, language and region.

Cas d’usage de la YouTube Search Suggestions API

  • Élargissement d’un mot-clé de départ : Collectez les complétions d’un nom de produit ou de sujet pour trouver les expressions plus longues que les spectateurs recherchent réellement.
  • Rédaction de titres alignés sur la recherche : Reprenez la formulation des suggestions les mieux classées pour que le titre d’une vidéo reflète la façon dont les gens tapent la requête.
  • Comparaison de la demande entre marchés : Lancez le même terme de départ avec différentes valeurs de language et de region pour voir comment l’intention change d’un pays à l’autre.

Conseils d’expert pour la YouTube Search Suggestions API

  • Ajoutez une lettre après le terme de départ, par exemple iphone 17 a, pour obtenir des complétions qui se poursuivent avec cette lettre.
  • Gardez language et region identiques lorsque vous suivez un terme dans le temps, car chaque marché renvoie sa propre liste.

En complément de la YouTube Search Suggestions API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques YouTube.

  • YouTube Channel Videos API — Collectez les vidéos publiques classiques à partir d’URL de chaînes, hors Shorts et lives.
  • YouTube Comments API — Collectez les commentaires publics, auteurs, l’engagement, vidéos sources et le contexte de la conversation.
  • YouTube Search API — Recherchez des vidéos publiques classiques par mot-clé avec filtres de métadonnées pris en charge.
  • YouTube Hashtag Search API — Trouvez des vidéos publiques dans les fils de hashtags, pour tous les contenus ou uniquement les Shorts.
  • YouTube Channel Search API — Trouvez des chaînes par mot-clé, avec noms, nombres d’abonnés, avatars et extraits de description.
  • YouTube Shorts Search API — Recherchez des Shorts par mot-clé, avec liens, légendes, nombres de vues et miniatures verticales.

Explorer d’autres plateformes

Combinez les données YouTube avec les données publiques d’autres plateformes sociales prises en charge.

YouTube Search Suggestions API — FAQ

YouTube Search Suggestions API est une interface programmatique qui récupère les suggestions d’autocomplétion de la recherche YouTube pour une requête partielle, dans la langue et la région choisies. Elle renvoie chaque expression suggérée avec son rang.

Oui. Les suggestions sont les complétions que la barre de recherche de YouTube affiche pendant la saisie, renvoyées dans le même ordre.

Autant que YouTube en propose pour cette requête, généralement une douzaine.

L’API officielle Data API n’a aucun endpoint d’autocomplétion ou de saisie semi-automatique. Cet endpoint renvoie les suggestions affichées par la barre de recherche de YouTube, classées pour la langue et la région de votre choix.

Chaque requête coûte un forfait de 0,5 crédit, quel que soit le nombre de suggestions renvoyées.