Inicio rápido

Obtén detalles de un Space por id o por creador

Esta guía te explica paso a paso cómo obtener información de un Space mediante los endpoints de consulta de Spaces.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador con una App aprobada
• El Bearer Token de tu App

---

​

Obtener un Space por ID

Obtén los detalles de un Space específico:

cURL

shellscript

curl "https://api.x.com/2/spaces/1DXxyRYNejbKM?\
space.fields=title,host_ids,participant_count,scheduled_start,state,created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Respuesta

{
  "data": {
    "id": "1DXxyRYNejbKM",
    "state": "live",
    "title": "Discussing AI and the Future",
    "host_ids": ["2244994945"],
    "participant_count": 245,
    "created_at": "2024-01-15T09:00:00.000Z"
  }
}

---

​

Obtener varios Spaces

Consulta varios Spaces a la vez:

cURL

shellscript

curl "https://api.x.com/2/spaces?\
ids=1DXxyRYNejbKM,1YqJDqWYNQDGW&\
space.fields=title,state,participant_count" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Obtener Spaces por creador

Busca Spaces organizados por usuarios específicos:

cURL

shellscript

curl "https://api.x.com/2/spaces/by/creator_ids?\
user_ids=2244994945,783214&\
space.fields=title,state,scheduled_start" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Incluir información del anfitrión

Amplía los datos del usuario anfitrión:

cURL

shellscript

curl "https://api.x.com/2/spaces/1DXxyRYNejbKM?\
space.fields=title,host_ids,state&\
expansions=host_ids&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Respuesta con expansiones

{
  "data": {
    "id": "1DXxyRYNejbKM",
    "state": "live",
    "title": "Discussing AI and the Future",
    "host_ids": ["2244994945"]
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

---

​

Estados de los Spaces

State	Description
live	Actualmente en vivo
scheduled	Programado para una fecha futura
ended	Ya ha finalizado

---

​

Campos disponibles

Campo	Descripción
title	Título del Space
host_ids	IDs de usuarios anfitriones
speaker_ids	IDs de usuarios oradores
participant_count	Participantes actuales
scheduled_start	Hora de inicio programada
started_at	Hora de inicio real
ended_at	Hora de finalización
is_ticketed	Indica si el Space es de pago
state	Estado actual

---

​

Próximos pasos

Buscar Spaces

Busca Spaces por palabra clave

Referencia de la API

Documentación completa del endpoint