メインコンテンツへスキップ
このガイドでは、blocks エンドポイントをアプリケーションに統合するために必要な主要な概念を解説します。

​
認証

Blocks のエンドポイントにはユーザー認証が必要です。
MethodDescription
OAuth 2.0 Authorization Code with PKCE新規アプリケーションに推奨されます
OAuth 1.0a User Contextレガシーサポート
App-Only 認証はサポートされていません。必ずユーザーの権限で認証する必要があります。

​
必要なスコープ (OAuth 2.0)

スコープ必要となる操作
block.readブロック済みアカウントの取得
block.writeアカウントのブロックおよびブロック解除
users.readblock スコープと併用時に必須

​
エンドポイント概要

MethodEndpointDescription
GET/2/users/:id/blockingブロック済みアカウントのリストを取得
POST/2/users/:id/blockingアカウントをブロックする
DELETE/2/users/:source_user_id/blocking/:target_user_idアカウントのブロックを解除する

​
フィールドと expansions

​
既定のレスポンス

{
  "data": [
    {
      "id": "1234567890",
      "name": "Example User",
      "username": "example"
    }
  ]
}

​
利用可能なフィールド

フィールド説明
created_atアカウント作成日時
descriptionユーザーの自己紹介
profile_image_urlアバターのURL
public_metricsフォロワー数／フォロー数
verified認証ステータス
拡張説明
pinned_tweet_idユーザーが固定表示しているポスト

​
ブロックするとどうなるか

相手ができなくなること

  • (ログアウトしていない限り) あなたの投稿を見る
  • あなたをフォローする
  • あなたにDMを送る
  • あなたをリストに追加する
  • 写真にあなたをタグ付けする

自分ができなくなること

  • 相手の投稿を見る
  • 相手をフォローする
  • 相手にDMを送る
フォロワーをブロックすると、その相手は自動的にフォロー解除されます。
大規模なブロックリストを持つユーザーの場合、結果はページネーション (ページ分割) されます:
cURL
# 最初のリクエスト
curl "https://api.x.com/2/users/123/blocking?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

# ページネーション用トークンを使った後続リクエスト
curl "https://api.x.com/2/users/123/blocking?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​
エラー処理

ステータスエラー対処方法
400無効なリクエストユーザーIDの形式を確認してください
401未認証アクセストークンを確認してください
403アクセス禁止スコープと権限を確認してください
404見つかりませんユーザーが存在しません
429リクエストが多すぎます時間をおいて再試行してください

​
次のステップ

クイックスタート

最初のブロックリクエストを送信する

ミュート

ブロックの代わりにユーザーをミュートする

APIリファレンス

エンドポイントの完全なドキュメント

サンプルコード

実行可能なコード例