Démarrage rapide

Ce guide vous explique comment rechercher des Spaces par mot-clé.

PrérequisAvant de commencer, vous aurez besoin de :

D’un compte développeur avec une App approuvée
Du Jeton Bearer de votre App

Rechercher des Spaces

Recherchez des Spaces qui correspondent à un mot-clé :

cURL

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Rechercher des Spaces
response = client.spaces.search(
    query="AI",
    space_fields=["title", "host_ids", "participant_count", "state"],
    state="live"
)

for space in response.data:
    print(f"{space.title} - {space.participant_count} participants")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Rechercher des Spaces
const response = await client.spaces.search({
  query: "AI",
  spaceFields: ["title", "host_ids", "participant_count", "state"],
  state: "live",
});

response.data?.forEach((space) => {
  console.log(`${space.title} - ${space.participant_count} participants`);
});

Réponse

{
  "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
  }
}

Filtrer par statut

Rechercher uniquement les Spaces en direct ou programmés :

Spaces en direct uniquement

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Rechercher uniquement des Spaces en direct
response = client.spaces.search(query="tech", state="live")

for space in response.data:
    print(f"LIVE: {space.title}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Rechercher uniquement des Spaces en direct
const response = await client.spaces.search({
  query: "tech",
  state: "live",
});

response.data?.forEach((space) => {
  console.log(`LIVE: ${space.title}`);
});

Spaces programmées uniquement

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Rechercher uniquement les Spaces programmées
response = client.spaces.search(query="tech", state="scheduled")

for space in response.data:
    print(f"SCHEDULED: {space.title}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Rechercher uniquement les Spaces programmées
const response = await client.spaces.search({
  query: "tech",
  state: "scheduled",
});

response.data?.forEach((space) => {
  console.log(`SCHEDULED: ${space.title}`);
});

Inclure les informations sur l’hôte

Inclure les données de l’utilisateur hôte :

cURL

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Recherche avec informations sur l'hôte
response = client.spaces.search(
    query="AI",
    space_fields=["title", "host_ids", "state"],
    expansions=["host_ids"],
    user_fields=["username", "verified"]
)

for space in response.data:
    print(f"{space.title}")
# Les informations sur l'hôte se trouvent dans response.includes.users

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Recherche avec informations sur l'hôte
const response = await client.spaces.search({
  query: "AI",
  spaceFields: ["title", "host_ids", "state"],
  expansions: ["host_ids"],
  userFields: ["username", "verified"],
});

response.data?.forEach((space) => {
  console.log(space.title);
});
// Les informations sur l'hôte se trouvent dans response.includes?.users

Paramètres courants

Paramètre	Description
`query`	Requête de recherche (obligatoire)
`state`	Filtre : `live`, `scheduled` ou `all`
`max_results`	Nombre de résultats à renvoyer (1-100)
`space.fields`	Champs Space à inclure
`expansions`	Objets associés à inclure
`user.fields`	Champs utilisateur à inclure

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Démarrage rapide

Rechercher des Spaces

Réponse

Filtrer par statut

Spaces en direct uniquement

Spaces programmées uniquement

Inclure les informations sur l’hôte

Paramètres courants

Prochaines étapes

Recherche de Spaces

Référence de l’API