메인 콘텐츠로 건너뛰기
X API를 사용하면 X의 공개 대화에 프로그램 방식으로 액세스할 수 있습니다. 포스트를 조회하고, 트렌드를 분석하고, 통합을 구축하고, 플랫폼에서 새로운 경험을 만들어 보세요.

​
가능한 작업

기능설명
포스트 읽기포스트를 검색·조회하고 실시간으로 스트리밍할 수 있습니다
콘텐츠 게시게시물, 답글, 스레드를 작성할 수 있습니다
사용자 관리사용자를 조회하고 팔로우, 차단, 뮤트 상태를 관리할 수 있습니다
데이터 분석지표, 트렌드, 참여 분석 데이터에 접근할 수 있습니다
통합 기능 구축DM을 보내고 리스트를 관리하며 Spaces와 상호작용할 수 있습니다

​
API 버전

최신 기능과 유연한 과금 체계를 제공하는 현재 X API 버전입니다.v2를 사용해야 하는 이유:
  • 사용량 기반 과금 — 월별 한도 없음
  • 현대적인 JSON 응답 형식
  • 유연한 필드 및 expansions
  • 고급 기능: 주석(annotations), 대화 추적(conversation tracking), 수정 이력(edit history)
  • 모든 신규 엔드포인트와 기능 제공
시작하기:
  1. console.x.com에 가입합니다.
  2. App을 생성하고 자격 증명을 발급받습니다.
  3. 첫 요청 보내기

​
사용 가능한 리소스

X API는 다음과 같은 리소스 유형에 액세스할 수 있도록 제공합니다:

포스트

포스트를 검색, 조회, 생성 및 삭제할 수 있습니다. 타임라인, 스레드, 인용 포스트에도 액세스할 수 있습니다.

사용자

프로필을 조회하고 관계를 관리하며 팔로워 데이터에 액세스할 수 있습니다.

Spaces

실시간 오디오 대화와 참가자를 발견할 수 있습니다.

다이렉트 메시지

사용자 간 비공개 메시지를 주고받을 수 있습니다.

리스트

계정을 모아 큐레이션 리스트를 생성하고 관리할 수 있습니다.

트렌드

위치별 인기 주제에 액세스할 수 있습니다.

​
v2 주요 사항

필요한 데이터만 요청하세요. fields 파라미터로 특정 속성을 선택하고, expansions로 관련 객체를 포함할 수 있습니다.
curl "https://api.x.com/2/tweets/123?tweet.fields=created_at,public_metrics&expansions=author_id&user.fields=username" \
  -H "Authorization: Bearer $TOKEN"
필드에 대해 더 알아보기 →
게시물에는 사람, 장소, 상품, 주제 등을 식별하는 의미 기반 주석이 포함됩니다. 스트림과 검색 결과를 주제별로 필터링할 수 있습니다.주석에 대해 더 알아보기 →
공개 지표(좋아요, 리포스트, 답글)와 본인 게시물에 대한 비공개 지표(노출 수, 클릭 수)에 액세스할 수 있습니다.지표에 대해 더 알아보기 →
conversation_id를 사용해 전체 대화 스레드를 재구성하세요. 전체 스레드에 걸친 답글을 추적할 수 있습니다.대화 추적에 대해 더 알아보기 →
이전 모든 버전과 수정 메타데이터를 포함해 게시물의 수정 이력에 액세스할 수 있습니다.게시물 수정에 대해 더 알아보기 →

​
가격

X API v2는 사용량 기반(pay-per-usage) 과금 모델을 사용합니다:
혜택설명
구독 없음사용한 만큼만 결제
상한선 없음필요한 만큼 자유롭게 사용
크레딧 기반크레딧을 구매한 뒤 요청당 차감
실시간 추적개발자 콘솔에서 사용량 모니터링
중복 제거동일한 리소스를 24시간 내 두 번 요청해도 한 번만 과금
요금 세부 정보 보기 →

​
다음 단계

액세스 권한 받기

가입하고 첫 번째 App을 생성하세요.

첫 요청 보내기

몇 분 안에 API를 호출해 보세요.