メインコンテンツへスキップ
User lookup エンドポイントを使用すると、1人または複数のユーザーのプロフィール情報を取得できます。ユーザーを id やユーザー名で検索したり、現在認証されているユーザーの詳細を取得したりできます。

概要

ユーザーIDで

一意のユーザーIDでユーザーを取得します

ユーザー名で

@handle (ユーザー名) でユーザーを取得します

複数ユーザー

1 回のリクエストで最大 100 人のユーザーを取得します

認証済みユーザー

認証中のユーザーの詳細を取得します

エンドポイント

MethodEndpointDescription
GET/2/users/:idID でユーザーを取得
GET/2/usersID で最大 100 件のユーザーを取得
GET/2/users/by/username/:usernameユーザー名でユーザーを取得
GET/2/users/byユーザー名で最大 100 件のユーザーを取得
GET/2/users/me認証済みのユーザーを取得

リクエスト例

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

レスポンスの例

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

はじめに

前提条件

ユーザー検索クイックスタート

ID またはユーザー名でユーザーを検索します

認証済みユーザークイックスタート

現在のユーザーのプロフィールを取得します

連携ガイド

基本概念とベストプラクティス

APIリファレンス

エンドポイントの詳細ドキュメント