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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Link 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.
- Invia con POST {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} a /v1/x/space.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- 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.
API correlate
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.
- 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