Mutes Lookup

이 가이드는 X API를 사용하여 뮤트된 사용자 목록을 조회하는 방법을 안내합니다.

사전 요구사항시작하기 전에 다음이 필요합니다:

승인된 App이 포함된 developer account
User Access Token (OAuth 1.0a 또는 OAuth 2.0 PKCE)

뮤트된 사용자 가져오기

사용자 ID 가져오기

인증된 사용자의 ID가 필요합니다. user lookup 엔드포인트를 사용하거나 Access Token(숫자 부분이 사용자 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"
  }
}

추가 데이터 포함하기

고정된 Post와 같은 관련 데이터를 가져오려면 expansion을 사용하세요:

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")

# expansion과 함께 뮤트된 사용자 가져오기
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" });

// expansion과 함께 뮤트된 사용자 가져오기
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이 포함된 응답

결과 페이지네이션

다음 단계