메인 콘텐츠로 건너뛰기
이 가이드는 blocks 엔드포인트를 애플리케이션에 통합하는 데 필요한 핵심 개념을 다룹니다.

​
인증

차단(Block) 엔드포인트에는 사용자 인증이 필요합니다:
MethodDescription
OAuth 2.0 Authorization Code with PKCE새로운 애플리케이션에 권장됩니다
OAuth 1.0a User Context기존 방식(레거시) 지원용
App-Only 인증은 지원되지 않습니다. 반드시 사용자 계정을 대신하여 인증해야 합니다.

​
필수 스코프(OAuth 2.0)

Scope필요한 작업
block.read차단된 계정 조회
block.write계정 차단 및 차단 해제
users.readblock 관련 스코프와 함께 필요

​
엔드포인트 개요

MethodEndpointDescription
GET/2/users/:id/blocking차단된 계정 목록 조회
POST/2/users/:id/blocking계정 차단
DELETE/2/users/:source_user_id/blocking/: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사용자가 고정해 둔 게시물

​
차단하면 어떻게 되나요

상대방이 할 수 없는 것

  • (로그아웃한 상태가 아니라면) 내 포스트 보기
  • 나를 팔로우하기
  • 나에게 DM 보내기
  • 나를 리스트에 추가하기
  • 사진에서 나를 태그하기

내가 할 수 없는 것

  • 상대방의 포스트 보기
  • 상대방을 팔로우하기
  • 상대방에게 DM 보내기
나를 팔로우하는 사용자를 차단하면, 그 사용자는 자동으로 팔로우가 해제됩니다.
차단 목록이 많은 사용자의 경우 결과가 페이지네이션 방식으로 제공됩니다:
cURL
# 첫 번째 요청
curl "https://api.x.com/2/users/123/blocking?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

# 페이지네이션 토큰을 사용한 다음 요청
curl "https://api.x.com/2/users/123/blocking?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​
오류 처리

Status오류해결 방법
400잘못된 요청사용자 ID 형식을 확인하세요
401인증되지 않음액세스 토큰을 확인하세요
403권한 없음scope 및 권한을 확인하세요
404찾을 수 없음사용자가 존재하지 않습니다
429요청이 너무 많음잠시 기다렸다가 다시 시도하세요

​
다음 단계

빠른 시작

첫 blocks 요청을 만들어 보세요

Mutes

차단 대신 사용자를 뮤트하세요

API 참조 문서

전체 엔드포인트 문서

샘플 코드

실행 가능한 코드 예제