x/
space

Consulte Espacios de X a partir de sus enlaces y obtenga el título, el estado, la hora de inicio, los anfitriones, los oradores, el total de oyentes en vivo y las reproducciones de la grabación de Espacios programados, en vivo o finalizados.

X Spaces API

Enlace del Espacio
Anfitriones y oradores
Oyentes y reproducciones
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioEnlaces 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.

  1. Envíe {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} por POST a /v1/x/space.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. 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.

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.

Explorar otras plataformas

Combine los datos de X con datos públicos de otras plataformas sociales compatibles.

X Spaces API — FAQ

X Spaces API es una interfaz programática para consultar los Espacios de X, las salas de audio en vivo de X, a partir de sus enlaces /i/spaces/. Devuelve el título, el estado, el inicio programado, el anfitrión principal, los coanfitriones, los oradores, el total de oyentes en vivo, las reproducciones de la grabación y la disponibilidad de la grabación de cada Espacio.

Sí. metrics.live_listeners_count es el total de personas que escucharon mientras el Espacio estaba en vivo, y metrics.replay_views_count indica cuántas veces se reprodujo la grabación después.

No. Los oyentes se informan como conteos. Las cuentas identificadas en un resultado son el anfitrión principal, los coanfitriones y los oradores.

No. El resultado describe el Espacio y su audiencia; is_replay_available indica si la grabación puede reproducirse en X.

Cuando no se encuentra ninguno de los Espacios enviados, la tarea falla y se reembolsa por completo. Cuando solo faltan algunos, el resto se devuelve con normalidad.