> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User lookup 엔드포인트 마이그레이션 개요

> 원활한 마이그레이션을 위해 Standard v1.1의 users/show, users/lookup, account/verify_credentials를 X API v2 user lookup 엔드포인트에 매핑합니다.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <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>;
};

## X API의 users lookup 엔드포인트 비교

v2 user lookup 엔드포인트는 standard v1.1의 [GET users/lookup](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-users-lookup.html) 및 [GET users/show](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-users-show.html) 엔드포인트를 대체합니다. 이러한 user lookup 엔드포인트 버전 중 하나를 사용하는 코드, 앱 또는 도구를 가지고 있고, 새로운 X API v2 엔드포인트로 마이그레이션을 고려하고 있다면 이 가이드 세트가 도움이 될 것입니다.

다음 표는 다양한 유형의 users lookup 엔드포인트를 비교합니다:

|                                                                                                                             |                                                                                                 |                                                                                                                                                                                                                                                       |
| :-------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Description**                                                                                                             | **Standard v1.1**                                                                               | **X API v2**                                                                                                                                                                                                                                          |
| 지원되는 HTTP 메서드                                                                                                               | `GET`                                                                                           | `GET`                                                                                                                                                                                                                                                 |
| Host 도메인                                                                                                                    | `https://api.x.com`                                                                             | `https://api.x.com`                                                                                                                                                                                                                                   |
| 엔드포인트 경로                                                                                                                    | `/1.1/users/show.json` `/1.1/users/lookup.json`                                                 | `/2/users`<br /><br />`/2/users/:id`<br /><br />`/2/users/by`<br /><br />`/2/users/by/:username`                                                                                                                                                      |
| [인증](/resources/fundamentals/authentication)                                                                                | OAuth 1.0a User Context                                                                         | OAuth 1.0a User Context<br /><br />App only<br /><br />OAuth 2.0 Authorization Code with PKCE                                                                                                                                                         |
| 기본 요청 [rate limit](/resources/fundamentals/rate-limits)                                                                     | 15분당 900회 요청 (사용자당)<br /><br />/show - 15분당 900회 요청 (app당)  <br />/lookup - 15분당 300회 요청 (app당) | 15분당 900회 요청 (사용자당)<br /><br />15분당 300회 요청 (app당)                                                                                                                                                                                                    |
| 응답당 최대 사용자 수                                                                                                                | /show -  1<br /><br />/lookup - 100                                                             | 100                                                                                                                                                                                                                                                   |
| JSON 응답 객체 형식                                                                                                               | Standard v1.1 형식                                                                                | [X API v2 형식](/x-api/fundamentals/data-dictionary) (fields 및 expansions 요청 매개변수에 의해 결정되며, v1.1 형식과 하위 호환되지 않음)<br /><br />Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법에 대한 자세한 내용은 [데이터 형식 마이그레이션 가이드](/x-api/migrate/data-format-migration)를 참조하십시오. |
| 페이로드에 반환될 [fields](/x-api/fundamentals/data-dictionary) 선택 지원                                                               |                                                                                                 | ✔                                                                                                                                                                                                                                                     |
| (고정된 Post의) [annotations](/x-api/fundamentals/post-annotations) 필드 지원                                                       |                                                                                                 | ✔                                                                                                                                                                                                                                                     |
| (고정된 Post의) 새로운 [metrics](/x-api/fundamentals/metrics) 필드 요청 지원                                                             |                                                                                                 | ✔                                                                                                                                                                                                                                                     |
| (고정된 Post의) [conversation\_id](/x-api/fundamentals/conversation-id) 필드 지원                                                   |                                                                                                 | ✔                                                                                                                                                                                                                                                     |
| [project](/resources/fundamentals/developer-apps)와 연결된 [developer App](/resources/fundamentals/developer-apps)의 자격 증명 사용 필요 |                                                                                                 | ✔                                                                                                                                                                                                                                                     |

**기타 마이그레이션 리소스**

[User lookup: Standard v1.1에서 X API v2로](/x-api/users/lookup/migrate/standard-to-twitter-api-v2)

[X API 마이그레이션 허브](/x-api/migrate/overview)

[이 엔드포인트에 대한 예제 코드 확인](https://github.com/xdevplatform/Twitter-API-v2-sample-code "이 엔드포인트에 대한 예제 코드 확인")