x/
space

X Spaces über ihre Links abrufen und Titel, Status, Startzeit, Hosts, Sprecher, Gesamtzahl der Live-Zuhörer und Wiedergaben der Aufzeichnung für geplante, laufende oder beendete Spaces erhalten.

X Spaces API

Space-Link als Eingabe
Hosts und Sprecher
Zuhörer- und Wiedergabezahlen
0,7 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

X Spaces

X Spaces, ehemals Twitter Spaces, sind Live-Audioräume auf X, jeweils mit einem Titel, einem Status, der von geplant über live zu beendet wechselt, einem Haupt-Host mit eventuellen Co-Hosts, den auf die Bühne geholten Sprechern sowie der Zahl der Personen, die live zugehört haben, und der Wiedergaben der Aufzeichnung. Mit diesen Angaben können Sie über die Reichweite eines einzelnen Spaces berichten, eine wiederkehrende Sendung Folge für Folge verfolgen und sehen, welche Stimmen in einem Fachgebiet immer wieder auf der Bühne stehen.

Funktionen der X Spaces API

  • Jeder Space-Link, in jeder PhaseSenden Sie Links der Form https://x.com/i/spaces/<id> für Spaces, die geplant, live oder bereits vorbei sind, und jeder liefert genau eine Zeile.
  • Status und Zeitpunktestatus lautet scheduled, live, ended oder canceled, mit scheduled_start_at für den geplanten Beginn und published_at für den Zeitpunkt, an dem der Space erstellt wurde.
  • Alle auf der Bühneauthor ist der Haupt-Host, hosts führt den Host und die Co-Hosts auf und speakers die Konten, die zum Sprechen eingeladen wurden, jeweils mit id, username, name, Avatar und Verifizierungs-Flag.
  • Live- und Replay-Publikummetrics.live_listeners_count ist die Gesamtzahl der Personen, die zugehört haben, während der Space live war, und metrics.replay_views_count zählt die späteren Wiedergaben der Aufzeichnung.
  • Verfügbarkeit der Aufzeichnungis_replay_available zeigt, ob sich der Space nach seinem Ende noch auf X abspielen lässt.

Parameter der X Spaces API

ParameterErforderlichBeschreibung
urlsErforderlichX-Space-Links in der Form https://x.com/i/spaces/<space_id>, einer pro Zeile; geplante, laufende und beendete Spaces werden alle akzeptiert.

So verwenden Sie die X Spaces API

Senden Sie Space-Links und lesen Sie eine Zeile pro Space.

  1. Senden Sie {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} per POST an /v1/x/space.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie jeden Space aus results.items; bei langen Batches übergeben Sie weiter results.next_cursor, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/x/space" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'

# hosts repeats the main host from author and adds any co-hosts.

Anwendungsfälle der X Spaces API

  • Über einen Space berichten, den Sie gehostet oder gesponsert haben: Übernehmen Sie live_listeners_count, replay_views_count und die Sprecherbesetzung jedes Spaces in einen Abschlussbericht für einen Kunden oder Sponsor.
  • Die Audio-Show eines Wettbewerbers verfolgen: Sammeln Sie die Links der wiederkehrenden Spaces eines Konkurrenten und vergleichen Sie Zuhörer, Wiedergaben und Gäste von Folge zu Folge.
  • Eine Liste aktiver Sprecher einer Nische aufbauen: Sammeln Sie die Sprecher und Co-Hosts der Spaces in Ihrem Fachgebiet und zählen Sie, wie oft jedes Konto auf der Bühne steht.
  • Die Besetzung eines geplanten Spaces prüfen: Lesen Sie scheduled_start_at und hosts vor einer Veranstaltung und fragen Sie den Space danach erneut ab, um zu sehen, ob sein Status zu ended oder canceled gewechselt ist.

Profi-Tipps zur X Spaces API

  • Erfassen Sie einen Space erneut, sobald status ended ist, um die endgültige Zahl der Live-Zuhörer festzuhalten, und speichern Sie replay_views_count mit collected_at, denn solange is_replay_available true ist, kommen weitere Wiedergaben hinzu.
  • Zählen Sie die Co-Hosts als hosts abzüglich des Eintrags aus author; der Haupt-Host steht in beiden Feldern.
  • Verwenden Sie id als Schlüssel für Sprecher, wenn Sie mehrere Spaces zusammenführen, damit dieselbe Person auch nach einer Änderung des Benutzernamens nur einmal gezählt wird.

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

  • Twitter Tweet Scraper API — Öffentliche Post-Texte, Autoren, Interaktionen, Medien, Hashtags, Erwähnungen und Gesprächsbeziehungen aus Status-URLs von x.com oder twitter.com abrufen.
  • Twitter Profile Scraper API — Öffentliche Kontoidentität, Bios, Avatare, Titelbilder, Kontostatus und sichtbare Statistiken zur Zielgruppe per Benutzername abrufen.
  • Twitter User Tweets Scraper API — Aktuelle öffentliche Posts, Autoren, Medien, Hashtags, Erwähnungen und Interaktionen per Benutzername erfassen – ohne Antworten.
  • X Post Quotes API — Öffentliche Zitat-Posts zu bekannten Status-URLs erfassen – mit Kommentar, Autoren, Interaktionen, Medien, Zeitstempeln und Kontext des Quell-Posts.
  • Twitter Mentions API — Öffentliche Posts erfassen, die ein angegebenes Konto erwähnen.
  • X Account Location API — Das Land, in dem ein Konto ansässig ist, die Art der Verbindung mit X, das Beitrittsdatum und Änderungen des Benutzernamens nachschlagen.

Weitere Plattformen entdecken

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

X Spaces API — FAQ

X Spaces API ist eine Programmierschnittstelle, die X Spaces, die Live-Audioräume auf X, über ihre Links mit /i/spaces/ abruft. Sie liefert zu jedem Space Titel, Status, geplanten Beginn, Haupt-Host, Co-Hosts, Sprecher, Gesamtzahl der Live-Zuhörer, Wiedergaben der Aufzeichnung und deren Verfügbarkeit.

Ja. metrics.live_listeners_count ist die Gesamtzahl der Personen, die zugehört haben, während der Space live war, und metrics.replay_views_count gibt an, wie oft die Aufzeichnung danach abgespielt wurde.

Nein. Zuhörer werden als Zahlen ausgewiesen. Die namentlich genannten Konten in einem Ergebnis sind der Haupt-Host, die Co-Hosts und die Sprecher.

Nein. Das Ergebnis beschreibt den Space und sein Publikum; is_replay_available gibt an, ob sich die Aufzeichnung auf X abspielen lässt.

Wird keiner der übermittelten Spaces gefunden, schlägt die Aufgabe fehl und wird vollständig erstattet. Fehlen nur einige, werden die übrigen wie gewohnt zurückgegeben.