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ètres | Obligatoire | Description |
|---|---|---|
hashtags | Obligatoire | Un ou plusieurs hashtags non vides. Un # initial est facultatif et retiré avant la collecte. |
results_limit | Facultatif | Nombre maximal de vidéos à collecter par hashtag, de 20 à 2 000 ; vaut 100 par défaut. |
content_type | Facultatif | Mode 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.
- Préparez un ou plusieurs hashtags non vides, avec ou sans # initial, et sélectionnez all ou shorts.
- Envoyez hashtags, results_limit et content_type en POST à /v1/youtube/hashtag-search.
- Conservez le task_id renvoyé et interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- 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 trueCas 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.
API associées
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.
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API