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

# X API 소개

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

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>