youtube/
videos

Öffentliche Metadaten zu bekannten YouTube-Video- oder Short-URLs abrufen – mit normalisierten Titeln, Kanalkontext, Vorschaubildern, Dauer und sichtbarer Interaktion.

YouTube Videos API

Videodetails
Bekannte URLs
Öffentliche Kennzahlen
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 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

ParameterErforderlichBeschreibung
urlsErforderlichÖ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.

  1. Sammeln Sie öffentliche Wiedergabe- oder Shorts-URLs und entfernen Sie Duplikate; Kanal- und Suchergebnis-URLs gehören zu anderen Endpunkten.
  2. Senden Sie das Array urls per POST an /v1/youtube/videos und speichern Sie die zurückgegebene task_id neben Ihrem Quell-Batch.
  3. Fragen Sie /v1/tasks/{task_id} ab; queued und running bedeuten, dass der Batch noch verarbeitet wird.
  4. 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=50

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

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.

Weitere Plattformen entdecken

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

YouTube Videos API — FAQ

YouTube Videos API ruft öffentliche Metadaten zu bekannten YouTube-Video- oder Short-URLs ab. Die Schnittstelle liefert normalisierte Identität, Titel, Beschreibungen, Kanalinformationen, Vorschaubilder, Dauer, Veröffentlichungsdaten, Interaktionskennzahlen und den Zeitpunkt der Erfassung.

Senden Sie eine oder mehrere öffentliche YouTube-Video- oder Short-URLs im Array urls.

Ja. Öffentliche Short-URLs werden unterstützt und nutzen dieselbe normalisierte Videostruktur, wobei ihr Inhaltstyp erhalten bleibt.

Nein. Die Kennzahlen sind öffentliche Werte zum Zeitpunkt der Erfassung. Speichern Sie collected_at und erfassen Sie dieselben URLs erneut, wenn historische Vergleiche nötig sind.

Das Videoergebnis enthält die öffentliche Anzahl der Kommentare, nicht den Text von Kommentaren oder Transkripten. Nutzen Sie Comments für Kommentardatensätze und Transcripts für verfügbare Untertitel.

Die Nutzung kostet 0,5 Credits für jedes zurückgegebene normalisierte Videoergebnis.