Mutes Lookup

このガイドでは、X API を利用してミュート中のユーザー一覧を取得する手順を説明します。

前提条件始める前に、以下が必要です:

承認済みの App がある developer account
ユーザー Access Token (OAuth 1.0a または OAuth 2.0 PKCE)

ミュート中のユーザーを取得

user ID を取得

認証済みユーザーの ID が必要です。user lookup エンドポイントを使って取得するか、Access Token から確認できます (数値部分が user ID)。

ミュート中のユーザーをリクエスト

cURL

curl "https://api.x.com/2/users/123456789/muting?\
user.fields=created_at,username,verified&\
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_muting(
    "123456789",
    user_fields=["created_at", "username", "verified"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Muted")

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

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

// ページネーションでミュート中のユーザーを取得
const paginator = client.users.getMuting("123456789", {
  userFields: ["created_at", "username", "verified"],
  maxResults: 100,
});

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

レスポンスを確認

{
  "data": [
    {
      "id": "2244994945",
      "name": "X Developers",
      "username": "XDevelopers",
      "created_at": "2013-12-14T04:35:55.000Z",
      "verified": true
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "1710819323648428707"
  }
}

追加データを含める

expansions を使うと、pinned Post などの関連データを取得できます:

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# expansions つきでミュート中のユーザーを取得
for page in client.users.get_muting(
    "123456789",
    user_fields=["created_at"],
    expansions=["pinned_tweet_id"],
    tweet_fields=["created_at"]
):
    for user in page.data:
        print(f"{user.username}")
    # ピン留めされた Post は page.includes.tweets にあります

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

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

// expansions つきでミュート中のユーザーを取得
const paginator = client.users.getMuting("123456789", {
  userFields: ["created_at"],
  expansions: ["pinned_tweet_id"],
  tweetFields: ["created_at"],
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(user.username);
  });
  // ピン留めされた Post は page.includes?.tweets にあります
}

expansion 付きのレスポンス

レスポンス例

{
  "data": [
    {
      "username": "XDevelopers",
      "created_at": "2013-12-14T04:35:55.000Z",
      "id": "2244994945",
      "name": "X Developers",
      "pinned_tweet_id": "1430984356139470849"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-08-26T20:03:51.000Z",
        "id": "1430984356139470849",
        "text": "Help us build a better X Developer Platform!..."
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}

結果をページネーション

SDK は自動でページネーションを処理します。cURL の場合はレスポンスの next_token を使います:

curl "https://api.x.com/2/users/123456789/muting?\
max_results=100&\
pagination_token=1710819323648428707" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Mutes Lookup

ミュート中のユーザーを取得

追加データを含める

expansion 付きのレスポンス

結果をページネーション

次のステップ

Manage mutes

API リファレンス

​ミュート中のユーザーを取得

​追加データを含める

​expansion 付きのレスポンス

​結果をページネーション

​次のステップ

Manage mutes

API リファレンス

ミュート中のユーザーを取得

追加データを含める

expansion 付きのレスポンス

結果をページネーション

次のステップ