문법을 외우지 않고도 정확한 검색 만들기
워크벤치는 명시적으로 선택한 값을 TweetAPI가 지원하는 고급 검색 문법으로 바꿉니다. 양식을 기준으로 삼기 때문에 원문이 숨은 연산자로 조용히 바뀌지 않습니다.
결정론적으로 조합
검증된 필드에서 단어, 구문, 계정, 일반 날짜, 미디어, 언어, 참여도, 결과 유형을 조합합니다.
실행 전 확인
정확히 컴파일된 쿼리, 연산자 설명, 검증 상태, 백엔드와 일치하는 512자 제한을 확인합니다.
하나의 실행 경로 유지
로그인한 사용자는 같은 쿼리를 기존 API 플레이그라운드의 GET /tw-v2/search로 넘깁니다. 익명 실시간 결과 미리보기는 제공하지 않습니다.
자율 검색 에이전트가 아닌 집중형 쿼리 워크벤치
수동 모드는 제한 없이 브라우저에서 실행됩니다. 선택적 AI 해석의 범위는 엄격히 제한됩니다. OpenAI가 검증된 양식 객체를 채운 다음 결정론적 코드가 최종 쿼리를 컴파일합니다. 검색 실행, 계정 작업, 프리셋 저장은 할 수 없습니다.
- API 키, X 쿠키, 비밀번호 또는 계정 연결을 요구하지 않음
- 익명 TweetAPI 검색 또는 실시간 결과 미리보기 없음
- 원문 설명이나 생성 쿼리를 PostHog 분석에 전송하지 않음
- 쿼리 기록, 저장된 프리셋, 자율 모니터링 또는 쓰기 작업 없음
쿼리에서 인증된 API 요청으로
복사는 공개 기능입니다. 실행 경로는 의도적으로 다릅니다. 가입 또는 로그인 중 쿼리는 같은 탭의 세션 저장소에만 보관된 뒤 기존 인증 플레이그라운드에 로드됩니다. 검색어를 전달 URL에 넣을 필요가 없습니다.
- 01구조화된 양식을 직접 작성하거나 해석하고 모든 검증 오류를 해결합니다.
- 02컴파일된 쿼리, 결과 유형, 설명, 문자 수를 확인합니다.
- 03공개 기능으로 복사하거나 가입/로그인하여 같은 브라우저 탭에 보관합니다.
- 04TweetAPI 플레이그라운드에서 본인 소유 API 키를 선택하고 요청을 명시적으로 실행합니다.
자주 묻는 질문
계정 없이 Twitter 고급 검색 빌더를 사용할 수 있나요?
예. 결정론적 수동 빌더, 검증, 쿼리 설명, 프리셋, 문자 수, 복사 기능은 익명으로 제한 없이 사용할 수 있습니다. TweetAPI 인증 플레이그라운드에서 쿼리를 실행할 때만 계정이 필요합니다.
이 페이지는 익명 방문자를 위해 Twitter를 검색하나요?
아니요. 익명 방문자는 TweetAPI 검색을 실행하거나 실시간 결과를 받지 않습니다. 선택적 AI 해석과 개인정보를 보호하는 집계 분석을 제외하면 페이지는 브라우저에서 쿼리만 만들고 검사합니다.
AI 모드는 무엇을 하나요?
AI 모드는 OpenAI를 사용해 자연어 설명을 동일한 검증된 구조화 양식으로 변환합니다. OpenAI는 최종 쿼리를 컴파일하거나 실행하지 않으며, 검증과 컴파일은 결정론적 코드가 수행합니다.
쿼리가 512자로 제한되는 이유는 무엇인가요?
현재 TweetAPI의 GET /tw-v2/search 검증은 최대 512자의 쿼리를 허용합니다. 문자 수 표시와 차단 검증은 이 백엔드 계약과 일치합니다.
고급 검색에서 날짜는 어떻게 작동하나요?
since:YYYY-MM-DD는 포함 경계이고 until:YYYY-MM-DD는 제외 경계입니다. 둘 다 일반적인 UTC 날짜 경계로 해석됩니다. Snowflake ID와 타임스탬프 변환은 별도의 TweetAPI 타임스탬프 변환기에서 이용할 수 있습니다.
연산자와 제한은 2026년 8월 15일 TweetAPI 검색 문서 및 백엔드 계약과 최종 대조했습니다. TweetAPI는 X Corp와 제휴하지 않습니다.