업데이트를 구독하려면 @API의 “알림 켜기”를 활성화하세요.Documentation Index
Fetch the complete documentation index at: https://x-preview-mintlify-aed10b63.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
검색 엔드포인트를 새 검색 인덱스로 마이그레이션
오늘 X API v2 검색 엔드포인트(/2/tweets/search/recent, /2/tweets/search/all, /2/tweets/counts/recent, /2/tweets/counts/all)를 새로운 X 코어 플랫폼 검색 인덱스로 마이그레이션했습니다. 이를 통해 성능이 크게 향상되고 503 오류가 대폭 감소하며 세 가지 새로운 정밀도 연산자(min\_likes:, min\_replies:, min\_reposts:)가 도입됩니다. 참고: 리포스트는 더 이상 키워드 기반 검색 결과에 반환되지 않습니다(Filtered Stream은 변경되지 않음). 자세한 내용은 여기를 참조하세요.X API 가격 업데이트: Owned Reads가 이제 $0.001
2026년 4월 20일부로 본인의 데이터에 접근하는 대상 엔드포인트(GET /2/users/{id}/bookmarks, /blocking, /muting, /pinned_lists, /tweets, /mentions, /liked_tweets, /followers, /following, /owned_lists, /followed_lists, /list_memberships)에 대해 새로운 “Owned Reads” 가격인 **리소스당 1)을 도입했습니다. 쓰기 작업도 업데이트되어 POST /2/tweets는 포스트당 0.20입니다(소환된 답글은 그대로 $0.01 유지). API를 통한 팔로우, 좋아요, 인용 포스트는 모든 셀프 서비스 등급에서 제거되었습니다. 자세한 내용은 여기를 참조하세요.X Activity API 구독을 위한 Direction 필터
오늘 X Activity API 구독에 선택적direction 필터를 추가했습니다. 구독자는 이제 DM 및 채팅 이벤트를 sent, received 또는 둘 다로 범위 지정할 수 있으므로 송신 또는 수신 이벤트만 필요한 경우 노이즈를 줄일 수 있습니다.X Activity API의 레거시 다이렉트 메시지 이벤트
오늘 레거시 DM 이벤트(dm.received, dm.sent, dm.read, dm.indicate_typing)를 X Activity API에 추가했습니다. 이를 통해 DM 이벤트 전달이 Account Activity API에서 지연 시간이 더 짧은 XAA 파이프라인으로 이전됩니다.X API 사용량 기반(Pay-Per-Use) 가격 정식 출시
오늘 X API Pay-Per-Use 가격 모델을 공식적으로 출시했습니다. 인디 개발자, 스타트업 및 취미 개발자를 위해 설계된 유연한 크레딧 기반 모델입니다. 주요 내용:- console.x.com의 새로운 Developer Console
- 퍼스트 파티 Python 및 TypeScript SDK가 포함된 XDK (X Developer Kit)
- 테스트를 위한 대화형 Playground
- AI 모델용 MCP 서버
- X API에 사용한 1달러당 최대 20%를 xAI/Grok API 크레딧으로 적립
X Activity API의 Spaces 이벤트
오늘 Spaces 라이프사이클 이벤트(spaces.start, spaces.end)를 X Activity API에 추가했습니다. 사용자 ID로 구독하면 Space가 시작되거나 종료될 때 실시간으로 알림을 받을 수 있습니다.Account Activity API v2에 OAuth 2.0 지원 추가
오늘 Account Activity API v2에 OAuth 2.0을 완전히 지원하도록 추가했습니다. 이제 개발자는 OAuth 1.0a의 전부 아니면 전무(all-or-nothing) 권한 모델 대신, 세분화된 스코프(예:follow.read)를 사용하여 OAuth 2.0으로 구독을 생성할 수 있습니다. 기존 OAuth 1.0a 기반 통합은 중단 없이 계속 작동합니다. OAuth 1.0a 권한이 있는 경우 OAuth 2.0 스코프를 완전히 재정의합니다. 자세한 내용은 여기를 참조하세요.X API Playground 출시
오늘 X API Playground를 소개했습니다. X API v2 엔드포인트를 에뮬레이트하는 셀프 호스팅 로컬 서버입니다. 실제 API 호출을 수행하거나 속도 제한에 도달하지 않고 통합을 개발하고 테스트하세요. 현실적인 모의 데이터, 상태 영속화, OpenAPI 검증, 속도 제한 시뮬레이션 및 웹 UI를 포함합니다.go install github.com/xdevplatform/playground/cmd/playground@latest로 설치하세요. 자세한 내용은 여기를 참조하세요.News 엔드포인트 출시
오늘 X API v2에 새로운 News 엔드포인트를 출시했습니다:GET /2/news/search— 검색 쿼리와 일치하는 트렌딩 뉴스 기사를 반환합니다GET /2/news/{id}— ID로 특정 뉴스 기사를 조회합니다
name, summary, contexts, cluster\_posts\_results, last\_updated\_at\_ms와 같은 필드를 선택할 수 있는 news.fields를 지원합니다. 자세한 내용은 여기를 참조하세요.Python 및 TypeScript XDK 출시
오늘 X API v2를 위한 공식 퍼스트 파티 Python 및 TypeScript XDK(X Developer Kit)를 출시했습니다. XDK는 인증(Bearer Token, OAuth 2.0 PKCE, OAuth 1.0a), 자동 페이지네이션, 재연결 처리가 포함된 실시간 스트리밍 및 모든 v2 엔드포인트에 대한 포괄적인 커버리지를 처리합니다.pip install xdk 또는 npm install @xdevplatform/xdk로 설치하세요. 자세한 내용은 여기를 참조하세요.X Activity API 구독을 위한 키워드 필터링
오늘 X Activity API 구독에 키워드 필터링을 추가했습니다. 사용자 ID 필터링 외에 이제 구독자는 키워드로 이벤트 전달을 더 세밀하게 좁힐 수 있습니다. News 이벤트와 같이 이벤트 볼륨이 높아 추가 필터링이 필요한 다른 이벤트 유형에 유용합니다.X Activity API의 인증 배지, 제휴 배지 및 핸들 업데이트 이벤트
오늘 X Activity API를 확장하여 추가 프로필 관련 이벤트 유형을 전달합니다:profile.update.verified— 사용자의 인증 상태가 변경될 때profile.update.affiliate— 사용자의 제휴 배지가 변경될 때profile.update.screenname— 사용자가 @핸들을 변경할 때
X Activity API 오픈 베타 출시
오늘 X Activity API의 오픈 베타를 출시했습니다. 이는 1초 미만의 지연 시간으로 X의 실시간 활동 이벤트를 구독할 수 있는 새로운 엔드포인트 모음입니다. 프로필 이벤트 유형(ProfileBioUpdate, ProfilePictureUpdate, ProfileBannerUpdate, ProfileGeoUpdate, ProfileUrlUpdate)을 구독하고 사용자 ID로 필터링하여 영구 HTTP 스트림(GET /2/activity/stream) 또는 웹훅을 통해 일치하는 이벤트를 받습니다. 구독은 POST /2/activity/subscriptions를 통해 관리됩니다. 자세한 내용은 여기를 참조하세요.X API를 통한 포스트 편집
오늘 X API를 통해 최근 포스트를 프로그래밍 방식으로 편집하는 기능을 출시했습니다. 기존POST /2/posts 엔드포인트를 previous_post_id가 포함된 새로운 edit_options 객체와 함께 사용하세요. 요구 사항: 인증된 사용자가 X Premium에 가입되어 있어야 하고, 포스트가 본인의 것이어야 하며, 최근 1시간 이내에 작성되어야 합니다. 업데이트된 Create or Edit Post 문서를 참조하세요. 자세한 내용은 여기를 참조하세요.활성 스트리밍 연결 관리를 위한 Connections API
오늘 활성 스트리밍 연결을 프로그래밍 방식으로 관리하기 위한 Connections API를 출시했습니다:GET /2/connections— 활성 및 과거 스트리밍 연결을 나열합니다DELETE /2/connections/all— 앱의 모든 활성 스트리밍 연결을 종료합니다DELETE /2/connections/{endpoint_id}— 특정 스트리밍 엔드포인트의 연결을 종료합니다DELETE /2/connections— UUID로 특정 연결을 종료합니다
Community Notes: Evaluate Note 엔드포인트
오늘 Community Notes API에POST /2/evaluate_note 엔드포인트를 추가했습니다. 이제 AI Note Writer는 제출 전에 작성된 노트를 평가하여 잠재적인 유용성, 주장/의견 정렬 및 기타 모델 피드백에 대한 신호를 받을 수 있습니다.Filtered Stream Webhooks API 출시
오늘 Filtered Stream Webhooks API를 출시했습니다. 영구 연결을 필요로 하는 대신 일치하는 공개 포스트를 등록된 웹훅에 비동기적으로 전달합니다. 규칙은 기존/2/tweets/search/stream/rules 엔드포인트를 사용해 관리되며, 일치하는 포스트(편집 이력 포함)는 JSON 형태로 웹훅에 전달됩니다. Enterprise 개발자에게 제공되며, 프로젝트당 25,000개 이상의 규칙과 규칙당 최대 2,048자를 지원합니다. 자세한 내용은 여기를 참조하세요.PowerStream Rules Lookup 엔드포인트
오늘GET /2/powerstream/rules 엔드포인트를 추가하여 PowerStream 고객이 PowerStream 인스턴스에 구성된 규칙을 프로그래밍 방식으로 조회할 수 있도록 했습니다.share_with_followers를 통한 Community 포스트 브로드캐스트
오늘 POST /2/tweets에 새로운 선택적 부울 매개변수 share_with_followers를 추가했습니다. community_id와 share_with_followers: true로 포스트를 작성하면 해당 Community 포스트가 인증된 사용자의 팔로워 타임라인에도 브로드캐스트됩니다. 이는 x.com의 “팔로워와도 공유” 체크박스에 해당합니다.Community Notes API 출시
오늘 Community Notes API를 출시했습니다. AI Note Writer가 Community Notes에 프로그래밍 방식으로 참여할 수 있도록 하는 새로운 엔드포인트 모음입니다:GET /2/notes/search/posts_eligible_for_notes— Community Note 작성 대상 포스트를 검색합니다GET /2/notes/search/notes_written— 인증된 AI Note Writer가 이전에 작성한 노트를 조회합니다POST /2/notes— Community Note를 제출합니다