Démarrage rapide : recherche d’utilisateurs

Ce guide vous explique comment rechercher des utilisateurs à partir de leur ID ou de leur nom d’utilisateur.

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 par id

Un seul utilisateur

cURL

curl "https://api.x.com/2/users/2244994945?\
user.fields=created_at,description,verified,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer un utilisateur par ID
response = client.users.get(
    "2244994945",
    user_fields=["created_at", "description", "verified", "public_metrics"]
)

print(f"Name: {response.data.name}")
print(f"Username: {response.data.username}")
print(f"Followers: {response.data.public_metrics.followers_count}")

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

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

// Récupérer un utilisateur par ID
const response = await client.users.get("2244994945", {
  userFields: ["created_at", "description", "verified", "public_metrics"],
});

console.log(`Name: ${response.data?.name}`);
console.log(`Username: ${response.data?.username}`);
console.log(`Followers: ${response.data?.public_metrics?.followers_count}`);

Réponse

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X developer community",
    "verified": true,
    "public_metrics": {
      "followers_count": 583423,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

Plusieurs utilisateurs

Rechercher jusqu’à 100 utilisateurs en une seule requête :

cURL

curl "https://api.x.com/2/users?\
ids=2244994945,783214,6253282&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer plusieurs utilisateurs par id
response = client.users.get_users(
    ids=["2244994945", "783214", "6253282"],
    user_fields=["username", "verified"]
)

for user in response.data:
    print(f"{user.username} - Vérifié : {user.verified}")

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

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

// Récupérer plusieurs utilisateurs par id
const response = await client.users.getUsers({
  ids: ["2244994945", "783214", "6253282"],
  userFields: ["username", "verified"],
});

response.data?.forEach((user) => {
  console.log(`${user.username} - Vérifié : ${user.verified}`);
});

Recherche par nom d’utilisateur

Un seul utilisateur

cURL

curl "https://api.x.com/2/users/by/username/XDevelopers?\
user.fields=created_at,description,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer un utilisateur à partir de son nom d'utilisateur
response = client.users.get_by_username(
    "XDevelopers",
    user_fields=["created_at", "description", "verified"]
)

print(f"ID : {response.data.id}")
print(f"Nom : {response.data.name}")

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

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

// Récupérer un utilisateur à partir de son nom d'utilisateur
const response = await client.users.getByUsername("XDevelopers", {
  userFields: ["created_at", "description", "verified"],
});

console.log(`ID : ${response.data?.id}`);
console.log(`Nom : ${response.data?.name}`);

Plusieurs utilisateurs

cURL

curl "https://api.x.com/2/users/by?\
usernames=XDevelopers,X,elonmusk&\
user.fields=created_at,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Récupérer plusieurs utilisateurs par nom d'utilisateur
response = client.users.get_users_by_usernames(
    usernames=["XDevelopers", "X", "elonmusk"],
    user_fields=["created_at", "verified"]
)

for user in response.data:
    print(f"{user.username} - {user.created_at}")

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

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

// Récupérer plusieurs utilisateurs par nom d'utilisateur
const response = await client.users.getUsersByUsernames({
  usernames: ["XDevelopers", "X", "elonmusk"],
  userFields: ["created_at", "verified"],
});

response.data?.forEach((user) => {
  console.log(`${user.username} - ${user.created_at}`);
});

Champs disponibles

Champ	Description
`created_at`	Date de création du compte
`description`	Bio de l’utilisateur
`profile_image_url`	URL de l’avatar
`verified`	Statut de vérification
`public_metrics`	Nombre d’abonnés/abonnements
`location`	Emplacement défini par l’utilisateur
`url`	Site web de l’utilisateur
`protected`	Statut de compte protégé
`pinned_tweet_id`	ID de la Publication épinglée

Gérer les erreurs

Utilisateur introuvable

{
  "errors": [
    {
      "resource_type": "user",
      "title": "Not Found Error",
      "detail": "Could not find user with username: [nonexistent_user]."
    }
  ]
}

Utilisateur protégé

Les données des utilisateurs protégés sont toujours renvoyées, mais vous ne pourrez accéder à leurs Publications que si vous les suivez.

Prochaines étapes

Utilisateur authentifié

Récupérer l’utilisateur connecté

Guide d’intégration

Concepts essentiels et bonnes pratiques

Référence de l’API

Documentation complète du point de terminaison

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 : recherche d’utilisateurs

Rechercher par id

Un seul utilisateur

Réponse

Plusieurs utilisateurs

Recherche par nom d’utilisateur

Un seul utilisateur

Plusieurs utilisateurs

Champs disponibles

Gérer les erreurs

Utilisateur introuvable

Utilisateur protégé

Prochaines étapes

Utilisateur authentifié

Guide d’intégration

Référence de l’API