YouTube Search
Die Ergebnisse der YouTube-Suche sind reguläre öffentliche Videos, die zu einem Keyword oder einer Wortfolge passen, mit Titeln, Kanälen, Vorschaubildern, Dauer, Angaben zur Veröffentlichung und sichtbarer Interaktion. Diese Datensätze unterstützen die Themenfindung, die Inhaltsrecherche, die Beobachtung von Wettbewerbern und die Analyse von Chancen.
Funktionen der YouTube Search API
- Videosuche ohne URLsEntdecken Sie öffentliche reguläre Videos, ohne vorher ihre URLs zu kennen.
- Sortierung der ErgebnisseSortieren Sie Ergebnisse nach Relevanz, Veröffentlichungsdatum, Bewertung oder öffentlicher Anzahl der Aufrufe.
- Zeitfenster der VeröffentlichungFiltern Sie Ergebnisse nach Veröffentlichungsfenstern von einer Stunde, einem Tag, einer Woche, einem Monat oder einem Jahr.
- Filter für Dauer und UntertitelFiltern Sie nach kurzer, mittlerer oder langer Dauer und verlangen Sie bei Bedarf verfügbare Untertitel.
- Normalisierte VideoergebnisseLiefert normalisierte Videometadaten, Kanalinformationen, Vorschaubilder, Dauer, Veröffentlichungsdaten und öffentliche Kennzahlen.
Parameter der YouTube Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Keyword oder Wortfolge, mit der öffentliche Videos gefunden werden. |
results_limit | Optional | Maximale Anzahl öffentlicher Videoergebnisse, die angefordert werden. Muss eine positive ganze Zahl sein; der Standardwert ist 100. |
sort_by | Optional | Sortierung der Ergebnisse. Der Standardwert ist relevance. |
published_within | Optional | Optionales Veröffentlichungsfenster, gemessen ab dem Zeitpunkt der aktuellen Anfrage. |
duration | Optional | Optionale Dauerkategorie von YouTube. |
has_captions | Optional | Optionaler Filter für die Verfügbarkeit von Untertiteln. Lassen Sie ihn unverändert, um diesen Filter wegzulassen. |
So verwenden Sie die YouTube Search API
Formulieren Sie die Suchanfrage als Abrufstrategie und nicht nur als Keyword. Beginnen Sie breit genug, um das Umfeld zu überblicken, und fügen Sie dann Filter einzeln hinzu, damit Sie sehen, welche Entscheidung Kandidaten entfernt hat.
- Definieren Sie das Thema und die Frage: beste thematische Treffer, neueste Berichterstattung, viel angesehene Videos oder Kandidaten mit Transkript.
- Senden Sie query und results_limit sowie nur die Sortierung und Filter, die für diese Frage nötig sind, per POST an /v1/youtube/search.
- Speichern Sie die vollständige Anfrage zusammen mit task_id und fragen Sie dann /v1/tasks/{task_id} ab, bis die Suche erfolgreich ist oder fehlschlägt.
- Entfernen Sie Duplikate anhand der Video-ID, behalten Sie Ranking-Kontext und collected_at bei und paginieren Sie, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"NASA Artemis","results_limit":10,"sort_by":"date","published_within":"month","duration":"medium","has_captions":true}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Anwendungsfälle der YouTube Search API
- Themen- und Marktforschung: Entdecken Sie öffentliche Videos zu Produkten, Branchen, Organisationen, Veranstaltungen oder aufkommenden Themen.
- Entdeckung von Creators und Wettbewerbern: Nutzen Sie Suchergebnisse und Informationen zum veröffentlichenden Kanal, um relevante Creators, Marken oder Wettbewerber zu identifizieren.
- Beobachtung aktueller Videos: Kombinieren Sie die Sortierung nach Datum mit Veröffentlichungsfenstern, um aktuelle Videos für Prüfung oder Analyse zu sammeln.
- Datensätze mit Transkripten: Verlangen Sie verfügbare Untertitel, um Videos für die Erfassung von Transkripten, Zusammenfassung, Klassifizierung oder Suche zu finden.
Profi-Tipps zur YouTube Search API
- Testen Sie zwei oder drei präzise Varianten der Suchanfrage, statt jedes Konzept in einer langen Wortfolge zu verstecken. Die Überschneidung ist oft so aufschlussreich wie die Unterschiede.
- Fügen Sie Filter schrittweise hinzu. Wenn Sie Veröffentlichungsfenster, Dauer und Untertitel gleichzeitig angeben, verrät ein leeres Ergebnis kaum, welche Einschränkung zu eng war.
- Verwenden Sie für die Beobachtung date zusammen mit published_within; relevance ohne Zeitfenster beantwortet eine andere, breitere Forschungsfrage.
- Das Ranking ist nicht stabil. Speichern Sie Anfrage, Aufgaben-ID, Video-ID und collected_at, sobald die Position oder Zusammensetzung der Stichprobe wichtig ist.
- results_limit ist eine Obergrenze und keine Garantie für Vollständigkeit. Öffentliche Eignung und die gewählten Filter können zu weniger Datensätzen führen.
- Entfernen Sie über mehrere Varianten der Suchanfrage hinweg Duplikate anhand der Video-ID, behalten Sie aber bei, welche Anfrage den jeweiligen Treffer geliefert hat, um später die Relevanz zu analysieren.
- Sobald eine URL bekannt ist, nutzen Sie Videos für aktualisierte Details und Transcripts für verfügbaren Untertiteltext, statt wiederholt danach zu suchen.
Verwandte APIs
Ergänzend zur YouTube 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 Transcripts API — Verfügbare Klartext-Transkripte mit optionaler Sprachauswahl abrufen.
- YouTube Channels API — Öffentliche Kanalidentität, Bilder, Verifizierung und sichtbare Statistiken zur Zielgruppe abrufen.
- YouTube Videos API — Metadaten, Thumbnails, Dauer und Interaktionen zu bekannten Video- oder Short-URLs abrufen.
- 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 Channel Videos API
- YouTube Shorts 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 Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API