> ## 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.

# v1에서 v2로

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

<div id="list-lookup-standard-v11-compared-to-x-api-v2">
  ### 리스트 조회: 표준 v1.1과 X API v2 비교
</div>

표준 v1.1의 [GET lists/show](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/get-lists-show) 및 [GET lists/ownerships](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/get-lists-ownerships) 엔드포인트를 사용해 왔다면, 이 가이드는 표준 v1.1과 X API v2 리스트 조회 엔드포인트 간의 공통점과 차이점을 이해하는 데 도움이 되도록 작성되었습니다.

* **유사점**
  * 인증 방식
  * 요청 한도
* **차이점**
  * 엔드포인트 URL
  * App 및 Project 요구 사항
  * 요청당 데이터 객체 수 제한
  * 응답 데이터 형식
  * 요청 매개변수

<div id="similarities">
  #### 유사점
</div>

**인증**

두 엔드포인트 버전은 [OAuth 1.0a 사용자 컨텍스트](/ko/resources/fundamentals/authentication#oauth-1-0a-2)와 [App only](/ko/resources/fundamentals/authentication#app-only-authentication-and-oauth-2-0-bearer-token)를 모두 지원합니다. 따라서 기존에 표준 v1.1 리스트 조회용 엔드포인트를 사용하고 있었다면, X API v2 버전으로 마이그레이션하더라도 동일한 인증 방식을 계속 사용할 수 있습니다.

사용 중인 인증 라이브러리/패키지에 따라 다를 수 있지만, App only 인증은 대개 시작하기에 가장 쉬운 방식이며 간단한 요청 헤더로 설정할 수 있습니다. App only 액세스 토큰을 생성하는 방법을 알아보려면 [이 App only 가이드](/ko/resources/fundamentals/authentication#using-and-generating-an-app-only-bearer-token)를 참조하세요.

**요청 한도**

|                                                                                                           |                                                                                                                                                                          |
| :-------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Standard v1.1**                                                                                         | **X API v2**                                                                                                                                                             |
| /1.1/lists/show\.json<br /><br />OAuth 1.0a 사용자 컨텍스트로 15분당 75개의 요청<br /><br />App only로 15분당 75개의 요청      | /2/lists/:id<br /><br />OAuth 1.0a 사용자 컨텍스트로 15분당 75개의 요청<br /><br />OAuth 2.0 Authorization Code with PKCE로 15분당 75개의 요청                                                |
| /1.1/lists/ownerships.json<br /><br />OAuth 1.0a 사용자 컨텍스트로 15분당 15개의 요청<br /><br />App only로 15분당 15개의 요청 | /2/users/:id/owned\_lists<br /><br />OAuth 1.0a 사용자 컨텍스트로 15분당 15개의 요청<br /><br />OAuth 2.0 Authorization Code with PKCE로 15분당 15개의 요청<br /><br />App only로 15분당 15개의 요청 |

<div id="differences">
  #### 차이점
</div>

**엔드포인트 URL**

* 표준 v1.1 엔드포인트:
  * GET [https://api.x.com/1.1/lists/show.json](https://api.x.com/1.1/lists/show.json)
    (지정한 리스트 조회)
  * GET [https://api.x.com/1.1/lists/ownerships.json](https://api.x.com/1.1/lists/ownerships.json)
    (지정한 사용자가 소유한 리스트 조회)
* X API v2 엔드포인트:
  * GET [https://api.x.com/2/lists/:id](https://api.x.com/2/lists/:id)
    (지정한 리스트 조회)

  * GET [https://api.x.com/2/users/:id/owned\&#95;lists](https://api.x.com/2/users/:id/owned\&#95;lists)
    (지정한 사용자가 소유한 리스트 조회)

**App 및 Project 요구 사항**

X API v2 엔드포인트를 사용할 때는 요청을 인증할 때 [developer App](/ko/resources/fundamentals/developer-apps)과 연관된 [Project](/ko/resources/fundamentals/developer-apps)의 자격 증명을 사용해야 합니다. 모든 X API v1.1 엔드포인트는 개별 App 또는 Project와 연관된 App의 자격 증명을 사용할 수 있습니다.

**요청당 데이터 객체 수 제한**

표준 v1.1 /lists/ownerships 엔드포인트는 요청당 최대 1000개의 리스트를 반환할 수 있습니다. 새로운 v2 엔드포인트는 요청당 최대 100개의 리스트를 반환할 수 있습니다. 기본적으로 100개의 user 객체가 반환되며, 결과 개수를 변경하려면 1–100 사이의 숫자를 값으로 갖는 쿼리 파라미터 max\_results= 를 전달해야 합니다. 그런 다음 응답 페이로드에 포함되어 반환된 next\_token 값을 다음 요청에서 pagination\_token 쿼리 파라미터로 전달할 수 있습니다.

**응답 데이터 형식**

표준 v1.1과 X API v2 엔드포인트 버전 간의 가장 큰 차이점 중 하나는 페이로드에 어떤 필드를 반환할지 선택하는 방식입니다.

표준 엔드포인트의 경우, 많은 응답 필드를 기본적으로 받게 되며, 그 후 파라미터를 사용하여 어떤 추가 필드나 필드 집합을 페이로드에 반환할지 지정할 수 있습니다.

X API v2 버전은 기본적으로 리스트 id 및 name 필드만 제공합니다. 추가 필드나 객체를 요청하려면 [fields](/ko/x-api/fundamentals/fields) 및 [expansions](/ko/x-api/fundamentals/expansions) 파라미터를 사용해야 합니다. 이 엔드포인트에서 요청한 리스트 필드는 모두 기본 리스트 객체에 반환됩니다. 확장된 게시물 또는 user 객체와 그 필드는 응답 내 includes 객체에 반환됩니다. 그런 다음 user 및 확장된 게시물 객체에 있는 ID를 리스트 객체에 있는 ID와 매칭하여, 확장된 객체를 리스트 객체와 연결할 수 있습니다. 

아래는 가능한 리스트 필드와 expansions의 예시입니다:

* created\_at

* follower\_count

* member\_count

* owner\_id

* description

* private

|                           |               |
| :------------------------ | :------------ |
| **엔드포인트**                 | **expansion** |
| /2/lists/:id              | owner\_id     |
| /2/users/:id/owned\_lists | 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는 [Post](/ko/x-api/fundamentals/data-dictionary#tweet) 및 [user](/ko/x-api/fundamentals/data-dictionary#user) 객체를 포함하여 API가 반환하는 객체에 대해 새로운 JSON 설계를 도입하고 있습니다.

* JSON 루트 레벨에서 표준 엔드포인트는 게시물 객체를 statuses 배열로 반환하는 반면, X API v2는 data 배열로 반환합니다. 

* 리트윗 및 인용된 "statuses"를 참조하는 대신, X API v2 JSON은 리트윗 및 인용된 Tweet을 참조합니다. contributors 및 user.translator\_type 같은 많은 레거시 및 사용 중단 필드는 제거되고 있습니다. 

* Post 객체의 favorites 및 user 객체의 favourites를 모두 사용하는 대신, X API v2는 like라는 용어를 사용합니다. 

* X는 값이 없는 JSON 값(예: null)은 페이로드에 기록하지 않는 규칙을 채택하고 있습니다. 게시물 및 user 속성은 null이 아닌 값을 가진 경우에만 포함됩니다.

**요청 파라미터**

다음 표준 v1.1 요청 파라미터에는 X API v2에서의 대응 항목이 있습니다:

**ID로 리스트 조회**

|                     |                            |
| :------------------ | :------------------------- |
| **Standard v1.1**   | **X API v2**               |
| list\_id            | id                         |
| slug                | 해당 없음                      |
| owner\_screen\_name | 해당 없음                      |
| owner\_id           | expansions/fields 파라미터로 요청 |

**사용자 소유 리스트 조회**

|                   |                   |
| :---------------- | :---------------- |
| **Standard v1.1** | **X API v2**      |
| user\_id          | id                |
| screen\_name      | 해당 없음             |
| count             | max\_results      |
| cursor            | pagination\_token |