> ## Documentation Index > Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 리스트 멤버 조회 export const Button = ({href, children}) => { return
; };
### 리스트 멤버 조회: 표준 v1.1과 X API v2 비교
표준 v1.1의 [GET lists/members](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/get-lists-members) 및 [GET lists/memberships](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/get-lists-memberships) 엔드포인트를 사용해 왔다면, 이 가이드는 표준 v1.1과 X API v2 리스트 멤버 엔드포인트 간의 유사점과 차이점을 이해하는 데 도움이 됩니다. * **유사점** * 인증 방식 * **차이점** * 엔드포인트 URL * 요청 한도 * App 및 Project 요구사항 * 요청당 데이터 객체 한도 * 응답 데이터 형식 * 요청 파라미터
#### 유사점
**인증** 두 엔드포인트 버전 모두 [OAuth 1.0a 사용자 컨텍스트](/ko/resources/fundamentals/authentication#oauth-1-0a-2)와 [App only](/ko/resources/fundamentals/authentication#oauth-2-0)를 지원합니다. 따라서 이전에 표준 v1.1 리스트 멤버 엔드포인트 중 하나를 사용하고 있었다면, X API v2 버전으로 마이그레이션하더라도 동일한 인증 방식을 계속 사용할 수 있습니다. 사용 중인 인증 라이브러리/패키지에 따라 App only 인증이 시작하기에 가장 간편한 방법일 가능성이 높으며, 간단한 요청 헤더만으로 설정할 수 있습니다. App only 액세스 토큰을 생성하는 방법을 알아보려면 [이 App only 가이드](/ko/resources/fundamentals/authentication#bearer-token-also-known-as-app-only)를 참조하세요.
#### 차이점
**엔드포인트 URL** * 표준 v1.1 엔드포인트: * GET [https://api.x.com/1.1/lists/members.json](https://api.x.com/1.1/lists/members.json) (지정된 리스트의 멤버 조회) * GET [https://api.x.com/1.1/lists/memberships.json](https://api.x.com/1.1/lists/memberships.json) (사용자가 멤버로 속한 리스트 조회) * X API v2 엔드포인트: * GET [https://api.x.com/2/lists/:id/members](https://api.x.com/2/lists/:id/members) (지정된 리스트의 멤버 조회) * GET [https://api.x.com/2/users/:id/list\_memberships](https://api.x.com/2/users/:id/list\_memberships) (사용자가 멤버로 속한 리스트 조회) **요청 한도** | | | | :------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Standard v1.1** | **X API v2** | | /1.1/lists/members.json

OAuth 1.0a User Context 사용 시 15분당 900회 요청 가능

App only 사용 시 15분당 15회 요청 가능 | /2/lists/:id/members

OAuth 1.0a User Context 사용 시 15분당 900회 요청 가능

OAuth 2.0 Authorization Code with PKCE 사용 시 15분당 900회 요청 가능

App only 사용 시 15분당 900회 요청 가능 | | /1.1/lists/memberships.json

OAuth 1.0a User Context 사용 시 15분당 15회 요청 가능

App only 사용 시 15분당 15회 요청 가능 | /2/users/:id/list\_memberships

OAuth 1.0a User Context 사용 시 15분당 15회 요청 가능

OAuth 2.0 Authorization Code with PKCE 사용 시 15분당 15회 요청 가능

App only 사용 시 15분당 15회 요청 가능 | **App 및 Project 요구 사항** X API v2 엔드포인트를 사용하려면 요청을 인증할 때 [developer App](/ko/resources/fundamentals/developer-apps) 중 [Project](/ko/resources/fundamentals/developer-apps)에 연결된 App의 자격 증명을 사용해야 합니다. 모든 X API v1.1 엔드포인트는 개별 App 또는 Project에 연결된 App의 자격 증명을 사용할 수 있습니다. **요청당 데이터 객체 한도** 표준 v1.1 /1.1/lists/members 엔드포인트에서는 요청당 최대 5000명의 사용자를 반환할 수 있습니다. 새로운 v2 엔드포인트에서는 요청당 최대 100명의 사용자를 반환할 수 있습니다. 기본적으로 100개의 사용자 객체가 반환되며, 결과 개수를 변경하려면 1–100 사이의 숫자와 함께 쿼리 파라미터 max\_results= 를 전달해야 합니다. 그런 다음 응답 페이로드에 반환된 next\_token 값을 다음 요청의 pagination\_token 쿼리 파라미터로 전달할 수 있습니다. 또한 /1.1/lists/memberships 엔드포인트에서는 요청당 최대 1000개의 리스트를 반환할 수 있습니다. v2로 대체된 엔드포인트에서는 요청당 최대 100개의 리스트를 반환할 수 있습니다. 기본적으로 100개의 리스트 객체가 반환되며, 결과 개수를 변경하려면 /1.1/lists/members 와 동일한 방식으로 쿼리 파라미터 max\_results= 및 pagination\_token 을 사용하면 됩니다. **응답 데이터 형식** 표준 v1.1 엔드포인트 버전과 X API v2 엔드포인트 버전 간의 가장 큰 차이점 중 하나는 페이로드에 어떤 필드가 반환될지 선택하는 방식입니다. 표준 엔드포인트에서는 많은 응답 필드가 기본적으로 반환되며, 이후 파라미터를 사용해 페이로드에 추가로 반환할 필드 또는 필드 집합을 지정할 수 있습니다. X API v2 버전 /users/:id/list\_memberships 는 기본적으로 리스트 id 및 name 필드를 반환합니다. 추가 필드나 객체를 요청하려면 [fields](/ko/x-api/fundamentals/fields) 및 [expansions](/ko/x-api/fundamentals/expansions) 파라미터를 사용해야 합니다. 이 엔드포인트에서 요청한 모든 리스트 필드는 기본 리스트 객체에 반환됩니다. 확장된 객체와 필드는 응답 내 includes 객체로 반환됩니다. 그런 다음 기본 객체와 확장된 객체에 모두 포함된 ID를 매칭하여 확장된 객체를 기본 리스트 객체와 연결할 수 있습니다.  다음은 사용할 수 있는 리스트 필드 및 expansions 예시입니다: * created\_at * follower\_count * member\_count * owner\_id * description * private | | | | :----------------------------- | :---------------- | | **Endpoint** | **Expansion** | | /2/lists/:id/members | pinned\_tweet\_id | | /2/users/:id/list\_memberships | owner\_id | 이러한 새 파라미터에 대해 더 자세히 알아보려면 각 가이드나 [fields 및 expansions 사용 방법](/ko/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions)에 대한 가이드를 참고하시기 바랍니다.  표준 v1.1 필드를 새로운 v2 필드에 매핑하는 데 도움이 될 수 있는 [데이터 형식 마이그레이션 가이드](/ko/x-api/migrate/data-format-migration)도 준비해 두었습니다. 이 가이드는 특정 필드를 반환하기 위해 v2 요청에 함께 전달해야 하는 구체적인 expansion 및 field 파라미터도 제공해 줍니다.  특정 필드를 요청하는 방식의 변경 사항 외에도, X API v2는 [게시물](/ko/x-api/fundamentals/data-dictionary#tweet) 및 [user](/ko/x-api/fundamentals/data-dictionary#user) 객체를 포함하여 API가 반환하는 객체에 대해 새로운 JSON 설계를 도입하고 있습니다. * JSON 루트 레벨에서, 표준 엔드포인트는 게시물 객체를 `statuses` 배열로 반환하는 반면, X API v2는 `data` 배열로 반환합니다.  * Retweeted 및 Quoted "statuses"를 참조하는 대신, X API v2 JSON은 Retweeted 및 Quoted Tweet을 참조합니다. `contributors` 및 `user.translator_type`과 같은 많은 레거시 및 사용 중단(deprecated) 필드는 제거되고 있습니다.  * 게시물 객체의 `favorites`와 user 객체의 `favourites`를 모두 사용하는 대신, X API v2는 `like`라는 용어를 사용합니다.  * X는 값이 없는 JSON 값(예: `null`)은 페이로드에 기록하지 않는 컨벤션을 채택하고 있습니다. 게시물 및 user 속성은 null이 아닌 값을 가질 때만 포함됩니다. **요청 파라미터** 다음 표준 v1.1 요청 파라미터는 X API v2에서 다음과 같이 대응됩니다. **리스트 멤버 조회** | | | | :------------------ | :---------------- | | **Standard v1.1** | **X API v2** | | list\_id | id | | slug | 해당 없음 | | owner\_screen\_name | 해당 없음 | | owner\_id | 해당 없음 | | count | max\_results | | cursor | pagination\_token | | include\_entities | 해당 없음 | | skip\_status | 해당 없음 | **리스트 멤버십 조회** | | | | :---------------- | :---------------- | | **Standard v1.1** | **X API v2** | | user\_id | id | | screen\_name | 해당 없음 | | count | max\_results | | cursor | pagination\_token |