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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | X-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.
- Senden Sie {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} per POST an /v1/x/space.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- 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.
Verwandte APIs
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.
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API