연산자 목록
참고: 일부 연산자는 다른 이름(별칭)을 사용할 수 있습니다.
| 오퍼레이터 | 유형 | 설명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
keyword | 독립형 | Post 본문 내 키워드와 일치하는 항목을 찾습니다. 이는 토큰화 기반 매칭으로, 입력한 키워드 문자열을 Post 본문을 토큰화한 텍스트와 비교해 일치 여부를 판단합니다. 토큰화는 구두점, 기호, 그리고 유니코드 기본 평면의 구분 문자를 기준으로 단어를 분리합니다. 예를 들어, 텍스트 “I like coca-cola”가 포함된 Post는 다음과 같은 토큰으로 분리됩니다: I, like, coca, cola. 그런 다음 이러한 토큰을 쿼리에서 사용한 키워드 문자열과 비교합니다. 구두점(예: coca-cola), 기호 또는 구분 문자(Separator)가 포함된 문자열과 일치시키려면 키워드를 큰따옴표로 감싸야 합니다. 예: pepsi OR cola OR "coca cola" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
이모지 | 독립형 | Post 본문에 포함된 이모지와 일치합니다. 키워드와 마찬가지로 이모지는 토큰 단위로 매칭되며, 즉 입력한 이모지가 Post 본문 텍스트를 토큰화한 결과와 비교되어 일치 여부가 판단됩니다. 이모지에 변형이 있는 경우 쿼리에 추가하려면 반드시 큰따옴표로 감싸야 합니다. 예: (😃 OR 😡) 😬 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
"정확한 구문 일치" | 독립형 | Post 본문에서 해당 구문과 정확히 일치하는 항목을 찾습니다. 예: ("X API" OR #v2) -"recent search" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
# | 독립형 | 해시태그가 Post에서 인식된 엔터티인 경우, 해당 해시태그를 포함하는 모든 Post와 매칭됩니다. 이 연산자는 토큰화 일치가 아닌 정확한 일치를 수행합니다. 즉, 규칙 #thanku는 해시태그 #thanku가 정확히 동일한 게시물과만 일치하며, 해시태그 #thankunext가 있는 게시물과는 일치하지 않습니다.#thanku정확히 #thanku 해시태그가 포함된 게시물과는 일치하지만, #thankunext 해시태그가 포함된 게시물과는 일치하지 않습니다.예시: #thankunext #fanart OR @arianagrande | ||||||||||||||||||||||||||||||||||||||||||||||||||||
@ | 독립형 | 지정된 사용자 이름(@ 포함)이 인식된 엔터티인 경우, 해당 사용자 이름을 언급하는 모든 Post와 일치합니다. 예시： (@XDevelopers OR @API) -@X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
$ | 독립형 | 지정된 내용을 포함하는 모든 Post에 해당합니다’캐시태그’(토큰의 첫 글자가 인 경우).<br /><br />cashtag 연산자는 X에 의존한다는 점에 유의하세요's'기호'본문에서 캐시태그를 직접 추출하려 하기보다, 캐시태그와 매칭하기 위해 엔터티 추출을 사용합니다.<br /><br />예시:`twtr OR @XDevelopers -$fb` | ||||||||||||||||||||||||||||||||||||||||||||||||||||
from: | 독립형 | 특정 사용자가 작성한 모든 Post에 매칭됩니다. 값은 사용자 이름(@ 문자는 제외) 또는 사용자의 숫자형 사용자 ID일 수 있습니다. from: 연산자당 사용자 이름이나 id는 하나만 전달할 수 있습니다from:연산자예시: from:XDevelopers OR from:API -from:X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
받는 사람: | 독립형 | 특정 사용자에게 작성된 답글인 모든 Post와 일치합니다. 값은 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 사용자 ID일 수 있습니다. 각 to: 연산자에는 username 또는 ID를 하나만 전달할 수 있습니다받는 사람:오퍼레이터.예시: to:XDevelopers OR to:API -to:X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
url: | 독립형 | 유효한 형식의 Post URL에서 토큰화 기반 매칭을 수행합니다. 이 연산자는 둘 모두의 콘텐츠와 일치합니다 URL또는expanded_urlfields. 예를 들어, 다음과 같은 내용을 포함하는 Post”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: | 독립형 | 지정된 사용자를 리트윗한 Post와 일치합니다. 값은 사용자 이름(‘@’ 문자는 제외) 또는 해당 사용자의 숫자형 user ID일 수 있습니다.retweets_of: 연산자당 사용자명/id는 하나만 전달할 수 있습니다.retweets_of:운영자.예제: retweets_of:twitterdev OR retweets_of:twitterapi | ||||||||||||||||||||||||||||||||||||||||||||||||||||
in_reply_to_tweet_id: | 독립형 | 사용 가능한 별칭: in_reply_to_status_id:지정된 Post에 달린 답글에 대해 일치 항목을 찾습니다. 예: in_reply_to_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
retweets_of_tweet_id: | 독립형 | 사용 가능한 별칭: retweets_of_status_id:지정된 Post의 명시적(또는 네이티브) 리트윗과 매칭됩니다. 사용해야 하는 Post ID는 리트윗이 아닌 원본 Post의 ID여야 합니다. 예시: retweets_of_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
quotes_of_tweet_id: | 독립형 | 사용 가능한 별칭: quotes_of_status_id:지정된 Post의 인용 트윗을 대상으로 매칭합니다. 사용해야 하는 Post ID는 인용 트윗이 아닌 원본 Post의 ID여야 합니다. 예: quotes_of_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
context: | 독립형 | 특정 도메인 id/엔터티 id 쌍과 일치하는 Post를 매칭합니다. 이 연산자에 대해 더 알아보려면 다음 페이지를 방문하세요주석(Annotations).context: 연산자에는 도메인/엔터티를 하나만 전달할 수 있습니다context:연산자.context:domain_id.entity_id하지만 OR 연산자를 사용해 여러 도메인/엔터티를 결합할 수 있습니다: (context:47.1139229372198469633 OR context:11.1088514520308342784)예시: context:10.799022225751871488(domain_id.entity_id해당 도메인-엔터티 쌍과 일치하는 Post를 반환합니다) | ||||||||||||||||||||||||||||||||||||||||||||||||||||
entity: | 독립형 | 특정 엔터티 문자열 값과 일치하는 Post를 찾습니다. 이 연산자에 대해 자세히 알아보려면 다음 페이지를 방문하세요Annotations. 유의해 주세요이는 최근 검색에서만 제공됩니다. 하나만 전달할 수 있습니다. entity:운영자.entity:"엔터티/장소의 문자열 선언"예시: entity:"Michael Jordan" OR entity:"Barcelona" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
conversation_id: | 독립형 | 공통 대화 ID를 공유하는 Post와 매칭됩니다. 대화 ID는 대화를 시작한 Post의 Post ID로 설정됩니다. Post에 대한 Reply가 게시될 때마다, Reply에 대한 Reply까지도,conversation_id해당 항목의 JSON 페이로드에 추가됩니다.conversation_id: 연산자당 하나의 대화 id만 전달할 수 있습니다conversation_id:오퍼레이터.예시: conversation_id:1334987486343299072 (from:XDevelopers OR from:api) | ||||||||||||||||||||||||||||||||||||||||||||||||||||
list: | 독립형 | 지정된 목록의 구성원인 사용자가 작성한 Post와 일치합니다. 예를 들어, @XDevelopers와 @api가 목록 123의 멤버이고, 당신이 포함했다면 list:123쿼리에 이를 포함하면 응답에는 해당 계정이 게시한 Post만 반환됩니다. List id는 List lookup 엔드포인트(/x-api/lists/list-lookup/introduction)를 사용해 찾을 수 있습니다.리스트 조회엔드포인트.참고하세요하나만 사용할 수 있다는 list:쿼리당 하나의 연산자이며, list: 연산자에는 단 하나의 리스트만 지정할 수 있습니다list:오퍼레이터.예: list:123 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
place: | 독립형 | 지정된 위치 또는 X place ID로 태그된 Post와 매치됩니다. 여러 단어로 된 장소 이름(“New York City”, “Palo Alto”)은 따옴표로 묶어야 합니다.place: 연산자당 장소는 하나만 지정할 수 있습니다place:오퍼레이터.참고: 다음을 확인하세요GET geo/searchX place ID를 얻는 방법은 standard v1.1 엔드포인트를 참조하세요. 참고: 이 연산자는 리트윗에는 일치하지 않습니다. 리트윗’의 장소는 원본 Post에 연결됩니다. 또한 Quote Tweet의 원본 Post에 연결된 장소와는 일치하지 않습니다. 예: place:"new york city" OR place:seattle OR place:fd70c22040963ac7 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
place_country: | 독립형 | 태그된 장소/위치에 연결된 국가 코드가 지정된 ISO 알파-2 문자 코드와 일치하는 Post를 반환합니다. 유효한 ISO 코드 목록은 다음에서 확인할 수 있습니다위키백과(Wikipedia). 각 place_country: 연산자에는 ISO 코드를 하나만 전달할 수 있습니다place_country:연산자.Note: 이 연산자는 리트윗에는 일치하지 않습니다. 리트윗의 위치는 원본 트윗에 연결되어 있기 때문입니다.’s 장소는 원본 Post에 첨부됩니다. 또한 인용 트윗의 원본 Post에 첨부된 장소와는 일치하지 않습니다. 예: place_country:US OR place_country:MX OR place_country:CA | ||||||||||||||||||||||||||||||||||||||||||||||||||||
point_radius: | 독립형 | 다음과 대조하여 일치합니다place.geo.coordinatesPost에 해당 필드가 있는 경우 place.geo.coordinates 객체를 대상으로 하며, X에서는 장소의 지오 폴리곤을 기준으로 매칭합니다. 이때 Place 폴리곤이 정의된 영역에 완전히 포함되어야 합니다.point_radius:[경도 위도 반경]- 지원되는 반지름 단위는 마일(mi) 및 킬로미터(km)입니다 - 반경은 25마일 미만이어야 합니다 - 경도는 ±180의 범위 내에 있습니다 - 위도는 ±90의 범위에 있습니다 - 모든 좌표는 십진수 도(°) 단위를 사용합니다 - 규칙 인수는 대괄호로 묶고 공백으로 구분합니다 각 항목당 단일 지오 폴리곤만 전달할 수 있습니다 point_radius:연산자참고: 이 연산자는 리트윗에는 매치되지 않습니다. 리트윗’s 장소는 원본 Post에 연결됩니다. 또한 인용 트윗의 원본 Post에 연결된 장소와도 일치하지 않습니다. 예시: 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에서는 장소의 지오 폴리곤과 매칭됩니다. 이때 장소 폴리곤은 정의된 영역 안에 완전히 포함되어 있어야 합니다.bounding_box:[west_long south_lat east_long north_lat]- 서경_경도 서위_위도경계 상자의 남서 모서를 나타내며west_long해당 지점의 경도이고,south_lat위도입니다.- east_long north_lat바운딩 박스의 북동 모서리를 나타내며,east_long해당 지점의 경도이고,north_lat위도입니다.- 경계 상자의 너비와 높이는 25mi보다 작아야 합니다 - 경도 범위는 ±180입니다 - 위도는 ±90 범위 내에 있습니다 - 모든 좌표는 십진수 도 단위입니다. - 규칙 인수는 대괄호 안에 포함되어 있으며, 공백으로 구분됩니다. 각 bounding_box: 연산자마다 하나의 geo polygon만 전달할 수 있습니다bounding_box:오퍼레이터.Note: 이 연산자는 리트윗과는 일치하지 않습니다. 리트윗’s 장소는 원본 Post에 연결됩니다. 또한 인용 트윗의 원본 Post에 연결된 장소에는 매칭되지 않습니다. 예: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] | ||||||||||||||||||||||||||||||||||||||||||||||||||||
min_likes | 독립형 | 최소 지정된 수 이상의 좋아요가 있는 Post와 일치합니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
min_replies | 독립형 | 최소 지정 개수 이상의 답글이 있는 Post와 일치합니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
min_reposts | 독립형 | 지정된 최소 리포스트 수 이상의 포스트를 매칭합니다. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:retweet | 접속사가 필요합니다 | 지정된 규칙의 다른 조건과도 일치하는 리트윗을 검색합니다. 이 연산자는 실제 리트윗(예: 리트윗 버튼으로 생성된 경우)만을 대상으로 합니다. 인용 트윗은 이 연산자로 검색되지 않습니다. 예시: data @XDevelopers -is:retweet | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:reply | 접속사가 필요합니다 | 규칙과 일치하는 명시적으로 지정된 답글만 전달합니다. 또한 부정을 사용해 쿼리와 일치하는 답글을 전달 대상에서 제외할 수 있습니다. 참고: 이 연산자는 filtered stream 엔드포인트에서도 사용할 수 있습니다. filtered stream에서 사용하면, 이 연산자는 원본 Post에 대한 답글, 인용된 트윗의 답글, 그리고 리트윗의 답글과 일치합니다. 예시: from:XDevelopers is:reply | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:quote | 접속사가 필요합니다 | 댓글이 포함된 Post(인용 트윗) 모두를 반환합니다. 예시: "감성 분석"은:quote | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:verified | 접속사가 필요합니다 | 작성자가 X에서 인증된 경우에만 Post만 전달합니다. 예시: #nowplaying is:verified | ||||||||||||||||||||||||||||||||||||||||||||||||||||
-is:nullcast | 접속사가 필요합니다 | ads.twitter.com에서 프로모션 전용으로 생성된 Post 중 다음을 포함한 항목을 제거합니다"source":"Twitter for Advertisers(레거시)"또는"source":"광고주용 Twitter".이 연산자는 반드시 부정형으로 사용해야 합니다. Nullcast된 Post에 대한 자세한 내용은 다음 페이지를 참조하세요Post 이용 가능 여부. 예시: "mobile games" -is:nullcast | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:hashtags | 접속사가 필요합니다 | 하나 이상의 해시태그를 포함하는 Post와 일치합니다. 예시: from:XDevelopers -has:hashtags | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:cashtags | 접속사가 필요합니다 | 앞에 ‘tag).<br /><br />예시:#stonks has:cashtags` | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:links | 접속사가 필요합니다 | 이 연산자는 Post 본문에 링크와 미디어가 포함된 Post를 매칭합니다. 예: from:XDevelopers announcement has:links | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:mentions | 접속사가 필요합니다 | 다른 X 사용자를 언급한 Post를 매칭합니다. 예: #nowplaying has:mentions | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:media | 접속사가 필요합니다 | 사용 가능한 별칭: has:media_linkX에서 판별한 사진, GIF, 동영상 등 미디어 객체가 포함된 Post와 일치합니다. Periscope로 생성된 미디어나 다른 미디어 호스팅 사이트로 연결되는 링크가 포함된 Post에는 일치하지 않습니다. 예시: (kittens OR puppies) has:media | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:images | 접속사가 필요합니다 | 인식된 이미지 URL을 포함한 Post와 일치합니다. 예시: #meme has:images | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:video_link | 접속사가 필요합니다 | 사용 가능한 별칭: has:videosX에 직접 업로드된 네이티브 X 동영상을 포함하는 Post와 일치합니다. Periscope에서 생성된 동영상이나 다른 동영상 호스팅 사이트로 연결되는 링크가 있는 Post에는 일치하지 않습니다. 예: #icebucketchallenge has:video_link | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:geo | 접속사가 필요합니다 | X 사용자가 제공한 게시물별 지리 위치 데이터가 있는 Post와 일치합니다. 이는 표시 이름, 지오 폴리곤 및 기타 fields가 포함된 X place 형태의 위치이거나, 드문 경우 위도–경도 좌표일 수 있습니다. 참고: 장소(Post 지오)로 매칭하는 연산자는 원본 Post에서의 일치만 포함합니다. 리트윗에는 장소 data가 포함되어 있지 않습니다. 예시: recommend #paris has:geo -bakery | ||||||||||||||||||||||||||||||||||||||||||||||||||||
lang: | 접속사가 필요합니다 | X에서 특정 언어로 분류한 Post와 일치합니다(해당 Post가 분류된 경우에만). 현재 각 Post는 하나의 언어로만 분류되므로, AND로 여러 언어를 함께 지정해도 결과가 나오지 않습니다’여러 언어를 함께 AND로 결합하면 결과가 반환되지 않습니다.lang: 연산자당 BCP 47 언어 식별자는 하나만 전달할 수 있습니다lang:연산자.참고: 언어를 분류할 수 없는 경우 제공되는 결과는 ‘und’(미정)입니다. 예시: recommend #paris lang:en아래 목록은 현재 지원되는 언어와 해당 BCP 47 언어 식별자를 보여줍니다: 암하라어: am | 독일어:de | 말라얄람어:ml | 슬로바크어:sk아랍어: ar | 그리스어:el | 몰디브어:dv | 슬로베니아어:sl아르메니아어: hy | 구자라트어:gu | 마라티어:mr | 소라니어(쿠르드어):ckb바스크어: eu | 아이티 크레올어:ht | 네팔어:네 | 스페인어:es벵골어: bn | 히브리어:he | 노르웨이어:아니요 | 스웨덴어:sv보스니아어: bs | 힌디:안녕하세요 | 오리야:또는 | 타갈로그: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 | 우크라이나어:영국영어: 영어 | 크메르어:km | 세르비아어:sr | 우르두:귀하의에스토니아어: et | 한국어:ko | 중국어(간체):중국어(간체) | 위구르어:ug핀란드어: fi | 라오어:lo | 신디어:sd | 베트남어:vi프랑스어: fr | 라트비아어:lv | 싱할라어:si | 웨일스어:cy조지아어: ka | 리투아니아어:lt |