x/
space

Cerca gli spazi di X a partire dai loro link e ottieni titolo, stato, ora di inizio, host, relatori, totale degli ascoltatori dal vivo e riproduzioni della registrazione per spazi programmati, in diretta o terminati.

X Spaces API

Input con link dello spazio
Host e relatori
Ascoltatori e riproduzioni
0,7 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

X Spaces

Gli spazi di X, un tempo chiamati Twitter Spaces, sono stanze audio dal vivo su X, ognuna con un titolo, uno stato che passa da programmato a in diretta a terminato, un host principale con eventuali co-host, i relatori invitati a parlare e i conteggi di chi ha ascoltato in diretta e di quante volte è stata riprodotta la registrazione. Questi dettagli ti permettono di documentare la portata di un singolo spazio, seguire un programma ricorrente puntata per puntata e vedere quali voci tornano più spesso a parlare in un settore.

Funzionalità della X Spaces API

  • Qualsiasi link di uno spazio, in qualsiasi faseInvia link https://x.com/i/spaces/<id> di spazi programmati, in diretta o già terminati, e ognuno restituisce una sola riga.
  • Stato e oraristatus vale scheduled, live, ended o canceled, con scheduled_start_at per l’inizio previsto e published_at per il momento in cui lo spazio è stato creato.
  • Tutte le persone che parlanoauthor è l’host principale, hosts elenca l’host e i co-host e speakers elenca gli account invitati a parlare, ognuno con id, username, name, avatar e flag di verifica.
  • Pubblico dal vivo e della registrazionemetrics.live_listeners_count è il numero totale di persone che hanno ascoltato mentre lo spazio era in diretta, mentre metrics.replay_views_count conta le riproduzioni successive della registrazione.
  • Disponibilità della registrazioneis_replay_available indica se lo spazio può ancora essere riascoltato su X dopo la sua conclusione.

Parametri della X Spaces API

ParametriObbligatorioDescrizione
urlsObbligatorioLink di spazi di X nel formato https://x.com/i/spaces/<space_id>, uno per riga; sono accettati spazi programmati, in diretta e terminati.

Come usare la X Spaces API

Invia i link degli spazi e leggi una riga per ogni spazio.

  1. Invia con POST {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} a /v1/x/space.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi ogni spazio da results.items; per i batch lunghi continua a passare results.next_cursor finché has_more è true.
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.

Casi d’uso della X Spaces API

  • Rendicontare uno spazio che hai ospitato o sponsorizzato: Inserisci live_listeners_count, replay_views_count e l’elenco dei relatori di ogni spazio in un report post-evento per un cliente o uno sponsor.
  • Monitorare il programma audio di un concorrente: Raccogli i link degli spazi ricorrenti di un concorrente e confronta ascoltatori, riproduzioni e ospiti da una puntata all’altra.
  • Creare un elenco dei relatori attivi in una nicchia: Raccogli i relatori e i co-host degli spazi del tuo settore e conta quante volte ogni account interviene.
  • Verificare i partecipanti di uno spazio programmato: Leggi scheduled_start_at e hosts prima di un evento, poi cerca di nuovo lo spazio per vedere se il suo stato è diventato ended o canceled.

Consigli degli esperti per la X Spaces API

  • Raccogli di nuovo uno spazio quando status è ended per registrare il totale finale degli ascoltatori dal vivo, e salva replay_views_count con collected_at, perché le riproduzioni continuano ad aumentare finché is_replay_available è true.
  • Conta i co-host come hosts meno la voce di author; l’host principale compare in entrambi i campi.
  • Usa id come chiave dei relatori quando combini più spazi, così la stessa persona viene contata una sola volta anche dopo un cambio di nome utente.

Oltre alla X Spaces API, usa queste API quando ti serve un altro tipo di dati pubblici di X.

  • Twitter Tweet Scraper API — Recupera testo dei post pubblici, autori, engagement, media, hashtag, menzioni e relazioni della conversazione dagli URL di stato di x.com o twitter.com.
  • Twitter Profile Scraper API — Recupera identità dell’account pubblico, bio, avatar, immagini di copertina, stato dell’account e statistiche visibili del pubblico a partire dal nome utente.
  • Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
  • X Post Quotes API — Raccoglie le citazioni pubbliche di URL di stato noti con commento, autori, engagement, media, date e contesto del post di origine.
  • Twitter Mentions API — Raccoglie i post pubblici che menzionano un account indicato.
  • X Account Location API — Consulta il paese in cui si trova un account, il modo in cui si connette a X, la data di iscrizione e i cambi del nome utente.

Esplora altre piattaforme

Combina i dati di X con i dati pubblici delle altre piattaforme social supportate.

X Spaces API — FAQ

X Spaces API è un’interfaccia programmatica per cercare gli spazi di X, cioè le stanze audio dal vivo su X, a partire dai loro link /i/spaces/. Restituisce per ogni spazio titolo, stato, inizio programmato, host principale, co-host, relatori, totale degli ascoltatori dal vivo, riproduzioni e disponibilità della registrazione.

Sì. metrics.live_listeners_count è il numero totale di persone che hanno ascoltato mentre lo spazio era in diretta, mentre metrics.replay_views_count indica quante volte la registrazione è stata riprodotta in seguito.

No. Gli ascoltatori vengono riportati come conteggi. Gli account indicati per nome in un risultato sono l’host principale, i co-host e i relatori.

No. Il risultato descrive lo spazio e il suo pubblico; is_replay_available ti dice se la registrazione può essere riprodotta su X.

Quando nessuno degli spazi inviati viene trovato, l’attività non riesce e viene rimborsata per intero. Quando ne mancano solo alcuni, gli altri vengono restituiti normalmente.