X Spaces
Los Espacios de X (antes Twitter Spaces) son salas de audio en vivo dentro de X, cada una con un título, un estado que pasa de programado a en vivo y a finalizado, un anfitrión principal con sus posibles coanfitriones, los oradores que suben al escenario y los conteos de las personas que escucharon en vivo y de las veces que se reprodujo la grabación. Estos datos permiten informar sobre el alcance de un solo Espacio, seguir un programa recurrente episodio por episodio y ver qué voces aparecen una y otra vez en el escenario dentro de un sector.
Funcionalidades de la X Spaces API
- Cualquier enlace de Espacio, en cualquier etapaEnvíe enlaces https://x.com/i/spaces/<id> de Espacios programados, en vivo o ya terminados, y cada uno devuelve una sola fila.
- Estado y horariosstatus toma los valores scheduled, live, ended o canceled, con scheduled_start_at para el inicio previsto y published_at para el momento en que se creó el Espacio.
- Todas las personas en el escenarioauthor es el anfitrión principal, hosts enumera al anfitrión y a los coanfitriones y speakers enumera las cuentas invitadas a hablar, cada una con id, username, nombre, avatar e indicador de verificación.
- Audiencia en vivo y de la grabaciónmetrics.live_listeners_count es el total de personas que escucharon mientras el Espacio estaba en vivo, y metrics.replay_views_count cuenta las reproducciones posteriores de la grabación.
- Disponibilidad de la grabaciónis_replay_available indica si el Espacio todavía puede reproducirse en X una vez finalizado.
Parámetros de la X Spaces API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Enlaces de Espacios de X con el formato https://x.com/i/spaces/<space_id>, uno por línea; se aceptan Espacios programados, en vivo y finalizados. |
Cómo usar la X Spaces API
Envíe enlaces de Espacios y lea una fila por Espacio.
- Envíe {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} por POST a /v1/x/space.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea cada Espacio en results.items; en lotes largos, siga pasando results.next_cursor mientras has_more sea 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.Casos de uso de la X Spaces API
- Informar sobre un Espacio que organizó o patrocinó: Incluya live_listeners_count, replay_views_count y los oradores de cada Espacio en un informe posterior al evento para un cliente o un patrocinador.
- Seguir el programa de audio de un competidor: Recopile los enlaces de los Espacios recurrentes de un rival y compare oyentes, reproducciones e invitados de un episodio a otro.
- Crear una lista de oradores activos en un nicho: Reúna a los oradores y coanfitriones de los Espacios de su sector y cuente con qué frecuencia aparece cada cuenta en el escenario.
- Revisar los participantes de un Espacio programado: Lea scheduled_start_at y hosts antes de un evento y luego consulte de nuevo el Espacio para ver si su estado pasó a ended o canceled.
Consejos de expertos para la X Spaces API
- Recopile de nuevo un Espacio cuando status sea ended para registrar su total final de oyentes en vivo, y guarde replay_views_count con collected_at, ya que la grabación sigue sumando reproducciones mientras is_replay_available sea true.
- Calcule los coanfitriones como hosts menos la entrada de author; el anfitrión principal aparece en ambos campos.
- Identifique a los oradores por id cuando combine varios Espacios, para que la misma persona se cuente una sola vez incluso después de un cambio de nombre de usuario.
APIs relacionadas
Además de la X Spaces API, use estas APIs cuando necesite otro tipo de datos públicos de X.
- Twitter Tweet Scraper API — Obtiene el texto de posts públicos, autores, interacción, contenido multimedia, hashtags, menciones y relaciones de conversación desde URLs de estado de x.com o twitter.com.
- Twitter Profile Scraper API — Obtiene por nombre de usuario la identidad de la cuenta pública, biografías, avatares, imágenes de portada, estado de la cuenta y estadísticas visibles de audiencia.
- Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
- X Post Quotes API — Recolecta posts públicos con cita de URLs de estado conocidas, con comentario, autores, interacción, contenido multimedia, marcas de tiempo y contexto del post de origen.
- Twitter Mentions API — Recolecta posts públicos que mencionan a una cuenta indicada.
- X Account Location API — Consulta el país donde está ubicada una cuenta, cómo se conecta a X, su fecha de registro y sus cambios de nombre de usuario.
- 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