X API

X의 게시물, 사용자, 스페이스 등에 프로그래밍 방식으로 액세스

X API를 사용하면 X의 공개 대화에 프로그래밍 방식으로 액세스할 수 있습니다. 포스트를 읽고, 콘텐츠를 게시하고, 사용자를 관리하고, 트렌드를 분석할 수 있으며, 이 모든 작업을 유연한 사용량 기반 종량제 과금이 적용되는 최신 REST 엔드포인트를 통해 수행할 수 있습니다.

시작하기

App을 생성하고 몇 분 안에 첫 요청을 보내세요.

API 참조 문서

사용 가능한 모든 엔드포인트를 살펴보세요.

SDK 모음

공식 Python 및 TypeScript 라이브러리입니다.

---

​

무엇을 구현할 수 있나요

포스트

포스트를 검색, 조회 및 게시할 수 있습니다. 타임라인, 스레드 및 인용 포스트에 액세스할 수 있습니다.

사용자

사용자를 조회하고 팔로우, 차단 및 뮤트를 관리할 수 있습니다.

스페이스

라이브 오디오 대화와 해당 참여자를 찾을 수 있습니다.

다이렉트 메시지

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

리스트

선별한 계정으로 리스트를 생성하고 관리할 수 있습니다.

트렌드

위치별 트렌딩 토픽에 액세스할 수 있습니다.

---

​

요금제

X API는 사용량 기반 종량제(pay-per-usage) 요금을 사용합니다. 구독도, 월 한도도 없습니다. 사용한 만큼만 비용을 지불하세요.

유연한 확장

작게 시작해서 점진적으로 확장하세요. 실제 사용량에 비례해 비용이 증가합니다.

무약정

계약이나 최소 지출 금액이 없습니다. 언제든지 중단할 수 있습니다.

실시간 추적

개발자 콘솔에서 사용량과 비용을 실시간으로 모니터링하세요.

크레딧 기반

크레딧을 미리 구매해 두고, API를 사용할 때마다 차감됩니다.

요금 상세 정보

크레딧 구매

---

​

주요 기능

데이터 액세스

​

풍부한 데이터 객체

게시물, 사용자, 미디어 등과 관련된 상세하고 구조화된 데이터에 액세스할 수 있습니다.

• 포스트: 전체 텍스트, 메트릭, 엔티티, 주석, 대화 스레드
• 사용자: 프로필, 팔로워 수, 인증 상태
• 미디어: 메타데이터가 포함된 이미지, 비디오, GIF
• 투표: 선택지와 득표 수

fields와 expansions를 사용해 응답을 맞춤 구성하여 필요한 데이터만 정확히 받아볼 수 있습니다.

실시간 스트리밍

​

필터링된 스트림

게시물이 게시되는 즉시 실시간으로 전달받을 수 있습니다. 최대 1,000개의 필터링 규칙을 정의하여 일치하는 게시물만 수신하세요.

# 규칙 추가
curl -X POST "https://api.x.com/2/tweets/search/stream/rules" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"add": [{"value": "from:xdevelopers"}]}'

# 스트림에 연결
curl "https://api.x.com/2/tweets/search/stream" \
  -H "Authorization: Bearer $TOKEN"

필터링된 스트림 자세히 알아보기 →

검색 및 분석

​

전체 아카이브 검색

2006년까지 거슬러 올라가는 전체 공개 게시물 기록을 검색할 수 있습니다. 사용자, 키워드, 날짜 등 다양한 연산자를 사용해 쿼리를 구성하세요.

curl "https://api.x.com/2/tweets/search/all?query=AI%20lang:en" \
  -H "Authorization: Bearer $TOKEN"

​

메트릭

노출수, 좋아요, 리포스트, 답글, 동영상 조회수 등 참여 메트릭을 확인할 수 있습니다.

검색 자세히 알아보기 →

---

​

API 버전

버전	상태	설명
v2	현재	최신 엔드포인트, 유연한 요금제, 모든 신규 기능 지원
Enterprise	사용 가능	전담 지원이 포함된 대규모 사용량용 액세스

새 프로젝트에는 항상 X API v2를 사용하세요. 모든 신규 기능과 개선 사항은 여기에서 제공됩니다.

---

​

빠른 시작

1. 개발자 계정 만들기

   console.x.com에 가입하고 App을 생성하세요.

2. 자격 증명 발급받기

   App 전용 요청을 위해 Bearer 토큰을 생성하세요.

3. 요청 보내기

   사용자를 조회해 보세요:

   curl "https://api.x.com/2/users/by/username/xdevelopers" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

전체 빠른 시작 가이드

---

​

도구 및 라이브러리

Python SDK

비동기 처리를 지원하는 공식 Python 라이브러리입니다.

TypeScript SDK

공식 TypeScript/JavaScript 라이브러리입니다.

Postman

대화형 API 탐색기입니다.

모든 라이브러리 살펴보기 →

---

​

지원

Developer Forum

커뮤니티와 X 팀으로부터 도움을 받으세요.

Support Hub

FAQ 및 문제 해결 가이드를 확인하세요.