youtube/
hashtag-search

Trouvez des vidéos YouTube publiques à partir d’un ou plusieurs hashtags, avec titres, identité de la chaîne, miniatures, durée, engagement et hashtag source, sous forme d’enregistrements normalisés.

YouTube Hashtag Search API

Flux de hashtags
Filtre Shorts
Hashtags sources
0,5 crédit par résultat
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 Hashtag Search

Un flux de hashtag YouTube regroupe des vidéos publiques liées à un sujet, avec titres, descriptions, identité de la chaîne, miniatures, durée, informations de publication et engagement visible. Ces enregistrements servent à cartographier des thèmes, à vérifier la participation à une campagne, à échantillonner des Shorts et à comparer des contenus.

Fonctionnalités de la YouTube Hashtag Search API

  • Découverte par flux de hashtagTrouvez les vidéos publiques associées à un hashtag sans fournir d’URL de vidéo ni de chaîne.
  • Modes tous contenus et ShortsRéglez content_type sur all pour le flux de hashtag tel qu’exposé, ou sur shorts pour un échantillon limité aux Shorts.
  • Contexte de la vidéo et de la chaîneTitres, descriptions, identité de la chaîne, miniatures, durée, informations de publication et nombres visibles de vues, de mentions « J’aime » et de commentaires sont renvoyés.
  • Hashtag source conservéChaque enregistrement sauvegardé inclut le hashtag source normalisé retenu pour ce résultat vidéo.

Paramètres de la YouTube Hashtag Search API

ParamètresObligatoireDescription
hashtagsObligatoireUn ou plusieurs hashtags non vides. Un # initial est facultatif et retiré avant la collecte.
results_limitFacultatifNombre maximal de vidéos à collecter par hashtag, de 20 à 2 000 ; vaut 100 par défaut.
content_typeFacultatifMode de contenu : all pour le flux de hashtag tel qu’exposé, shorts pour des résultats limités aux Shorts ; vaut all par défaut.

Comment utiliser la YouTube Hashtag Search API

Choisissez des hashtags qui délimitent bien les sujets à examiner, puis gardez le même mode de contenu et la même limite par hashtag quand il faut comparer des échantillons.

  1. Préparez un ou plusieurs hashtags non vides, avec ou sans # initial, et sélectionnez all ou shorts.
  2. Envoyez hashtags, results_limit et content_type en POST à /v1/youtube/hashtag-search.
  3. Conservez le task_id renvoyé et interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez les vidéos normalisées dans data.results.items et poursuivez avec next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/hashtag-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["#technology"],"results_limit":20,"content_type":"shorts"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la YouTube Hashtag Search API

  • Contrôle de la participation à une campagne : Appuyez-vous sur des échantillons de flux de hashtag, les descriptions des vidéos, l’identité des chaînes et l’engagement visible pour vérifier qui participe publiquement à une campagne.
  • Échantillonnage de Shorts par sujet : Sélectionnez shorts pour constituer un échantillon ciblé de vidéos au format court rattachées à un hashtag.
  • Préparation de jeux de données thématiques : Assemblez ID de vidéos, URL, informations de publication, contexte des chaînes, indicateurs et hashtags sources conservés en jeux de données de recherche structurés.

Conseils d’expert pour la YouTube Hashtag Search API

  • Normalisez votre liste avant l’envoi, afin que #technology et technology ne déclenchent pas deux fois le même travail de collecte.
  • Utilisez un seul hashtag par tâche si l’attribution entre flux qui se recoupent compte : un ID de vidéo en double n’est sauvegardé qu’une fois et ne garde qu’un seul hashtag source.
  • Voyez results_limit comme un plafond par hashtag ; la collecte peut s’arrêter plus tôt si le flux se termine ou expose moins de vidéos éligibles.
  • Séparez les échantillons all et shorts quand vous comparez des formats, pour qu’un flux mixte ne fausse pas le sous-ensemble des formats courts.
  • Stockez les URL de miniatures et de sources comme des références, sans supposer qu’il s’agit de téléchargements de médias permanents.

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

  • YouTube Comments API — Collectez les commentaires publics, auteurs, l’engagement, vidéos sources et le contexte de la conversation.
  • YouTube Videos API — Récupérez les métadonnées, miniatures, durée et l’engagement à partir d’URL de vidéos ou de Shorts connues.
  • YouTube Shorts API — Collectez par chaîne les Shorts publics, miniatures, durée, informations de publication et l’engagement.
  • YouTube Search API — Recherchez des vidéos publiques classiques par mot-clé avec filtres de métadonnées pris en charge.
  • 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 Hashtag Search API — FAQ

YouTube Hashtag Search API est une interface programmatique pour trouver les vidéos publiques associées à un ou plusieurs hashtags. Elle renvoie des champs normalisés de vidéo et de chaîne, des miniatures, la durée, les informations de publication, l’engagement visible et un hashtag source conservé.

Envoyez un tableau non vide de chaînes, comme technology ou #technology. Le # initial est facultatif et retiré avant la collecte.

Oui. Réglez content_type sur shorts pour n’obtenir que des Shorts, ou laissez le mode all par défaut pour le flux de hashtag tel qu’exposé.

results_limit s’applique séparément à chaque hashtag envoyé, vaut 100 par défaut et accepte les entiers de 20 à 2 000. Le flux exposé ou le plafond de collecte de 100 pages peuvent produire moins d’enregistrements.

Les ID de vidéo ou URL répétés ne sont sauvegardés qu’une fois dans une tâche. Si l’attribution exacte au flux compte, envoyez les hashtags dans des tâches distinctes, car un enregistrement sauvegardé ne garde qu’un seul hashtag source.

Chaque vidéo normalisée sauvegardée coûte 0,5 crédit, sans frais de base. L’estimation de la requête multiplie results_limit, ou sa valeur par défaut de 100, par le nombre de hashtags ; l’utilisation finale suit le nombre réel d’enregistrements sauvegardés, et un jeu de résultats vide n’entraîne aucun frais de résultat.