연산자 목록
참고: 일부 연산자에는 다른 이름(별칭)을 사용할 수 있습니다.
| 연산자 | type | 설명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
keyword | 단독 사용 가능 | 게시물 본문에 포함된 키워드와 일치하는지 검사합니다. 이는 토큰 단위 매치로, 사용자가 지정한 키워드 문자열을 게시물 본문의 토큰화된 텍스트와 비교한다는 의미입니다. 토큰화는 구두점, 기호, 유니코드 기본 평면의 구분 문자 등을 기준으로 단어를 분리합니다. 예를 들어 “I like coca-cola”라는 텍스트가 포함된 게시물은 다음과 같은 토큰으로 분리됩니다: I, like, coca, cola. 그런 다음 이 토큰들을 쿼리에 사용한 키워드 문자열과 비교합니다. 구두점(예: coca-cola), 기호, 또는 구분 문자가 포함된 문자열을 매치하려면 키워드를 큰따옴표로 감싸야 합니다. 예시: pepsi OR cola OR "coca cola" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
emoji | 단독 사용 가능 | 게시물 본문에서 이모지를 일치시킵니다. 키워드와 유사하게, 이모지는 토큰 단위로 일치가 이뤄지며, 사용한 이모지가 게시물 본문의 토큰화된 텍스트와 비교되어 매칭됩니다. 이모지에 변형(variant)이 있는 경우, 쿼리에 추가하려면 큰따옴표로 감싸야 합니다. 예시: (😃 OR 😡) 😬 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
"exact phrase match" | 단독 사용 가능 | 게시물 본문에서 검색어와 정확히 일치하는 구를 찾습니다. 예시: ("X API" OR #v2) -"recent search" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
# | 단독 사용 가능 | 게시물에서 해당 해시태그가 인식된 엔티티인 경우, 그 해시태그를 포함하는 모든 게시물과 매칭합니다. 이 연산자는 토큰화 일치가 아닌 정확한 일치를 수행합니다. 따라서 규칙 #thanku는 정확히 #thanku 해시태그가 포함된 포스트와만 매칭되고, #thankunext 해시태그가 포함된 포스트와는 매칭되지 않습니다.예시: #thankunext #fanart OR @arianagrande | ||||||||||||||||||||||||||||||||||||||||||||||||||||
@ | 단독 사용 가능 | 지정한 사용자 이름을 언급하는 모든 게시물과 일치하며, 이때 해당 사용자 이름은 @ 문자를 포함한 인식된 엔터티여야 합니다. 예시: (@XDevelopers OR @API) -@X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
$ | 단독 사용 가능 | 지정된 ‘캐시태그(cashtag)‘를 포함하는 모든 게시물과 일치합니다(토큰의 첫 글자가 문자일 때).<br /><br />캐시태그 연산자는 본문에서 직접 캐시태그를 추출하려고 시도하는 대신, 캐시태그를 매칭하기 위해 X의 'symbols' 엔터티 추출 기능에 의존한다는 점에 유의하십시오.<br /><br />예시: `twtr OR @XDevelopers -$fb` | ||||||||||||||||||||||||||||||||||||||||||||||||||||
from: | 단독 사용 가능 | 특정 사용자가 작성한 게시물과 일치합니다. 값으로는 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 user ID를 사용할 수 있습니다. from: 연산자에는 username/ID를 하나만 사용할 수 있습니다.예시: from:XDevelopers OR from:API -from:X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
to: | 단독 사용 가능 | 특정 사용자에 대한 답글인 모든 게시물과 일치합니다. 값은 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 사용자 ID일 수 있습니다. 각 to: 연산자에는 하나의 사용자 이름/ID만 전달할 수 있습니다.예시: to:XDevelopers OR to:API -to:X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
url: | 단독 사용 가능 | 게시물에 포함된, 올바른 형식의 모든 URL에 대해 토큰 단위 매칭을 수행합니다. 이 연산자는 url 또는 expanded_url 필드의 내용과 모두 매칭됩니다. 예를 들어, “You should check out X Developer Labs: https://t.co/c0A36SWil4” (짧은 URL이 https://developer.twitter.com으로 리디렉션됨)이라는 내용을 포함하는 게시물은 다음 두 규칙 모두와 일치합니다.from:XDevelopers url:"https://developer.twitter.com" (이는 entities.urls.expanded_url의 내용과 일치하기 때문입니다)from:XDevelopers url:"https://t.co" (이는 entities.urls.url의 내용과 일치하기 때문입니다)문장 부호나 특수 문자가 포함된 토큰과 구는 큰따옴표로 감싸야 합니다(예: url:"/developer"). 마찬가지로, 특정 프로토콜과 매칭하려면 큰따옴표로 감싸야 합니다(예: url:"https://developer.twitter.com"). | ||||||||||||||||||||||||||||||||||||||||||||||||||||
retweets_of: | 단독 사용 가능 | 지정된 사용자의 게시물을 리트윗한 포스트를 매칭합니다. 값에는 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 user ID를 사용할 수 있습니다.retweets_of: 연산자 하나당 하나의 사용자 이름/ID만 전달할 수 있습니다.예시: retweets_of:twitterdev OR retweets_of:twitterapi | ||||||||||||||||||||||||||||||||||||||||||||||||||||
in_reply_to_tweet_id: | 단독 사용 가능 | 사용 가능한 별칭: in_reply_to_status_id:지정된 게시물에 대한 답글과 일치하는 게시물을 검색합니다. 예시: in_reply_to_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
retweets_of_tweet_id: | 단독 사용 가능 | 사용 가능한 별칭: retweets_of_status_id:지정된 게시물의 명시적(또는 네이티브) 리트윗과 일치합니다. 사용할 게시물 ID는 리트윗이 아닌 원본 게시물의 ID여야 합니다. 예시: retweets_of_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
quotes_of_tweet_id: | 단독 사용 가능 | 사용 가능한 별칭: quotes_of_status_id:지정된 게시물을 인용한 Tweet에 대해 매칭됩니다. 사용되는 게시물 ID는 인용 Tweet이 아니라 원본 게시물의 ID여야 합니다. 예시: quotes_of_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
context: | 단독 사용 가능 | 특정 domain id/entity id 쌍과 일치하는 포스트를 검색합니다. 이 연산자에 대해 더 알아보려면 annotations 페이지를 방문하세요. 하나의 context: 연산자마다 도메인/엔티티는 하나만 전달할 수 있습니다.context:domain_id.entity_id그러나 OR 연산자를 사용해 여러 도메인/엔티티를 조합할 수 있습니다. (context:47.1139229372198469633 OR context:11.1088514520308342784)예시: context:10.799022225751871488 (domain_id.entity_id는 해당 도메인-엔티티 쌍과 일치하는 포스트를 반환합니다) | ||||||||||||||||||||||||||||||||||||||||||||||||||||
entity: | 단독 사용 가능 | 특정 엔티티 문자열 값과 일치하는 포스트를 반환합니다. 이 연산자에 대해 더 알아보려면 annotations 페이지를 방문하세요. 참고: 이 기능은 최근 검색에서만 사용할 수 있습니다. entity: 연산자는 한 번에 하나만 사용할 수 있습니다.entity:"string declaration of entity/place"예시: entity:"Michael Jordan" OR entity:"Barcelona" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
conversation_id: | 단독 사용 가능 | 공통된 대화 ID를 가진 포스트와 일치하는 게시물을 반환합니다. 대화 ID는 대화를 시작한 게시물의 게시물 ID로 설정됩니다. 게시물에 대한 답글이 게시될 때마다, 답글에 대한 답글까지 포함하여, 해당 게시물의 JSON 페이로드에 conversation_id가 추가됩니다.각 conversation_id: 연산자마다 하나의 대화 ID만 지정할 수 있습니다.예시: conversation_id:1334987486343299072 (from:XDevelopers OR from:api) | ||||||||||||||||||||||||||||||||||||||||||||||||||||
list: | 단독 사용 가능 | 지정된 리스트에 속한 사용자가 게시한 포스트와 일치하는 결과를 반환합니다. 예를 들어 @XDevelopers와 @api가 리스트 123의 구성원이고, 쿼리에 list:123을 포함했다면 응답에는 해당 계정들이 게시한 포스트만 포함됩니다. List lookup 엔드포인트를 사용해 리스트 ID를 조회할 수 있습니다.주의: 쿼리당 사용할 수 있는 list: 연산자는 하나뿐이며, 각 list: 연산자마다 하나의 리스트만 지정할 수 있습니다.예시: list:123 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
place: | 단독 사용 가능 | 지정된 위치 또는 X place ID가 태그된 포스트와 일치합니다. 여러 단어로 구성된 장소 이름(“New York City”, “Palo Alto”)은 큰따옴표로 감싸야 합니다.place: 연산자에는 하나의 place만 전달할 수 있습니다.참고: X place ID를 얻는 방법은 GET geo/search 표준 v1.1 엔드포인트를 참조하세요. 참고: 이 연산자는 리트윗에는 적용되지 않습니다. 리트윗의 장소 정보는 원본 포스트에 연결되기 때문입니다. 또한 Quote Tweet의 원본 포스트에 연결된 장소에도 적용되지 않습니다. 예시: place:"new york city" OR place:seattle OR place:fd70c22040963ac7 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
place_country: | 단독 사용 가능 | 태그된 장소/위치에 연관된 국가 코드가 지정된 ISO 알파-2 문자 코드와 일치하는 포스트를 매칭합니다. 유효한 ISO 코드 목록은 Wikipedia에서 확인할 수 있습니다. place_country: 연산자당 하나의 ISO 코드만 전달할 수 있습니다.참고: Retweet에 연결된 장소 정보는 원본 게시물에 연결되므로, 이 연산자는 Retweet에는 매칭되지 않습니다. 또한 Quote Tweet의 원본 게시물에 연결된 장소에도 매칭되지 않습니다. 예시: place_country:US OR place_country:MX OR place_country:CA | ||||||||||||||||||||||||||||||||||||||||||||||||||||
point_radius: | 단독 사용 가능 | 게시물에 place.geo.coordinates 객체가 존재하는 경우 해당 객체와, X에서는 장소 지오 폴리곤을 대상으로 매칭하며, 이때 Place 폴리곤이 지정된 영역 안에 완전히 포함되어 있어야 합니다.point_radius:[longitude latitude radius]- 지원되는 반지름 단위는 마일(mi)과 킬로미터(km)입니다 - 반지름은 25mi 미만이어야 합니다 - 경도는 ±180 범위여야 합니다 - 위도는 ±90 범위여야 합니다 - 모든 좌표는 십진 도(degree) 단위입니다 - 규칙 인수는 대괄호 안에 넣고, 공백으로 구분합니다 point_radius: 연산자당 하나의 지오 폴리곤만 지정할 수 있습니다.참고: 이 연산자는 리트윗에는 매칭되지 않습니다. 리트윗의 장소 정보는 원본 게시물에 연결되어 있기 때문입니다. 또한 인용 Tweet의 원본 게시물에 연결된 장소에도 매칭되지 않습니다. 예시: point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] | ||||||||||||||||||||||||||||||||||||||||||||||||||||
bounding_box: | 단독 사용 가능 | 사용 가능한 별칭: geo_bounding_box:Post에 place.geo.coordinates 객체가 있을 경우 해당 객체에 대해 매치를 수행하고, X에서는 지정된 영역 안에 장소 폴리곤이 완전히 포함되는 place geo 폴리곤에 대해 매치를 수행합니다.bounding_box:[west_long south_lat east_long north_lat]- west_long south_lat는 bounding box의 남서쪽 모서리를 나타내며, west_long는 그 지점의 경도, south_lat는 위도를 의미합니다.- east_long north_lat는 bounding box의 북동쪽 모서리를 나타내며, east_long는 그 지점의 경도, north_lat는 위도를 의미합니다.- bounding box의 너비와 높이는 25mi 미만이어야 합니다. - 경도는 ±180 범위여야 합니다. - 위도는 ±90 범위여야 합니다. - 모든 좌표는 십진수 도(degree) 단위입니다. - 규칙 인수는 대괄호 안에 공백으로 구분하여 넣습니다. bounding_box: 연산자당 하나의 geo 폴리곤만 전달할 수 있습니다.참고: 이 연산자는 Retweet의 장소 정보가 원본 Post에 연결되므로 Retweet에는 일치하지 않습니다. 또한 Quote Tweet의 원본 Post에 연결된 장소에도 일치하지 않습니다. 예시: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:retweet | 다른 조건과 함께 사용해야 함 | 지정된 규칙의 다른 조건을 모두 충족하는 Retweet만 매칭합니다. 이 연산자는 Retweet 버튼을 사용해 생성된 Retweet과 같은 실제 Retweet만을 대상으로 합니다. Quote Tweet은 이 연산자로 매칭되지 않습니다. 예시: data @XDevelopers -is:retweet | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:reply | 다른 조건과 함께 사용해야 함 | 규칙과 일치하는 명시적인 답글만 전달합니다. 또한 부정 형태로 사용하여 쿼리와 일치하는 답글을 전달 대상에서 제외할 수도 있습니다. 참고: 이 연산자는 filtered stream 엔드포인트에서도 사용할 수 있습니다. filtered stream과 함께 사용할 때, 이 연산자는 원본 게시물에 대한 답글, 인용된 Tweet에 달린 답글, 리트윗에 달린 답글을 대상으로 일치 여부를 평가합니다. 예시: from:XDevelopers is:reply | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:quote | 다른 조건과 함께 사용해야 함 | 모든 Quote Tweet, 즉 댓글이 포함된 포스트를 반환합니다. 예: "sentiment analysis" is:quote | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:verified | 다른 조건과 함께 사용해야 함 | X에서 인증된 사용자가 작성한 포스트만 반환합니다. 예시: #nowplaying is:verified | ||||||||||||||||||||||||||||||||||||||||||||||||||||
-is:nullcast | 다른 조건과 함께 사용해야 함 | ads.twitter.com에서 프로모션 용도로만 생성되고 "source":"Twitter for Advertisers (legacy)" 또는 "source":"Twitter for Advertisers" 값을 가진 포스트를 제외합니다.이 연산자는 반드시 부정형으로 사용해야 합니다. Nullcast 처리된 포스트에 대한 자세한 내용은 게시물 가용성 페이지를 참고하세요. Example: "mobile games" -is:nullcast | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:hashtags | 다른 조건과 함께 사용해야 함 | 적어도 하나의 해시태그를 포함하는 포스트와 일치합니다. 예시: from:XDevelopers -has:hashtags | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:cashtags | 다른 조건과 함께 사용해야 함 | 선행 문자로 ‘tag)를 포함하는 포스트와 일치합니다.<br /><br />예시: #stonks has:cashtags` | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:links | 다른 조건과 함께 사용해야 함 | 이 연산자는 포스트 본문에 링크와 미디어가 포함된 포스트와 일치합니다. 예시: from:XDevelopers announcement has:links | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:mentions | 다른 조건과 함께 사용해야 함 | 다른 X 사용자를 언급한 포스트와 일치합니다. 예시: #nowplaying has:mentions | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:media | 다른 조건과 함께 사용해야 함 | 사용 가능한 별칭: has:media_linkX에서 사진, GIF, 동영상과 같은 미디어 객체가 포함되어 있다고 판단한 포스트와 일치합니다. Periscope에서 생성된 미디어나 다른 미디어 호스팅 사이트에 대한 링크가 포함된 포스트와는 일치하지 않습니다. 예: (kittens OR puppies) has:media | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:images | 다른 조건과 함께 사용해야 함 | 인식된 이미지의 URL을 포함하는 포스트와 일치합니다. 예시: #meme has:images | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:video_link | 다른 조건과 함께 사용해야 함 | 사용 가능한 별칭: has:videosX에 직접 업로드된 네이티브 X 동영상이 포함된 포스트와 일치합니다. Periscope로 생성된 동영상이나 다른 동영상 호스팅 사이트로 연결되는 링크가 포함된 포스트에는 일치하지 않습니다. 예시: #icebucketchallenge has:video_link | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:geo | 다른 조건과 함께 사용해야 함 | X 사용자가 제공한, 게시물에 특화된 지리 정보가 포함된 포스트와 일치합니다. 이는 표시 이름, geo 폴리곤 및 기타 필드를 포함하는 X place 형태의 위치이거나, 드문 경우 geo 위도/경도 좌표일 수 있습니다. 참고: place(게시물 geo)을 기준으로 일치시키는 연산자는 원본 포스트만 대상으로 일치시킵니다. 리포스트에는 place 데이터가 포함되지 않습니다. 예: recommend #paris has:geo -bakery | ||||||||||||||||||||||||||||||||||||||||||||||||||||
lang: | 다른 조건과 함께 사용해야 함 | X에서 특정 언어로 분류된 포스트(해당 게시물이 분류된 경우에만)에 일치합니다. 각 포스트는 현재 하나의 언어로만 분류되므로, 여러 언어를 AND 조건으로 함께 사용해도 결과는 반환되지 않는다는 점에 유의해야 합니다. 각 lang: 연산자마다 하나의 BCP 47 언어 식별자만 전달할 수 있습니다.참고: 언어 분류를 할 수 없는 경우 결과로 ‘und’(미정의)가 제공됩니다. 예시: recommend #paris lang:en아래 목록은 현재 지원되는 언어와 해당 BCP 47 언어 식별자를 나타냅니다: 암하라어: am | 독일어: de | 말라얄람어: ml | 슬로바키아어: sk아랍어: ar | 그리스어: el | 디베히어(몰디브어): dv | 슬로베니아어: sl아르메니아어: hy | 구자라트어: gu | 마라티어: mr | 소라니 쿠르드어: ckb바스크어: eu | 아이티 크리올어: ht | 네팔어: ne | 스페인어: es벵골어: bn | 히브리어: iw | 노르웨이어: no | 스웨덴어: sv보스니아어: bs | 힌디어: hi | 오리야어: or | 타갈로그어: tl불가리아어: bg | 로마자 힌디어: hi-Latn | 펀자브어: pa | 타밀어: ta버마어: my | 헝가리어: hu | 파슈토어: ps | 텔루구어: te크로아티아어: hr | 아이슬란드어: is | 페르시아어: fa | 태국어: th카탈루냐어: ca | 인도네시아어: in | 폴란드어: pl | 티베트어: bo체코어: cs | 이탈리아어: it | 포르투갈어: pt | 번체 중국어: zh-TW덴마크어: da | 일본어: ja | 루마니아어: ro | 터키어: tr네덜란드어: nl | 칸나다어: kn | 러시아어: ru | 우크라이나어: uk영어: en | 크메르어: km | 세르비아어: sr | 우르두어: ur에스토니아어: et | 한국어: ko | 간체 중국어: zh-CN | 위구르어: ug핀란드어: fi | 라오어: lo | 신디어: sd | 베트남어: vi프랑스어: fr | 라트비아어: lv | 싱할라어: si | 웨일스어: cy조지아어: ka | 리투아니아어: lt |