クイックスタート

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

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

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

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

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

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

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

cURL

curl "https://api.x.com/2/users/123456789/blocking?\
user.fields=username,verified,created_at&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# ページネーションを使ってブロックしているユーザーを取得する
for page in client.users.get_blocking(
    "123456789",
    user_fields=["username", "verified", "created_at"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Created: {user.created_at}")

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

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

// ページネーションを使ってブロックしているユーザーを取得する
const paginator = client.users.getBlocking("123456789", {
  userFields: ["username", "verified", "created_at"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(`${user.username} - Created: ${user.created_at}`);
  });
}

レスポンスを確認する

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

ユーザーをブロックする

対象ユーザーを特定する

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

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

cURL

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

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# ユーザーをブロックする
response = client.users.block(
    source_user_id="123456789",
    target_user_id="9876543210"
)
print(f"Blocking: {response.data.blocking}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// ユーザーをブロックする
const response = await client.users.block("123456789", {
  targetUserId: "9876543210",
});
console.log(`Blocking: ${response.data?.blocking}`);

ブロックを確認する

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

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

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

cURL

curl -X DELETE "https://api.x.com/2/users/123456789/blocking/9876543210" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# ユーザーのブロックを解除する
response = client.users.unblock(
    source_user_id="123456789",
    target_user_id="9876543210"
)
print(f"Blocking: {response.data.blocking}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// ユーザーのブロックを解除する
const response = await client.users.unblock("123456789", "9876543210");
console.log(`Blocking: ${response.data?.blocking}`);

ブロック解除を確認する

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

次のステップ

ミュート

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

フォロー

フォローを管理する

連携ガイド

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

APIリファレンス

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

概要

投稿

ユーザー

ダイレクトメッセージ

いいね

リスト

スペース

コミュニティ

コミュニティノート

トレンド

ニュース

メディア

X のアクティビティ

利用状況

ストリーム接続

コンプライアンス

Enterprise v2

いいねのストリーム

GNIP 2.0

クイックスタート

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

ユーザーをブロックする

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

次のステップ

ミュート

フォロー

連携ガイド

APIリファレンス

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

​ユーザーをブロックする

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

​次のステップ

ミュート

フォロー

連携ガイド

APIリファレンス

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

ユーザーをブロックする

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

次のステップ