Démarrage rapide : recherche d’utilisateurs

Rechercher des utilisateurs par ID ou par nom d’utilisateur

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

Prérequis

Avant 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

shellscript

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

​

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

shellscript

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

---

​

Recherche par nom d’utilisateur

​

Un seul utilisateur

cURL

shellscript

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

​

Plusieurs utilisateurs

cURL

shellscript

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

---

​

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