ID でルックアップ
単一ユーザー
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")
# 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" });
// 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}`);
レスポンス
レスポンス例{
"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
}
}
}
複数ユーザー
1 度に最大 100 ユーザーをルックアップします: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")
# ID で複数ユーザーを取得
response = client.users.get_users(
ids=["2244994945", "783214", "6253282"],
user_fields=["username", "verified"]
)
for user in response.data:
print(f"{user.username} - Verified: {user.verified}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// ID で複数ユーザーを取得
const response = await client.users.getUsers({
ids: ["2244994945", "783214", "6253282"],
userFields: ["username", "verified"],
});
response.data?.forEach((user) => {
console.log(`${user.username} - Verified: ${user.verified}`);
});
username でルックアップ
単一ユーザー
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")
# username でユーザーを取得
response = client.users.get_by_username(
"XDevelopers",
user_fields=["created_at", "description", "verified"]
)
print(f"ID: {response.data.id}")
print(f"Name: {response.data.name}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// username でユーザーを取得
const response = await client.users.getByUsername("XDevelopers", {
userFields: ["created_at", "description", "verified"],
});
console.log(`ID: ${response.data?.id}`);
console.log(`Name: ${response.data?.name}`);
複数ユーザー
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")
# username で複数ユーザーを取得
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" });
// username で複数ユーザーを取得
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}`);
});
利用可能なフィールド
| Field | Description |
|---|---|
created_at | アカウント作成日 |
description | ユーザーの bio |
profile_image_url | アバターの URL |
verified | 認証済みステータス |
public_metrics | フォロワー/フォロー中の件数 |
location | ユーザーが設定した所在地 |
url | ユーザーの Web サイト |
protected | 非公開アカウントのステータス |
pinned_tweet_id | ピン留めした Post の ID |
エラー処理
ユーザーが見つからない
{
"errors": [
{
"resource_type": "user",
"title": "Not Found Error",
"detail": "Could not find user with username: [nonexistent_user]."
}
]
}
非公開ユーザー
非公開ユーザーのデータは返されますが、フォローしていない限りその Post にはアクセスできません。次のステップ
認証済みユーザー
現在のユーザーを取得
連携ガイド
主要な概念とベストプラクティス
API リファレンス
エンドポイントの詳細ドキュメント