트위터 검색 API
GetXAPI의 트위터/X 검색 API는 고급 검색 연산자를 그대로 써서 X 검색을 쿼리하고, 구조화된 JSON을 트윗 1,000건당 $0.05에 반환합니다. 작성자, 키워드, 날짜 범위, 언어, 참여도 임계값으로 실시간 필터링. 개발자 계정도 엔드포인트별 쿼터도 없습니다.
최종 업데이트: 2026년 8월 16일. 수치는 같은 날X의 API 문서와 대조했습니다.
트위터 검색 API란?
트위터 검색 API는 X의 게시물 인덱스에 쿼리를 실행해 일치한 트윗을 JSON으로 반환하는 API입니다. X의 고급 검색과 같은 연산자(from:, since:, until:, lang:, min_faves: 등)를 받으므로, 작성자·날짜 범위·언어·참여도에 따른 필터링을 클라이언트 측이 아니라 요청 측에서 할 수 있습니다. 공식 버전의 사양은X의 검색 엔드포인트 레퍼런스에 실려 있습니다.
왜 트위터 검색 API를 쓰나요
수동 검색이라면 X 웹 앱으로 충분합니다. 하지만 프로덕트, 대시보드, 알림, AI 에이전트 안에 검색을 넣으려면 엔드포인트로서의 검색이 필요합니다. 공식 X API에도 검색이 있고 그것이 공인된 채널이지만, 비용과 전제 조건이 많은 팀에게는 너무 무겁습니다:
- 반환된 리소스 단위 과금. 공식 검색은 반환된 Post 1건마다 $0.005를 과금합니다. 100건 페이지 1회에 $0.50, 1,000건이면 $5입니다.
- 설정과 월 한도. 개발자 계정과 앱 설정을 마친 뒤, 엔드포인트별 시간 창, Recent search의 7일 소급, 종량제의 월 300만 건 Post 읽기 한도를 전제로 설계해야 합니다.
- 직접 만들면 깨집니다. X 내부를 읽는 무료 라이브러리는 계정이나 IP 제한을 받기 쉽고, X의 사양 변경으로 동작을 멈추기도 합니다. 월 청구서 대신 프록시 관리와 끝없는 수정 작업을 떠안게 됩니다.
GetXAPI는 그 중간의 관리형 경로입니다. Bearer 키 하나, 문서화된 검색 엔드포인트 하나, 돌아오는 것은 구조화된 JSON. 트윗 1,000건 $0.05에 월 최소 요금도 엔드포인트별 쿼터도 없습니다. 쿼리를 쓰면 일치하는 트윗이 반환되고, 밑단의 인프라를 유지보수할 필요가 없습니다.
검색 엔드포인트 사용법
검색은 엔드포인트 하나 GET /twitter/tweet/advanced_search 에 모여 있습니다. q파라미터에 쿼리를 넘기고, product로 정렬을 고르고, cursor로 결과를 넘깁니다. 호출당 $0.001에 트윗 약 20건이 반환됩니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
| q | 필수 | 검색 쿼리. X의 고급 검색과 같은 연산자를 받습니다. 예: from:elonmusk min_faves:500 since:2026-01-01 |
| product | 선택 | Latest는 최신순 실시간 피드, Top은 참여도가 높은 순. 생략하면 Latest. |
| cursor | 선택 | 각 응답에 포함되는 페이지네이션 토큰. 다음 요청에 넘기면 이어지는 페이지를 받을 수 있고, 커서가 비어 올 때까지 반복할 수 있습니다. |
요청 한 번으로 트윗 검색
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.getxapi.com/twitter/tweet/advanced_search?q=from:elonmusk&product=Latest"응답은 다음 페이지용 커서가 포함된 구조화된 JSON입니다. HTML 파싱도 프록시 로테이션도 필요 없습니다.advanced_search 엔드포인트 문서(영어)도 참고하세요.
q에 넘길 수 있는 검색 연산자
| 연산자 | 일치 대상 | 예 |
|---|---|---|
| from:username | 특정 계정의 게시물 | from:elonmusk |
| to:username | 특정 계정에 보낸 답글 | to:nasa |
| filter:verified | 인증된 계정의 게시물만 | ai agents filter:verified |
| min_faves:N | 좋아요가 N개 이상인 게시물 | solana min_faves:1000 |
| min_retweets:N | 리포스트가 N개 이상인 게시물 | launch min_retweets:50 |
| since: / until: | 날짜 범위(YYYY-MM-DD) | nvda since:2026-01-01 until:2026-03-01 |
| lang:xx | 특정 언어의 게시물 | 실적 lang:ko |
| geocode:lat,long,r | 지정 지점과 반경 근처의 게시물 | protest geocode:40.7,-74,10km |
연산자는 하나의 쿼리에서 조합할 수 있습니다. 예: from:elonmusk min_faves:500 since:2026-01-01. 연산자 전체 목록과 조합 레시피는고급 검색 연산자 가이드(영어)에 정리해 두었습니다.
Latest vs Top: product 파라미터
| product | 반환 결과 | 적합한 용도 | 신선도 |
|---|---|---|---|
| Latest | 최신순(새 게시물이 먼저) | 실시간 모니터링, 알림, 검색 데이터 수집 | 실시간. 몇 초 전 게시물까지 |
| Top | 참여도순(높은 순) | 감성 집계, 하이라이트, 다이제스트 | 최근분. 좋아요와 리포스트로 가중치 |
파라미터를 생략하면 Latest가 됩니다. 쿼리에 대해 최신 게시물이 아니라 가장 참여도가 높은 게시물이 필요할 때 Top으로 바꾸세요.
GetXAPI 검색 vs 공식 X API와 다른 선택지
| 선택지 | 가격 | 인증 | 레이트 리밋 | 실시간성 |
|---|---|---|---|---|
| GetXAPI | 트윗 1,000건 $0.05 | Bearer 토큰, 가입 30초 | 엔드포인트별 쿼터 없음(전체 스로틀링은 적용) | Latest와 Top, 몇 초 전까지 |
| 공식 X API 검색 | 표준 Post 읽기 1,000건 $5 | X 개발자 계정과 앱 설정 | 종량제는 월 300만 건 Post 읽기 한도 | Recent search는 7일 소급 |
| RapidAPI 검색 계열 래퍼 | 프로바이더에 따라 다름 | 프로바이더별 RapidAPI 키 | 플랜 쿼터, 스로틀링 있음 | 프로바이더에 따라 다름 |
| 무료 라이브러리(twscrape, twikit) | $0 + 프록시와 컴퓨팅 자원 | 세션 쿠키 또는 토큰 | 계정·IP 제한 위험(단속 강도는 변동) | X의 사양 변경에 취약 |
요금은 단순한 정액 단가
$0.05
트윗 1,000건 검색당
$0.10
가입 시 무료 크레딧, 카드 불필요
$0
필수 구독 없음, 선택형 플랜 있음
검색 호출은 1회 $0.001에 트윗 약 20건을 반환하므로 트윗 1,000건에 약 $0.05가 됩니다. 전체 내역은X API·트위터 API 가격 비교를 참고하세요.
검색 이상의 데이터가 필요하다면
검색은 엔드포인트 하나에 불과합니다. 타임라인 전체, 팔로워, 프로필도 필요하다면 같은 키로 더 넓은 범위를 다루는트위터 스크레이퍼(영어)를 참고하세요. AI 에이전트에 검색을 넣으려면MCP 서버(영어)를 쓸 수 있습니다. API 키 발급은GetXAPI API 키페이지에서 설명합니다.
트위터 검색 API 자주 묻는 질문
GetXAPI의 advanced_search 엔드포인트는 호출당 $0.001이고, 호출 1회에 트윗 약 20건을 반환합니다. 즉 트윗 1,000건 검색이 약 $0.05입니다. 구독은 필수가 아니고 최소 사용액도 없습니다. 공식 X API는 선불 종량제로, 검색 결과는 반환된 리소스 단위로 과금되며 표준 Post 읽기는 1건당 $0.005, 1,000건이면 $5입니다. 가입 시 $0.10의 무료 크레딧이 제공되고 카드는 필요 없습니다.
X 개발자 계정이나 공식 OAuth 플로우는 필요 없습니다. 필요한 것은 GetXAPI 키뿐이며, 30초 가입 후 복사할 수 있는 단일 Bearer 토큰입니다. 그 키가 모든 검색 요청을 인증합니다. 가입 후 1분 안에 첫 쿼리를 실행할 수 있습니다.
검색 엔드포인트에 엔드포인트 고유의 일일·15분 쿼터는 없지만, 매우 높은 동시성에서는 전체 스로틀링이 적용됩니다. 요금은 호출당 $0.001의 종량제이므로 비용은 플랜 상한이 아니라 사용량에 비례합니다. 정기적인 검색 실행이나 날짜 범위 백필을 엔드포인트별 시간 창을 신경 쓰지 않고 설계할 수 있습니다.
각 응답에 커서 토큰이 포함됩니다. 다음 요청의 cursor 파라미터에 그 토큰을 넘기면 이어지는 페이지를 받을 수 있고, 커서가 비어 반환될 때까지 반복합니다. 서버 측에 상태를 두지 않고 쿼리나 날짜 범위의 전체 결과를 순서대로 가져올 수 있습니다.
네. product에 Latest를 지정하면 몇 초 전 게시물까지 포함한 최신순 피드가 반환됩니다. 라이브 모니터링이나 알림에 적합한 동작입니다. Top을 지정하면 쿼리에 맞는 게시물 중 참여도가 높은 것이 반환됩니다. 둘 다 캐시가 아니라 X의 라이브 인덱스에 대해 실행됩니다.
쓸 수 있습니다. q 파라미터는 X의 고급 검색과 같은 연산자를 받습니다: from:, to:, filter:verified, min_faves:, min_retweets:, since:, until:, lang:, geocode:. 하나의 쿼리에서 조합도 가능합니다. 예: from:elonmusk min_faves:500 since:2026-01-01.
product 파라미터가 정렬을 제어합니다. Latest는 일치한 트윗을 최신순으로 반환하며 실시간 모니터링에 적합합니다. Top은 같은 일치 결과를 참여도순으로 반환하며 감성 다이제스트나 하이라이트 피드에 적합합니다. 파라미터를 생략하면 Latest가 됩니다.
검색 API는 쿼리 전용 엔드포인트로, 연산자를 넘기면 일치하는 트윗이 반환됩니다. 범용 스크레이퍼는 검색에 더해 타임라인 전체, 팔로워, 프로필, 미디어까지 가져옵니다. 둘 다 같은 Bearer 키와 같은 호출당 $0.001로 동작합니다. 쿼리 검색만 필요하면 이 엔드포인트가 목적에 맞는 경로이고, 계정의 전체 데이터가 필요하면 다른 엔드포인트도 함께 씁니다.