YouTube Videos
YouTube-Videos sind öffentliche Uploads mit Titeln, Beschreibungen, Kanalkontext, Vorschaubildern, Dauer, Angaben zur Veröffentlichung, Hashtags, Einstufung der Quelle und sichtbarer Interaktion. Diese Metadaten und Performance-Signale unterstützen die Anreicherung von Videos, die Inhaltsrecherche, die Beobachtung und vergleichende Analysen.
Funktionen der YouTube Videos API
- Batch-Abfrage bekannter URLsFragen Sie mehrere bekannte öffentliche Video- und Short-URLs in einer einzigen Anfrage ab.
- Stabile Video-IdentitätLiefert für jedes Ergebnis eine stabile Video-ID, kanonische URL, Titel, öffentliche Beschreibung und den veröffentlichenden Kanal.
- InhaltsmetadatenEnthält Vorschaubilder, Dauer, Hashtags, Veröffentlichungsdatum und den normalisierten Inhaltstyp.
- Interaktionskennzahlen als MomentaufnahmeErfasst die öffentlichen Zahlen zu Aufrufen, „Gefällt mir“-Angaben und Kommentaren mit collected_at für den Vergleich von Momentaufnahmen.
- Einheitliches VideoschemaBietet dieselbe normalisierte Videostruktur für reguläre Videos und unterstützte Short-URLs.
Parameter der YouTube Videos API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Öffentliche YouTube-Video- oder Short-URLs, getrennt durch Kommas oder Zeilenumbrüche. |
So verwenden Sie die YouTube Videos API
Machen Sie aus einer Sammlung von Links Datensätze, die Ihre Anwendung verknüpfen, durchsuchen und aktualisieren kann. Die Anfrage ist asynchron, bewahren Sie die Aufgaben-ID daher auf, bis jede zugängliche URL aufgelöst wurde.
- Sammeln Sie öffentliche Wiedergabe- oder Shorts-URLs und entfernen Sie Duplikate; Kanal- und Suchergebnis-URLs gehören zu anderen Endpunkten.
- Senden Sie das Array urls per POST an /v1/youtube/videos und speichern Sie die zurückgegebene task_id neben Ihrem Quell-Batch.
- Fragen Sie /v1/tasks/{task_id} ab; queued und running bedeuten, dass der Batch noch verarbeitet wird.
- Indizieren Sie nach einem Erfolg data.results.items nach id und fahren Sie mit next_cursor fort, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"]}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Anwendungsfälle der YouTube Videos API
- Anreicherung von URL-Listen: Ergänzen Sie eine bestehende Liste von YouTube-URLs um Titel, Kanalinformationen, Vorschaubilder, Dauer, Veröffentlichungsdaten und öffentliche Kennzahlen.
- Vergleich ausgewählter Videos: Vergleichen Sie öffentliche Aufrufe, „Gefällt mir“-Angaben, Kommentare, Dauer und Angaben zur Veröffentlichung über eine gewählte Menge von Videos oder Shorts hinweg.
- Beobachtung von Kampagnen und Wettbewerbern: Erfassen Sie wiederholt Momentaufnahmen der Metadaten für bekannte Videos von Kampagnen, Creators oder Wettbewerbern.
- Inhaltskataloge: Stellen Sie normalisierte Videodatensätze für interne Suche, Berichte, Moderation, Zusammenfassung oder Analyse-Workflows bereit.
Profi-Tipps zur YouTube Videos API
- Machen Sie id zu Ihrem Primärschlüssel. Titel können sich ändern, und dasselbe Video kann über mehrere gültige URL-Formate eintreffen.
- Behalten Sie canonical_url für ausgehende Links bei, speichern Sie aber input_url, wenn Sie nachvollziehen müssen, woher ein Datensatz stammt.
- Die Kennzahlen beschreiben die Seite zum Zeitpunkt collected_at. Der Vergleich zweier Momentaufnahmen ist nützlich; wer die alte überschreibt, löscht diesen Verlauf.
- Behandeln Sie Links aus der Beschreibung als nicht vertrauenswürdige externe Eingabe, bevor Sie sie darstellen, crawlen oder importieren.
- Ein fehlendes Ergebnis ist kein Beweis dafür, dass eine URL nie existiert hat. Private, gelöschte, eingeschränkte oder vorübergehend nicht zugängliche Einträge können aus einem Batch verschwinden.
- Kommentare und Transkripttext sind bewusst getrennt. Fordern Sie sie nur für Elemente an, die diese Stufen in Ihrem Workflow erreichen.
- Beginnen Sie die Entdeckung nach Themen mit Search. Nutzen Sie Videos, wenn Sie bereits wissen, welche URL wichtig ist.
Verwandte APIs
Ergänzend zur YouTube Videos 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 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 Shorts API — Öffentliche Shorts, Thumbnails, Dauer, Veröffentlichungsdetails und Interaktionen pro Kanal erfassen.
- YouTube Related Videos API — Die neben einer Video-URL empfohlenen Videos auflisten – mit Titeln, Kanälen, Aufrufen und Vorschaubildern.
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API