keyword | Standalone | Core | 게시물 본문에서 키워드를 매칭합니다. 이는 토큰화 기반 매칭으로, 키워드 문자열을 게시물 본문의 토큰화된 텍스트와 비교합니다. 토큰화는 구두점, 기호, 유니코드 기본 평면 구분 문자 기준으로 단어를 분리합니다. 예를 들어 텍스트가 “I like coca-cola”인 게시물은 다음 토큰으로 분리됩니다: I, like, coca, cola. 그런 다음 이 토큰들을 쿼리에서 사용한 키워드 문자열과 비교합니다. 구두점(예: coca-cola), 기호, 또는 구분 문자가 포함된 문자열을 매칭하려면 키워드를 큰따옴표로 감싸야 합니다. 예: pepsi OR cola OR "coca cola" |
emoji | Standalone | Core | 게시물 본문에서 이모지를 매칭합니다. 키워드와 마찬가지로 이모지도 토큰화 기반 매칭으로 처리되어, 이모지를 게시물 본문의 토큰화된 텍스트와 비교합니다. 이모지에 변형이 있는 경우 쿼리에 추가하려면 큰따옴표로 감싸야 합니다. 예: (😃 OR 😡) 😬 |
"exact phrase match" | Standalone | Core | 게시물 본문에서 정확한 구문을 매칭합니다. 예: ("X API" OR #v2) -"recent counts" |
# | Standalone | Core | 게시물에 인식된 해시태그가 포함된 경우 매칭합니다(해시태그가 게시물 내에서 인식된 엔터티인 경우). 이 연산자는 토큰화 기반이 아닌 정확히 일치하는 매칭을 수행합니다. 즉, 규칙 #thanku는 정확히 #thanku 해시태그가 있는 게시물과는 매칭되지만, #thankunext 해시태그가 있는 게시물과는 매칭되지 않습니다. 예: #thankunext #fanart OR @arianagrande |
@ | Standalone | Core | 사용자 이름이 인식된 엔터티인 경우(‘@’ 문자를 포함하여), 해당 사용자 이름을 멘션한 모든 게시물과 매칭합니다. 예: (@XDevelopers OR @API) -@X |
$ | Standalone | Advanced | 지정한 ‘캐시태그’(토큰의 첫 글자가 ‘’인경우)가포함된모든게시물과매칭합니다.캐시태그연산자는본문에서캐시태그를직접추출하려하지않고X의‘symbols’엔터티추출에의존합니다.예:‘twtr OR @XDevelopers -$fb` |
from: | Standalone | Core | 특정 사용자가 작성한 게시물과 매칭합니다. 값은 사용자 이름(‘@’ 제외) 또는 사용자의 숫자형 사용자 ID일 수 있습니다. from: 연산자마다 하나의 사용자 이름/ID만 전달할 수 있습니다. 예: from:XDevelopers OR from:API -from:X |
to: | Standalone | Core | 특정 사용자에게 보낸 답글인 게시물과 매칭합니다. 값은 사용자 이름(‘@’ 제외) 또는 사용자의 숫자형 사용자 ID일 수 있습니다. to: 연산자마다 하나의 사용자 이름/ID만 전달할 수 있습니다. 예: to:XDevelopers OR to:API -to:X |
url: | Standalone | Core | 게시물에 포함된 유효한 형식의 URL에 대해 토큰화 기반 매칭을 수행합니다. 이 연산자는 url 또는 expanded_url 필드의 콘텐츠 모두에서 매칭할 수 있습니다. 예를 들어 “You should check out X Developer Labs: https://t.co/c0A36SWil4”를 포함하는 게시물(짧은 URL이 https://developer.x.com 으로 리디렉션됨)은 다음 두 규칙 모두와 매칭됩니다: from:XDevelopers url:"https://developer.x.com" 및 from:XDevelopers url:"https://t.co". 구두점이나 특수 문자가 포함된 토큰과 구문은 큰따옴표로 감싸야 합니다. |
retweets_of: | Standalone | Core | 지정한 사용자의 리트윗과 매칭되는 게시물을 찾습니다. 값은 사용자 이름(‘@’ 제외) 또는 사용자의 숫자형 사용자 ID일 수 있습니다. retweets_of: 연산자마다 하나의 사용자 이름/ID만 전달할 수 있습니다. 예: retweets_of:XDevelopers OR retweets_of:API |
context: | Standalone | Core | 특정 도메인 id/엔터티 id 쌍과 매칭되는 게시물을 찾습니다. context: 연산자마다 하나의 도메인/엔터티만 전달할 수 있습니다. 예: context:domain_id.entity_id. OR 연산자를 사용해 여러 도메인/엔터티를 결합할 수 있습니다: (context:47.113922 9372198469633 OR context:11.1088514520308342784) |
entity: | Standalone | Core | 특정 엔터티 문자열 값과 매칭되는 게시물을 찾습니다. entity: 연산자는 하나만 전달할 수 있습니다. 예: entity:"string declaration of entity/place". 이는 최근 검색에서만 사용 가능합니다. |
conversation_id: | Standalone | Core | 동일한 대화 ID를 공유하는 게시물과 매칭합니다. 대화 ID는 대화를 시작한 게시물의 게시물 ID로 설정됩니다. 게시물에 대한 답글(답글의 답글 포함)이 게시되면 해당 JSON 페이로드에 conversation_id가 추가됩니다. conversation_id: 연산자마다 하나의 대화 ID만 전달할 수 있습니다. 예: conversation_id:1334987486343299072 (from:XDevelopers OR from:API) |
list: | Standalone | Advanced | 지정한 리스트의 구성원인 사용자가 게시한 게시물과 매칭합니다. 예를 들어 @XDevelopers와 @API가 리스트 123의 구성원이고 쿼리에 list:123을 포함했다면, 응답에는 해당 계정에서 게시된 게시물만 포함됩니다. 리스트 ID는 리스트 조회 엔드포인트로 확인할 수 있습니다. 예: list:123 |
place: | Standalone | Advanced | 지정한 위치 또는 X 장소 ID로 태그된 게시물과 매칭합니다. 여러 단어로 된 장소 이름(“New York City”, “Palo Alto”)은 큰따옴표로 감싸야 합니다. place: 연산자마다 하나의 장소만 전달할 수 있습니다. 참고: X 장소 ID를 얻는 방법은 GET geo/search Standard v1.1 엔드포인트를 참조하세요. 예: place:"new york city" OR place:seattle OR place:fd70c22040963ac7 |
place_country: | Standalone | Advanced | 태그된 장소/위치에 연결된 국가 코드가 지정한 ISO 알파-2 문자 코드와 일치하는 게시물과 매칭합니다. 유효한 ISO 코드 목록은 위키백과에서 확인할 수 있습니다. place_country: 연산자마다 하나의 ISO 코드만 전달할 수 있습니다. 예: place_country:US OR place_country:MX OR place_country:CA |
point_radius: | Standalone | Advanced | 게시물에 존재할 경우 place.geo.coordinates 객체를 기준으로, 또한 X에서는 장소 지오 폴리곤을 기준으로 매칭하며, 장소 폴리곤이 정의한 영역 안에 완전히 포함되어 있어야 합니다. point_radius:[longitude latitude radius]. 지원 단위는 마일(mi)과 킬로미터(km)입니다. 반경은 25mi 미만이어야 합니다. 경도는 ±180, 위도는 ±90 범위입니다. 모든 좌표는 소수(십진) 도입니다. 규칙 인수는 대괄호 안에 공백으로 구분해 넣습니다. 예: point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] |
bounding_box: | Standalone | Advanced | 게시물에 존재할 경우 place.geo.coordinates 객체를 기준으로, 또한 X에서는 장소 지오 폴리곤을 기준으로 매칭하며, 장소 폴리곤이 정의한 영역 안에 완전히 포함되어 있어야 합니다. bounding_box:[west_long south_lat east_long north_lat]. 경계 상자의 가로·세로 길이는 25mi 미만이어야 합니다. 경도는 ±180, 위도는 ±90 범위입니다. 모든 좌표는 소수(십진) 도입니다. 규칙 인수는 대괄호 안에 공백으로 구분해 넣습니다. 예: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
is:retweet | Conjunction required | Core | 지정한 나머지 규칙과 함께 매칭되는 리트윗을 찾습니다. 이 연산자는 실제 리트윗만 찾습니다(예: 리트윗 버튼으로 생성된 경우). 인용 게시물은 이 연산자로 매칭되지 않습니다. 예: data @XDevelopers -is:retweet |
is:reply | Conjunction required | Core | 규칙과 일치하는 명시적 답글만 전달합니다. 또한 부정 연산으로 쿼리와 일치하는 답글을 전달 대상에서 제외할 수 있습니다. 참고: 이 연산자는 필터링된 스트림 엔드포인트에서도 사용할 수 있습니다. 필터링된 스트림에서 사용하면 원본 게시물에 대한 답글, 인용 게시물 내 답글, 리트윗 내 답글을 매칭합니다. 예: from:XDevelopers is:reply |
is:quote | Conjunction required | Core | 모든 인용 트윗(댓글이 있는 게시물)을 반환합니다. 예: "sentiment analysis" is:quote |
is:verified | 접속사 필요 | 기본 | 작성자가 X에서 인증된 경우에만 게시물을 반환합니다. 예: #nowplaying is:verified |
-is :nullcast | 접속사 필요 | 고급 | ads.x.com에서 프로모션 전용으로 생성되었고 "source":"Twitter for Advertisers (legacy)" 또는 "source":"Twitter for Advertisers" 값을 가진 게시물을 제외합니다. 이 연산자는 반드시 부정형으로 사용해야 합니다. Nullcast된 게시물에 대한 자세한 내용은 게시물 이용 가능성 페이지를 참고하세요. 예: "mobile games" -is:nullcast |
has:hashtags | 접속사 필요 | 기본 | 하나 이상의 해시태그를 포함하는 게시물과 일치합니다. 예: from:XDevelopers -has:hashtags |
has:cashtags | 접속사 필요 | 고급 | 앞에 ‘’문자가붙은캐시태그(예:‘tag)를 포함하는 게시물과 일치합니다. 예: #stonks has:cashtags` |
has:links | 접속사 필요 | 기본 | 본문에 링크와 미디어가 포함된 게시물과 일치합니다. 예: from:XDevelopers announcement has:links |
has:mentions | 접속사 필요 | 기본 | 다른 X 사용자를 언급하는 게시물과 일치합니다. 예: #nowplaying has:mentions |
has:media | 접속사 필요 | 기본 | 사진, GIF, 동영상 등의 미디어 객체를 포함하는 게시물과 일치합니다(판단은 X에 의해 이루어집니다). Periscope로 생성된 미디어나 다른 미디어 호스팅 사이트로의 링크가 있는 게시물에는 일치하지 않습니다. 예: (kittens OR puppies) has:media |
has:images | 접속사 필요 | 기본 | 인식 가능한 이미지 URL을 포함하는 게시물과 일치합니다. 예: #meme has:images |
has:videos | 접속사 필요 | 기본 | X에 직접 업로드된 네이티브 X 동영상을 포함하는 게시물과 일치합니다. Periscope로 생성된 동영상이나 다른 동영상 호스팅 사이트로의 링크가 있는 게시물에는 일치하지 않습니다. 예: #icebucketchallenge has:videos |
has:geo | 접속사 필요 | 고급 | X 사용자가 제공한 게시물별 지리정보를 가진 게시물과 일치합니다. 이는 X 장소 형태의 위치(해당 표시 이름, 지오 폴리곤 및 기타 필드 포함)일 수도 있고, 드문 경우 위도·경도 좌표일 수도 있습니다. 참고: 장소(게시물 지오)를 기준으로 일치시키는 연산자는 원본 게시물만 포함합니다. 리트윗에는 장소 데이터가 없습니다. 예: recommend #paris has:geo -bakery |
lang: | 접속사 필요 | 기본 | X에 의해 특정 언어로 분류된 게시물과 일치합니다(게시물이 분류된 경우에 한함). 각 게시물은 현재 하나의 언어로만 분류되므로 여러 언어를 AND로 결합하면 결과가 나오지 않습니다. lang: 연산자마다 하나의 BCP 47 언어 식별자만 전달할 수 있습니다. 참고: 언어 분류가 불가능한 경우 결과는 ‘und’(undefined)입니다. 예: recommend #paris lang:en |
