메인 콘텐츠로 건너뛰기
특정 주제나 이벤트에 대한 X 상의 대화를 파악하기 위해 게시물 검색은 중요한 기능입니다. X에도 이 기능이 있지만, 이러한 엔드포인트는 게시물을 필터링하고 수집하는 데 더 큰 유연성과 성능을 제공하여 연구에 필요한 데이터를 더 쉽고 정확하게 찾고, 거의 실시간의 ‘리스닝’ 애플리케이션을 구축하며, 관심 주제와 관련된 게시물을 전반적으로 탐색·분석·활용할 수 있도록 합니다.  게시물을 검색할 수 있는 두 가지 엔드포인트를 제공합니다: 최근 검색과 전체 아카이브 검색. 이 두 REST 엔드포인트는 공통된 설계와 기능을 공유하며, 특정 주제를 중심으로 게시물을 필터링하기 위해 단일 검색 쿼리를 사용하는 점도 포함됩니다. 이러한 검색 쿼리는 메시지 키워드, 해시태그, URL 등 게시물 및 사용자 속성과 일치하는 연산자 집합으로 작성됩니다. 연산자는 불리언 로직과 괄호를 사용해 쿼리로 결합할 수 있으며, 이를 통해 쿼리의 매칭 동작을 정교하게 다듬을 수 있습니다.  최근 검색과 전체 아카이브 검색 엔드포인트 모두는 게시물 편집 메타데이터를 제공합니다. 2022년 9월 29일 이후 생성된 모든 게시물 객체에는 해당 게시물이 한 번도 편집되지 않았더라도 게시물 편집 메타데이터가 포함됩니다. 게시물이 편집될 때마다 새로운 게시물 ID가 생성됩니다. 게시물의 편집 기록은 원래 ID부터 시작하는 게시물 ID 배열로 기록됩니다. 이러한 엔드포인트는 항상 최신 편집본과 편집 이력을 함께 반환합니다. 게시물의 30분 편집 가능 시간 이후에 수집된 게시물은 최종 버전을 나타냅니다. 게시물 편집 메타데이터에 대해 더 알아보려면 Edit Posts 기본 사항 페이지를 확인하세요. 쿼리를 설정하고 게시물을 수신하기 시작하면, 이러한 엔드포인트는 시간 또는 게시물 ID 범위로 결과를 탐색하는 기능을 지원합니다. 이는 다음의 두 가지 일반적인 사용 사례를 지원하도록 설계되었습니다: 
  • 과거 데이터 가져오기: 실시간성에 초점을 두지 않고 관심 있는 기간을 대상으로 요청합니다. 단일 요청을 수행하며, 필요한 경우 페이지네이션을 통해 일치하는 모든 데이터가 제공됩니다. 이는 Search Posts의 기본 모드입니다.
  • 폴링 또는 리스닝: “마지막 요청 이후 새 게시물이 있나요?”라는 모드로 지속적으로 요청합니다. 일반적으로 관심 있는 게시물을 거의 실시간으로 ‘리스닝’하는 사용 사례에 초점이 맞춰집니다.
많은 연산자와 쿼리 한도는 Enterprise access에 한정되어 있습니다. 즉, 추가 기능을 사용하려면 Enterprise access가 있는 Project 내 [Developer 앱]의 키와 토큰을 사용해야 합니다. 자세한 내용은 아래 엔드포인트 섹션에서 확인할 수 있습니다. 최근 검색과 전체 아카이브 검색 엔드포인트가 반환한 게시물은 월별 Post cap에 포함됩니다. 계정 설정 이러한 엔드포인트에 액세스하려면 다음이 필요합니다: [X API v2] 엔드포인트 액세스 방법은 우리의 시작하기 가이드에서 자세히 알아보세요. 최신 검색 엔드포인트를 사용하면 지난 일주일간 공개된 게시물에 필터를 적용해 프로그래밍적으로 액세스할 수 있으며, Project 내 App의 키와 토큰을 사용하는 모든 개발자 계정 보유 개발자가 이용할 수 있습니다. 요청은 OAuth 1.0a 사용자 컨텍스트, OAuth 2.0 App-Only, 또는 OAuth 2.0 Authorization Code with PKCE로 인증할 수 있습니다. 다만 비공개 지표나 게시물 결과에서 자연 발생(organic) 및 프로모션 지표의 세부 분해값을 받으려면 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE를 사용하고, 해당 콘텐츠를 게시한 사용자와 연결된 사용자 액세스 토큰을 전달해야 합니다. 이 엔드포인트는 요청당 최대 100개의 게시물을 최신순(역순 시간순)으로 제공하며, 대량의 일치 결과를 페이지로 이동할 수 있도록 pagination 토큰을 제공합니다. 일반 액세스가 있는 Project를 사용하는 경우 기본 operators 세트를 사용할 수 있으며, 최대 512자까지 쿼리를 작성할 수 있습니다. Enterprise 액세스가 있는 Project를 사용하는 경우 추가 operator를 사용할 수 있습니다. Enterprise 액세스가 있는 Project는 최대 4096자까지 쿼리를 작성할 수 있습니다. access levels에 대해 자세히 알아보세요. v2 전체 보관함 검색 엔드포인트는 Pro 액세스와 Enterprise 액세스가 있는 프로젝트에만 제공됩니다. 이 엔드포인트를 사용하면 검색 쿼리에 따라 2006년 3월 최초 게시물까지 거슬러 올라가는 전체 보관함의 공개 게시물에 프로그래밍 방식으로 접근할 수 있습니다. 이 엔드포인트에 대한 요청은 OAuth 2.0 App-Only로 인증할 수 있으며, App Access Token은 Pro 또는 Enterprise 액세스가 있는 프로젝트 내 앱에서 발급된 것이어야 합니다. 이 엔드포인트에서는 다른 사용자를 대신해 요청할 수 없기 때문에(OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE) 비공개 지표를 가져올 수 없습니다. 이 엔드포인트는 요청당 최대 500개의 게시물을 최신순(내림차순)으로 반환하며, 일치하는 게시물이 많은 경우 페이징을 위한 페이지네이션 토큰을 제공합니다. 주의: tweet.fields 매개변수를 통해 annotations를 요청하는 경우, max_results 매개변수의 현재 최대값은 100으로 제한됩니다. 향후 변경될 수 있으니 이 제한을 유의하세요. 이 엔드포인트는 Pro 및 Enterprise 액세스 승인을 받은 사용자에게만 제공되므로, 전체 검색 연산자 세트를 사용할 수 있으며 최대 1024자 길이의 쿼리를 작성할 수 있습니다.







지원 자료 Postman으로 요청 보내는 방법 알아보기 오류 문제 해결 API 참조 페이지 방문