メインコンテンツへスキップ
本ガイドでは、mutes エンドポイントをアプリケーションに統合するために必要となる主要な概念について説明します。

​
認証

ミュートのエンドポイントで非公開のミュートリストにアクセスするには、ユーザー認証が必要です。
MethodDescription
OAuth 2.0 Authorization Code with PKCE新しいアプリケーションに推奨
OAuth 1.0a User Contextレガシー向けサポート
App-only 認証はサポートされていません。ユーザーを代表して認証する必要があります。

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

Scope必要な操作
mute.readミュート済みアカウントの取得
mute.writeアカウントのミュートおよびミュート解除
users.readミュート関連スコープを使用する場合に必須

​
エンドポイント概要

MethodEndpointDescription
GET/2/users/:id/mutingミュート中のアカウント一覧を取得
POST/2/users/:id/mutingアカウントをミュートする
DELETE/2/users/:source_user_id/muting/: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ユーザーがピン留めしているポスト

​
フィールド指定の例

cURL
curl "https://api.x.com/2/users/123456789/muting?\
user.fields=username,verified,created_at&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
ミュートしているアカウントが多いユーザーの場合、結果は複数ページに分割されます:
cURL
# 最初のリクエスト
curl "https://api.x.com/2/users/123/muting?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

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

ページネーションガイド

ページネーションの詳細についてはガイドを参照してください

​
挙動の違い

​
ミュートとブロックの違い

機能ミュートブロック
相手の投稿を見られるかいいえ (非表示)いいえ
相手があなたの投稿を見られるかはいいいえ
相手があなたをフォローできるかはい (フォロー可能)いいえ (フォロー解除される)
相手があなたにDMを送れるかはいいいえ
通知が送信されるかいいえいいえ
ミュートは非公開の操作であり、ミュートされたユーザーには通知が行かず、自分がミュートされたことを知ることもできません。

​
エラー処理

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

​
次のステップ

クイックスタート

初めてのミュートリクエストを実行する

ブロック

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

APIリファレンス

エンドポイントの詳細ドキュメント

サンプルコード

実行可能なコード例