메인 콘텐츠로 건너뛰기
이 가이드는 애플리케이션에 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사용자가 고정한 게시물

​
fields가 포함된 예시

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"

페이지네이션 가이드

페이지네이션에 대해 자세히 알아보기

​
동작 방식의 차이

​
음소거 vs 차단

기능음소거차단
상대방 포스트 보기아니요 (숨김)아니요
상대방이 내 포스트 보기예아니요
상대방이 나를 팔로우예 (팔로우 가능)아니요 (해제됨)
상대방이 DM 보내기예아니요
알림 전송아니요아니요
음소거는 비공개입니다. 음소거된 사용자는 알림을 받지 못하며, 자신이 음소거되었는지 알 수 없습니다.

​
오류 처리

StatusErrorSolution
400잘못된 요청사용자 id 형식을 확인하세요
401인증되지 않음액세스 토큰을 확인하세요
403권한 없음스코프와 권한을 확인하세요
404찾을 수 없음사용자가 존재하지 않습니다
429요청이 너무 많음기다렸다가 다시 시도하세요

​
다음 단계

빠른 시작

첫 음소거 요청 보내기

차단

음소거 대신 사용자 차단하기

API 참조 문서

전체 엔드포인트 문서

샘플 코드

실행 가능한 코드 예제