메인 콘텐츠로 건너뛰기
Search Posts 엔드포인트를 사용하면 강력한 쿼리 연산자를 통해 특정 조건과 일치하는 포스트를 찾을 수 있습니다. 키워드, 해시태그, 멘션, URL 등 다양한 항목을 검색할 수 있습니다.

​
개요

X는 서로 다른 시간 범위와 접근 요건을 가진 두 가지 검색 엔드포인트를 제공합니다.

최근 검색

최근 7일 이내의 포스트를 검색합니다. 모든 개발자가 이용할 수 있습니다.

전체 아카이브 검색

2006년까지의 전체 아카이브를 검색합니다. 사용량 기반 과금 플랜 및 Enterprise 고객이 이용할 수 있습니다.

​
사용 사례

  • 브랜드 모니터링 — 브랜드나 제품에 대한 언급을 추적
  • 트렌드 분석 — 특정 주제나 이벤트를 둘러싼 대화를 분석
  • 연구 — 학술 및 시장 연구용 데이터 수집
  • 실시간 모니터링 — 새 포스트에 반응하는 애플리케이션 구축

​
엔드포인트

MethodEndpointDescriptionAccess
GET/2/tweets/search/recent지난 7일간의 포스트 검색모든 개발자
GET/2/tweets/search/all전체 포스트 아카이브 검색종량제, 엔터프라이즈

​
쿼리 연산자

게시물 속성과 일치하는 연산자를 사용해 쿼리를 구성합니다: 
(AI OR "artificial intelligence") lang:en -is:retweet has:links
OperatorExampleDescription
Keywordpython해당 단어가 포함된 포스트
Phrase"machine learning"정확히 일치하는 문구가 있는 포스트
Hashtag#AI해당 해시태그가 포함된 포스트
Mention@XDevelopers해당 사용자를 멘션한 포스트
OperatorExampleDescription
from:from:elonmusk특정 사용자가 작성한 포스트
to:to:XDevelopers특정 사용자에게 보낸 답글
retweets_of:retweets_of:X특정 사용자의 포스트 리트윗
OperatorExampleDescription
has:imagescat has:images이미지가 포함된 포스트
has:videoshas:videos동영상이 포함된 포스트
has:linkshas:links링크가 포함된 포스트
has:mentionshas:mentions멘션이 포함된 포스트
url:url:github.com특정 URL이 있는 포스트
OperatorExampleDescription
lang:lang:en특정 언어로 작성된 포스트
-is:retweet-is:retweet리트윗 제외
-is:reply-is:reply답글 제외
is:verifiedis:verified인증된 사용자가 작성한 포스트

전체 연산자 참조

사용 가능한 모든 연산자와 각 연산자의 접근 요구사항을 확인하세요
지난 7일 동안의 포스트를 검색할 수 있습니다. 모든 개발자가 이용할 수 있습니다.

​
기능

  • 요청당 최대 100개의 게시물
  • 대용량 결과 집합을 위한 페이지네이션
  • 모든 핵심 쿼리 연산자 지원
  • 512자 쿼리 길이 (Enterprise에서는 4,096자)

빠른 시작

첫 최근 검색 요청 수행하기

API 참조 문서

전체 엔드포인트 문서
2006년 3월까지의 전체 게시물 아카이브를 검색하세요.
전체 아카이브 검색 기능은 종량제 및 Enterprise 고객이 이용할 수 있습니다.

​
기능

  • 요청당 최대 500 포스트
  • 전체 게시물 기록에 접근 가능
  • 모든 쿼리 연산자 사용 가능
  • 쿼리 길이 최대 1,024자(Enterprise의 경우 4,096자)

빠른 시작

첫 전체 아카이브 검색 요청을 보내 보세요

API 참조 문서

해당 엔드포인트의 전체 문서

​
시작하기

사전 준비 사항

쿼리 작성

쿼리 구문과 연산자 사용법을 알아보기

페이지네이션

대용량 결과를 순회하기

통합 가이드

핵심 개념 및 모범 사례

샘플 코드

실행 가능한 코드 예제