youtube/
search-suggestions

Die Autocomplete-Vorschläge abrufen, die das YouTube-Suchfeld zu einer unvollständigen Suchanfrage anbietet – in der Reihenfolge, in der Zuschauer sie sehen, für die gewählte Sprache und Region.

YouTube Search Suggestions API

Autocomplete
Sprache und Region
Pauschalpreis pro Anfrage
0,5 Credits pro Anfrage
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

YouTube Search Suggestions

Suchvorschläge sind die Ergänzungen, die das YouTube-Suchfeld anbietet, während ein Zuschauer noch tippt, geordnet für dessen Sprache und Land. Sie zeigen, wie die Nachfrage rund um einen Ausgangsbegriff tatsächlich formuliert wird, und sind damit eine direkte Quelle für Keyword-Recherche, Videotitel, Tags und Content-Ideen.

Funktionen der YouTube Search Suggestions API

  • Die Reihenfolge, die Zuschauer sehenrank hält die Position jedes Vorschlags in der Auswahlliste fest, beginnend bei 1 für die oberste Ergänzung.
  • Markt wählenlanguage und region schalten die Vorschläge auf einen anderen Markt um, zum Beispiel es und MX für Suchen auf mexikanischem Spanisch.
  • Ein Suchlink pro BegriffJeder Vorschlag enthält die URL der YouTube-Suchergebnisse für diesen Begriff, zusammen mit der Ausgangsanfrage und dem Markt, mit denen er angefordert wurde.

Parameter der YouTube Search Suggestions API

ParameterErforderlichBeschreibung
queryErforderlichDer Anfang einer Suche, der ergänzt werden soll, bis zu 100 Zeichen.
languageOptionalSprachcode für die Vorschläge, zum Beispiel en, es oder pt-BR. Standardwert ist en.
regionOptionalZweistelliger Ländercode des Suchmarkts, zum Beispiel US oder GB. Standardwert ist US.

So verwenden Sie die YouTube Search Suggestions API

Senden Sie den Anfang einer Suche und lesen Sie die Ergänzungen in ihrer Rangfolge aus.

  1. Senden Sie {"query": "iphone 17"} per POST an /v1/youtube/search-suggestions und ergänzen Sie language und region für einen anderen Markt.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Vorschläge in der Reihenfolge ihres Rangs aus results.items; folgen Sie results.next_cursor, solange has_more den Wert true hat.
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.

Anwendungsfälle der YouTube Search Suggestions API

  • Einen Ausgangsbegriff erweitern: Erfassen Sie die Ergänzungen zu einem Produkt- oder Themennamen, um die längeren Formulierungen zu finden, nach denen Zuschauer tatsächlich suchen.
  • Titel schreiben, die zur Suche passen: Übernehmen Sie Formulierungen aus den obersten Vorschlägen, damit ein Videotitel widerspiegelt, wie Menschen die Suchanfrage eintippen.
  • Nachfrage in verschiedenen Märkten vergleichen: Führen Sie denselben Ausgangsbegriff mit unterschiedlichen Werten für language und region aus, um zu sehen, wie sich die Suchintention von Land zu Land verschiebt.

Profi-Tipps zur YouTube Search Suggestions API

  • Hängen Sie einen Buchstaben an den Ausgangsbegriff an, etwa iphone 17 a, um Ergänzungen zu erhalten, die mit diesem Buchstaben weitergehen.
  • Halten Sie language und region konstant, wenn Sie einen Ausgangsbegriff über die Zeit verfolgen, denn jeder Markt liefert seine eigene Liste.

Ergänzend zur YouTube Search Suggestions API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher YouTube-Daten benötigen.

  • YouTube Channel Videos API — Reguläre öffentliche Videos aus Kanal-URLs erfassen – ohne Shorts und Livestreams.
  • YouTube Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Quellvideos und Gesprächskontext erfassen.
  • YouTube Search API — Öffentliche reguläre Videos per Keyword suchen – mit unterstützten Metadatenfiltern.
  • YouTube Hashtag Search API — Öffentliche Videos aus Hashtag-Feeds finden – wahlweise alle Inhalte oder nur Shorts.
  • 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 Search Suggestions API — FAQ

YouTube Search Suggestions API ist eine Schnittstelle zum Abrufen der Autocomplete-Vorschläge der YouTube-Suche zu einer unvollständigen Suchanfrage in einer gewählten Sprache und Region. Sie liefert jeden vorgeschlagenen Begriff mit seinem Rang.

Ja. Die Vorschläge sind die Ergänzungen, die das YouTube-Suchfeld beim Tippen anzeigt, und werden in derselben Reihenfolge zurückgegeben.

So viele, wie YouTube zu dieser Suchanfrage anbietet, in der Regel etwa ein Dutzend.

Die offizielle Data API hat keinen Endpunkt für Autocomplete oder Typeahead. Dieser Endpunkt liefert die Vorschläge, die das YouTube-Suchfeld anzeigt, geordnet für die gewählte Sprache und Region.

Jede Anfrage kostet pauschal 0,5 Credits, unabhängig davon, wie viele Vorschläge sie liefert.