YouTube Hashtag Search
YouTube-Hashtag-Feeds sind öffentliche Videosammlungen zu einem Themen-Hashtag, mit Titeln, Beschreibungen, Kanalidentität, Vorschaubildern, Dauer, Angaben zur Veröffentlichung und sichtbarer Interaktion. Diese Datensätze unterstützen die Themenkartierung, die Prüfung der Teilnahme an Kampagnen, die Stichprobenerhebung bei Shorts und vergleichende Inhaltsanalysen.
Funktionen der YouTube Hashtag Search API
- Entdeckung über Hashtag-FeedsFinden Sie öffentliche Videos zu einem Hashtag, ohne Video- oder Kanal-URLs angeben zu müssen.
- Modus für alle Inhalte und für ShortsSetzen Sie content_type auf all für den verfügbaren Hashtag-Feed oder auf shorts für eine Stichprobe nur mit Shorts.
- Video- und KanalkontextLiefert Titel, Beschreibungen, Kanalidentität, Vorschaubilder, Dauer, Angaben zur Veröffentlichung sowie die sichtbaren Zahlen zu Aufrufen, „Gefällt mir“-Angaben und Kommentaren.
- Gespeicherter Quell-HashtagJeder gespeicherte Datensatz enthält den normalisierten Quell-Hashtag, der für dieses Videoergebnis beibehalten wurde.
Parameter der YouTube Hashtag Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
hashtags | Erforderlich | Ein oder mehrere nicht leere Hashtags. Ein führendes # ist optional und wird vor der Erfassung entfernt. |
results_limit | Optional | Maximale Anzahl an Videos pro Hashtag, von 20 bis 2.000; der Standardwert ist 100. |
content_type | Optional | Inhaltsmodus: all für den verfügbaren Hashtag-Feed oder shorts für Ergebnisse nur mit Shorts; der Standardwert ist all. |
So verwenden Sie die YouTube Hashtag Search API
Wählen Sie Hashtags, die die Themengrenzen abbilden, die Sie untersuchen möchten, und halten Sie Inhaltsmodus und Limit pro Hashtag konstant, wenn Stichproben verglichen werden sollen.
- Bereiten Sie einen oder mehrere nicht leere Hashtags vor, mit oder ohne führendes #, und wählen Sie all oder shorts.
- Senden Sie hashtags, results_limit und content_type per POST an /v1/youtube/hashtag-search.
- Speichern Sie die zurückgegebene task_id und fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder fehlschlägt.
- Lesen Sie die normalisierten Videos aus data.results.items und fahren Sie mit next_cursor fort, solange has_more den Wert true hat.
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 trueAnwendungsfälle der YouTube Hashtag Search API
- Prüfung der Teilnahme an Kampagnen: Nutzen Sie Stichproben aus Hashtag-Feeds, Videobeschreibungen, Kanalidentität und sichtbare Interaktion, um die öffentliche Teilnahme an Kampagnen zu prüfen.
- Themenstichproben bei Shorts: Wählen Sie shorts, um eine gezielte Stichprobe von Kurzvideos zu einem Themen-Hashtag aufzubauen.
- Aufbereitung von Themendatensätzen: Verbinden Sie Video-IDs, URLs, Angaben zur Veröffentlichung, Kanalkontext, Kennzahlen und gespeicherte Quell-Hashtags zu strukturierten Forschungsdatensätzen.
Profi-Tipps zur YouTube Hashtag Search API
- Normalisieren Sie Ihre Eingabeliste vor dem Senden, damit #technology und technology keine doppelte Erfassungsarbeit auslösen.
- Nutzen Sie einen Hashtag pro Aufgabe, wenn die Zuordnung über sich überschneidende Feeds hinweg wichtig ist, denn doppelte Video-IDs werden nur einmal gespeichert und behalten einen Quell-Hashtag.
- Behandeln Sie results_limit als Obergrenze pro Hashtag; die Erfassung kann früher enden, wenn der Feed endet oder weniger infrage kommende Videos bereitstellt.
- Halten Sie Stichproben mit all und shorts getrennt, wenn Sie Formate vergleichen, damit ein gemischter Feed die Teilmenge der Kurzvideos nicht verfälscht.
- Speichern Sie Vorschaubild- und Quell-URLs als Verweise und gehen Sie nicht davon aus, dass es sich um dauerhafte Mediendownloads handelt.
Verwandte APIs
Ergänzend zur YouTube Hashtag Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher YouTube-Daten benötigen.
- YouTube Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Quellvideos und Gesprächskontext erfassen.
- YouTube Videos API — Metadaten, Thumbnails, Dauer und Interaktionen zu bekannten Video- oder Short-URLs abrufen.
- YouTube Shorts API — Öffentliche Shorts, Thumbnails, Dauer, Veröffentlichungsdetails und Interaktionen pro Kanal erfassen.
- YouTube Search API — Öffentliche reguläre Videos per Keyword suchen – mit unterstützten Metadatenfiltern.
- YouTube Channel Search API — Kanäle per Keyword finden – mit Namen, Abonnentenzahlen, Avataren und Beschreibungsauszügen.
- YouTube Shorts Search API — Shorts per Keyword suchen – mit Links, Beschreibungen, Aufrufzahlen und Vorschaubildern im Hochformat.
- 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