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

このガイドでは、/me エンドポイントを使用して、現在認証されているユーザーのプロフィールを取得する方法を説明します。

前提条件始める前に、次のものが必要です。

承認済みの App を持つ開発者アカウント
ユーザーアクセストークン (OAuth 1.0a または OAuth 2.0 PKCE)

認証済みユーザーを取得する

User Access Token を使用して /me エンドポイントにリクエストを送信します。

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# 認証済みユーザーを取得
response = client.users.get_me(
    user_fields=["created_at", "description", "verified", "public_metrics", "profile_image_url"]
)

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

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// 認証済みユーザーを取得
const response = await client.users.getMe({
  userFields: ["created_at", "description", "verified", "public_metrics", "profile_image_url"],
});

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

レスポンス

{
  "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,
    "profile_image_url": "https://pbs.twimg.com/profile_images/...",
    "public_metrics": {
      "followers_count": 583423,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

ユースケース

/me エンドポイントは次のような場合に不可欠です:

認証の確認 — ユーザーが正しく認証されていることを確認する
ユーザー ID の取得 — 他の API 呼び出しのために認証済みユーザーの ID を取得する
エクスペリエンスのパーソナライズ — アプリ内でユーザーのプロフィールを表示する
代理でのリクエスト — どのユーザーの代理としてリクエストを行っているか把握する

固定されたポストを含める

ユーザーの固定されたポストを取得します:

cURL

curl "https://api.x.com/2/users/me?\
user.fields=pinned_tweet_id&\
expansions=pinned_tweet_id&\
tweet.fields=created_at,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# 固定されたポスト付きの認証済みユーザーを取得
response = client.users.get_me(
    user_fields=["pinned_tweet_id"],
    expansions=["pinned_tweet_id"],
    tweet_fields=["created_at", "text"]
)

print(f"Username: {response.data.username}")
# 固定されたポストは response.includes.tweets に含まれています

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// 固定されたポスト付きの認証済みユーザーを取得
const response = await client.users.getMe({
  userFields: ["pinned_tweet_id"],
  expansions: ["pinned_tweet_id"],
  tweetFields: ["created_at", "text"],
});

console.log(`Username: ${response.data?.username}`);
// 固定されたポストは response.includes?.tweets に含まれています

展開を含むレスポンス

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "pinned_tweet_id": "1234567890"
  },
  "includes": {
    "tweets": [
      {
        "id": "1234567890",
        "text": "Welcome to my profile!",
        "created_at": "2024-01-01T00:00:00.000Z"
      }
    ]
  }
}

利用可能なフィールド

Field	Description
`created_at`	アカウント作成日時
`description`	ユーザーの自己紹介
`profile_image_url`	プロフィール画像のURL
`verified`	認証ステータス
`public_metrics`	フォロワー数／フォロー数
`location`	ユーザーが設定した場所
`url`	ユーザーのウェブサイト
`protected`	保護されたアカウントかどうか
`pinned_tweet_id`	固定されたポストのID

認証要件

/me エンドポイントには User Context 認証が必要です。App-Only (ベアラートークン) 認証は利用できません。

次のいずれかを使用してください。

次のステップ

ユーザー検索

他のユーザーを検索

連携ガイド

主要な概念とベストプラクティス

APIリファレンス

エンドポイントの完全なリファレンス

概要

投稿

ユーザー

ダイレクトメッセージ

いいね

リスト

スペース

コミュニティ

コミュニティノート

トレンド

ニュース

メディア

X のアクティビティ

利用状況

ストリーム接続

コンプライアンス

Enterprise v2

いいねのストリーム

GNIP 2.0

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

認証済みユーザーを取得する

レスポンス

ユースケース

固定されたポストを含める

展開を含むレスポンス

利用可能なフィールド

認証要件

次のステップ

ユーザー検索

連携ガイド

APIリファレンス