Skip to main content

​
X API의 follows 엔드포인트 비교

​
팔로우 조회

v2 팔로우 조회 엔드포인트는 기존 Standard v1.1 followers/ids, v1.1 followers/list, v1.1 friends/ids, 그리고 v1.1 friends/list 엔드포인트를 대체합니다. 다음 표에서는 다양한 유형의 팔로우 조회 엔드포인트를 비교합니다:
설명Standard v1.1X API v2
지원 HTTP 메서드GETGET
호스트 도메인https://api.x.comhttps://api.x.com
엔드포인트 경로/1.1/friends/ids.json

/1.1/friends/list.json

/1.1/followers/ids.json

/1.1/followers/list.json		/2/users/:id/following

/2/users/:id/followers
인증OAuth 1.0a User Context

App only		OAuth 1.0a User Context

OAuth 2.0 Authorization Code with PKCE

App only
기본 요청 요청 한도15분당 15회 요청(사용자 기준)

15분당 15회 요청(App 기준)		15분당 15회 요청(사용자 기준)

15분당 15회 요청(App 기준)
응답당 최대 사용자 수GET friends/id 및 GET followers/id는 한 페이지당 최대 5,000개의 사용자 ID를 반환합니다.



GET friends/list 및 GET followers/list는 한 페이지당 최대 200개의 사용자 객체를 반환합니다.		한 페이지당 1,000개의 사용자 객체
페이지네이션토큰이 next_cursor 필드로 반환되며, 이 값을 cursor 파라미터 값으로 전달하면 다음 페이지의 결과를 반환할 수 있습니다.토큰이 next_token 필드로 반환되며, 이 값을 token 파라미터 값으로 전달하면 다음 페이지의 결과를 반환할 수 있습니다.

또한 v2 페이로드에는 previous_token 필드도 포함되며, 이 값을 pagination_token 파라미터와 함께 전달하면 이전 페이지의 결과를 반환할 수 있습니다.
JSON 형식Standard v1.1 형식X API v2 형식 (fields 및 expansions 요청 파라미터에 의해 결정되며, v1.1 형식과는 하위 호환되지 않음)

Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법에 대한 자세한 내용은 데이터 형식 마이그레이션 가이드를 참조하세요.
페이로드에서 어떤 필드를 반환할지 선택 지원✔
게시물 annotations 필드 지원✔
새로운 메트릭 필드 요청 지원✔
conversation_id 필드 지원✔
project와 연결된 developer App의 자격 증명 사용 필수✔

​
팔로우 관리

팔로우 관리를 위한 v2 엔드포인트는 기존 표준 v1.1 POST friendships/create 및 POST friendships/destroy 엔드포인트를 대체합니다. 다음 표에서는 표준 v1.1과 X API v2의 팔로우 생성 엔드포인트를 비교합니다.

​
사용자를 팔로우하기

설명표준 v1.1X API v2
지원되는 HTTP 메서드POSTPOST
호스트 도메인https://api.x.comhttps://api.x.com
엔드포인트 경로/1.1/friendships/create.json/2/users/:id/following
인증OAuth 1.0a 사용자 컨텍스트OAuth 1.0a 사용자 컨텍스트

OAuth 2.0 Authorization Code with PKCE
기본 요청 한도15분당 50회 요청15분당 50회 요청
사용자당 하루 최대 작업 횟수400400
App당 하루 최대 작업 횟수10001000
Project와 연결된 개발자 App의 자격 증명을 사용해야 합니다✔️

​
사용자 언팔로우

다음 표는 Standard v1.1과 X API v2의 팔로우 삭제 엔드포인트를 비교한 것입니다:
설명Standard v1.1X API v2
지원되는 HTTP 메서드POSTDELETE
호스트 도메인https://api.x.comhttps://api.x.com
엔드포인트 경로/1.1/friendships/destroy.json/2/users/:source_user_id/following/:target_user_id
인증OAuth 1.0a 사용자 컨텍스트OAuth 1.0a 사용자 컨텍스트

OAuth 2.0 Authorization Code with PKCE
기본 요청 요청 한도15분당 15회 요청 (사용자 기준)15분당 50회 요청 (사용자 기준)
App당 최대 일일 작업 수제한 없음500
Project와 연결된 developer App의 자격 증명 필요 여부✔️
기타 마이그레이션 리소스 | 팔로우 조회: Standard v1.1에서 X API v2로 팔로우 관리: Standard v1.1과 X API v2 비교 X API 마이그레이션 허브