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

# X API 소개

> X API는 X의 공개 대화에 대한 프로그래밍 방식의 액세스를 제공합니다. 게시물 검색과 조회, 트렌드와 참여도 분석, 사용자 검색, 외부 서비스 통합 구축, v2 엔드포인트 활용, 새로운 플랫폼 경험 구축까지 다양한 용도로 활용할 수 있습니다.

X API는 X의 공개 대화에 대한 프로그래밍 방식의 액세스를 제공합니다. 게시물을 검색하고, 트렌드를 분석하며, 통합을 구축하고, 플랫폼에서 새로운 경험을 만들 수 있습니다.

***

## 할 수 있는 작업

| 기능         | 설명                           |
| :--------- | :--------------------------- |
| **게시물 읽기** | 게시물을 검색, 조회하고 실시간으로 스트리밍     |
| **콘텐츠 게시** | 게시물, 답글, 스레드 작성              |
| **사용자 관리** | 사용자 조회, 팔로우/차단/뮤트 관리         |
| **데이터 분석** | 지표, 트렌드, 참여도 분석에 액세스         |
| **통합 구축**  | DM 전송, 리스트 관리, Spaces와 상호 작용 |

***

## API 버전

<Tabs>
  <Tab title="X API v2 (Recommended)">
    최신 기능과 유연한 가격 정책을 제공하는 X API의 현재 버전입니다.

    **v2를 사용해야 하는 이유:**

    * 사용량 기반 가격 정책
    * 최신 JSON 응답 형식
    * 유연한 [fields](/x-api/fundamentals/fields) 및 [expansions](/x-api/fundamentals/expansions)
    * 고급 기능: 주석, 대화 추적, 편집 기록
    * 모든 신규 엔드포인트 및 기능

    **시작하기:**

    1. [console.x.com](https://console.x.com)에서 가입
    2. 앱을 만들고 자격 증명을 받기
    3. [첫 요청 보내기](/x-api/getting-started/make-your-first-request)
  </Tab>

  <Tab title="X API v1.1 (Legacy)">
    X API의 이전 버전입니다. 지원이 제한적이므로 신규 프로젝트에는 v2를 사용하세요.

    **계속 사용 가능:**

    * 일부 미디어 업로드 엔드포인트
    * 레거시 스트리밍 (지원 중단됨)
    * 일부 특수 엔드포인트

    **v2로 마이그레이션:**
    엔드포인트 매핑 및 데이터 형식 변경 사항은 [마이그레이션 가이드](/x-api/migrate/overview)를 참조하세요.
  </Tab>
</Tabs>

***

## 사용 가능한 리소스

X API는 다음 리소스 유형에 대한 액세스를 제공합니다:

<CardGroup cols={3}>
  <Card title="게시물" icon="message">
    게시물 검색, 조회, 작성, 삭제. 타임라인, 스레드, 인용 게시물에 액세스.
  </Card>

  <Card title="사용자" icon="user">
    프로필 조회, 관계 관리, 팔로워 데이터 액세스.
  </Card>

  <Card title="Spaces" icon="microphone">
    라이브 오디오 대화와 참여자를 검색.
  </Card>

  <Card title="다이렉트 메시지" icon="envelope">
    사용자 간 비공개 메시지 송수신.
  </Card>

  <Card title="리스트" icon="list">
    계정의 큐레이션된 리스트 생성 및 관리.
  </Card>

  <Card title="트렌드" icon="arrow-trend-up">
    위치별 트렌드 주제에 액세스.
  </Card>
</CardGroup>

***

## v2 주요 기능

<Accordion title="Fields 및 expansions">
  필요한 데이터만 요청하세요. `fields` 매개변수로 특정 속성을 선택하고 `expansions`로 관련 객체를 포함시킵니다.

  ```bash theme={null}
  curl "https://api.x.com/2/tweets/123?tweet.fields=created_at,public_metrics&expansions=author_id&user.fields=username" \
    -H "Authorization: Bearer $TOKEN"
  ```

  [fields에 대해 자세히 알아보기 →](/x-api/fundamentals/fields)
</Accordion>

<Accordion title="게시물 주석">
  게시물에는 사람, 장소, 제품, 주제를 식별하는 의미론적 주석이 포함됩니다. 주제별로 스트림과 검색을 필터링할 수 있습니다.

  [주석에 대해 자세히 알아보기 →](/x-api/fundamentals/post-annotations)
</Accordion>

<Accordion title="참여도 지표">
  공개 지표(좋아요, 리포스트, 답글)와 본인 게시물의 비공개 지표(노출수, 클릭수)에 액세스할 수 있습니다.

  [지표에 대해 자세히 알아보기 →](/x-api/fundamentals/metrics)
</Accordion>

<Accordion title="대화 추적">
  `conversation_id`를 사용해 전체 대화 스레드를 재구성합니다. 스레드 전체에서 답글을 추적할 수 있습니다.

  [대화 추적에 대해 자세히 알아보기 →](/x-api/fundamentals/conversation-id)
</Accordion>

<Accordion title="편집 기록">
  이전 버전 및 편집 메타데이터를 포함한 게시물의 편집 기록에 액세스합니다.

  [게시물 편집에 대해 자세히 알아보기 →](/x-api/fundamentals/edit-posts)
</Accordion>

***

## 가격

X API v2는 **사용량 기반** 가격 정책을 사용합니다:

| 혜택         | 설명                              |
| :--------- | :------------------------------ |
| **구독 없음**  | 사용한 만큼만 지불                      |
| **크레딧 기반** | 크레딧을 구매하고 요청 시 차감               |
| **실시간 추적** | Developer Console에서 사용량 모니터링    |
| **중복 제거**  | 24시간 내 동일 리소스를 두 번 요청해도 한 번만 과금 |

[가격 세부 정보 보기 →](/x-api/getting-started/pricing)

***

## 다음 단계

<CardGroup cols={2}>
  <Card title="액세스 받기" icon="key" href="/x-api/getting-started/getting-access">
    가입하고 첫 번째 앱을 만드세요.
  </Card>

  <Card title="첫 요청 보내기" icon="rocket" href="/x-api/getting-started/make-your-first-request">
    몇 분 안에 API를 호출하세요.
  </Card>
</CardGroup>