youtube/
hashtag-search

Öffentliche YouTube-Videos über einen oder mehrere Hashtags finden – mit Titeln, Kanalidentität, Vorschaubildern, Dauer, Interaktion und Kontext des Quell-Hashtags als normalisierte Datensätze.

YouTube Hashtag Search API

Hashtag-Feeds
Shorts-Filter
Quell-Hashtags
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
hashtagsErforderlichEin oder mehrere nicht leere Hashtags. Ein führendes # ist optional und wird vor der Erfassung entfernt.
results_limitOptionalMaximale Anzahl an Videos pro Hashtag, von 20 bis 2.000; der Standardwert ist 100.
content_typeOptionalInhaltsmodus: 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.

  1. Bereiten Sie einen oder mehrere nicht leere Hashtags vor, mit oder ohne führendes #, und wählen Sie all oder shorts.
  2. Senden Sie hashtags, results_limit und content_type per POST an /v1/youtube/hashtag-search.
  3. Speichern Sie die zurückgegebene task_id und fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder fehlschlägt.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie YouTube-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

YouTube Hashtag Search API — FAQ

YouTube Hashtag Search API ist eine Schnittstelle zum Finden öffentlicher Videos zu einem oder mehreren Hashtags. Sie liefert normalisierte Video- und Kanalfelder, Vorschaubilder, Dauer, Angaben zur Veröffentlichung, sichtbare Interaktion und einen gespeicherten Quell-Hashtag.

Senden Sie ein nicht leeres Array aus Zeichenfolgen wie technology oder #technology. Das führende # ist optional und wird vor der Erfassung entfernt.

Ja. Setzen Sie content_type auf shorts für Ergebnisse nur mit Shorts oder lassen Sie den Standardmodus all für den verfügbaren Hashtag-Feed.

results_limit gilt separat für jeden übergebenen Hashtag, hat den Standardwert 100 und akzeptiert ganze Zahlen von 20 bis 2.000. Der verfügbare Feed oder die Obergrenze von 100 Seiten bei der Erfassung kann zu weniger Datensätzen führen.

Wiederholte Video-IDs oder URLs werden innerhalb einer Aufgabe nur einmal gespeichert. Wenn die genaue Zuordnung zum Feed wichtig ist, senden Sie die Hashtags in getrennten Aufgaben, da ein gespeicherter Datensatz einen Quell-Hashtag behält.

Jedes gespeicherte normalisierte Video kostet 0,5 Credits ohne Grundgebühr. Die Schätzung der Anfrage multipliziert results_limit oder dessen Standardwert 100 mit der Anzahl der Hashtags; die endgültige Nutzung richtet sich nach der tatsächlichen Zahl gespeicherter Datensätze, und ein leeres Ergebnis verursacht keine Kosten pro Ergebnis.