Inicio rápido

Busca Spaces por palabra clave

Esta guía te enseñará a buscar Spaces por palabra clave.

Requisitos previos

Antes de comenzar, necesitarás:

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

---

​

Buscar Spaces

Busca Spaces que coincidan con una palabra clave determinada:

cURL

shellscript

curl "https://api.x.com/2/spaces/search?\
query=AI&\
space.fields=title,host_ids,participant_count,state&\
state=live" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Respuesta

{
  "data": [
    {
      "id": "1DXxyRYNejbKM",
      "state": "live",
      "title": "Discussing AI and the Future",
      "host_ids": ["2244994945"],
      "participant_count": 245
    },
    {
      "id": "1YqJDqWYNQDGW",
      "state": "live",
      "title": "AI in Healthcare",
      "host_ids": ["783214"],
      "participant_count": 89
    }
  ],
  "meta": {
    "result_count": 2
  }
}

---

​

Filtrar por estado

Busca únicamente Spaces en directo o programados:

​

Solo Spaces en vivo

cURL

shellscript

curl "https://api.x.com/2/spaces/search?query=tech&state=live" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Solo Spaces programados

cURL

shellscript

curl "https://api.x.com/2/spaces/search?query=tech&state=scheduled" \
  -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/search?\
query=AI&\
space.fields=title,host_ids,state&\
expansions=host_ids&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Parámetros comunes

Parámetro	Descripción
query	Consulta de búsqueda (requerida)
state	Filtro: live, scheduled o all
max_results	Resultados que se devolverán (1-100)
space.fields	Campos de Space a incluir
expansions	Objetos relacionados a incluir
user.fields	Campos de usuario a incluir

---

​

Próximos pasos

Búsqueda de Spaces

Busca Spaces por su identificador

Referencia de la API

Documentación completa del endpoint