クイックスタート

ユーザーをブロックおよびブロック解除し、ブロックしているユーザーのリストを取得する

このガイドでは、ユーザーをブロックおよびブロック解除する方法と、ブロックしているユーザーのリスト (ブロックリスト) を取得する方法を説明します。

前提条件

作業を始める前に、以下を用意してください。

• 承認済みの App を持つ開発者アカウント
• User Access Token (OAuth 1.0a または OAuth 2.0 PKCE)

---

​

ブロックしているユーザーを取得する

1. 自分のユーザーIDを取得する

   ブロックリストを取得するには、認証済みのユーザーのIDが必要です。/2/users/me エンドポイントから取得するか、トークンに含まれているIDを使用できます。

2. ブロックリストを取得する

   cURL

   shellscript

   curl "https://api.x.com/2/users/123456789/blocking?\
   user.fields=username,verified,created_at&\
   max_results=100" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
3. レスポンスを確認する

   {
     "data": [
       {
         "id": "17874544",
         "name": "Example User",
         "username": "example_user",
         "verified": false,
         "created_at": "2008-12-04T18:51:57.000Z"
       }
     ],
     "meta": {
       "result_count": 1,
       "next_token": "abc123"
     }
   }
   

---

​

ユーザーをブロックする

1. 対象ユーザーを特定する

   ブロックしたいアカウントのユーザー ID を取得します。

2. ブロックリクエストを送信する

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/users/123456789/blocking" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"target_user_id": "9876543210"}'
   
3. ブロックを確認する

   {
     "data": {
       "blocking": true
     }
   }
   

---

​

ユーザーのブロックを解除する

1. ブロック解除リクエストを送信する

   cURL

   shellscript

   curl -X DELETE "https://api.x.com/2/users/123456789/blocking/9876543210" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
2. ブロック解除を確認する

   {
     "data": {
       "blocking": false
     }
   }
   

---

​

次のステップ

ミュート

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

フォロー

フォローを管理する

連携ガイド

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

APIリファレンス

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