메인 콘텐츠로 건너뛰기
이 페이지에서는 Filtered Stream v2의 규칙 쿼리 빌드 시 사용 가능한 연산자 목록을 제공합니다.

연산자 목록

참고: 일부 연산자에는 다른 이름(별칭)이 제공됩니다.
오퍼레이터타입설명
keyword독립형Post 본문에 포함된 키워드와 일치합니다. 이는 토큰화 기반 매칭으로, 키워드 문자열을 Post 본문을 토큰화한 텍스트와 대조해 일치 여부를 판단합니다. 토큰화는 문장부호, 기호, 그리고 유니코드 기본 평면의 구분 문자를 기준으로 단어를 분할합니다.
예를 들어 “I like coca-cola”라는 텍스트가 포함된 Post는 다음과 같은 토큰으로 분할됩니다: I, like, coca, cola. 그런 다음 이러한 토큰을 규칙에서 사용하는 키워드 문자열과 비교합니다. 구두점(예: coca-cola), 기호 또는 구분 문자(separator)가 포함된 문자열을 매치하려면 키워드를 큰따옴표로 감싸야 합니다.

예:pepsi OR cola OR "coca cola"
emoji독립형Post 본문에 포함된 이모지와 일치합니다. 키워드와 마찬가지로 이모지는 토큰화된 방식으로 매칭되며, 즉 해당 이모지가 Post 본문 텍스트를 토큰화한 결과와 비교되어 매칭됩니다.

이모지에 변형이 있는 경우 규칙에 추가하려면 반드시 큰따옴표로 감싸야 합니다.

예:(😃 OR 😡) 😬
"정확히 일치하는 구"독립형Post 본문에서 정확히 일치하는 구문과 매칭합니다.

예:("X API" OR #v2) -"filtered stream"
"keyword1 keyword2"~N독립형키워드가 일정 거리 이내에 있는 Post와 일치시키는 근접 연산자N서로 N개의 토큰 이내에 있는
역순 키워드는 최대N-2토큰 간격을 분리합니다.N보다 클 수 없습니다6.

예:"소셜 미디어"~5 OR "API"~3
#독립형해시태그가 Post에서 인식된 엔터티인 경우, 인식된 해시태그를 포함하는 모든 Post와 일치합니다.

이 연산자는 토큰화된 일치가 아닌 정확한 일치를 수행하며, 즉 규칙#thanku정확히 #thanku 해시태그가 붙은 Post와는 일치하지만, #thankunext 해시태그가 붙은 Post와는 일치하지 않습니다.

예시:#thankunext #fanart OR @arianagrande
@독립형사용자 이름이 인식된 엔티티인 경우(‘@’ 문자 포함), 해당 사용자 이름을 언급하는 모든 Post와 매칭됩니다.

예시:(@XDevelopers OR @api) -@x
$독립형지정된 값을 포함하는 모든 Post와 일치합니다’캐시태그’(토큰의 맨 앞 문자가 인 경우).<br /><br />cashtag 연산자는 본문에서 직접 cashtag를 추출하려 시도하지 않고 X의 ‘symbols’ 엔터티 추출에 의존한다는 점에 유의하세요&#39;s&#39;기호&#39;본문에서 직접 캐시태그를 추출하려 하기보다, 캐시태그와 매칭하기 위해 X의 symbols 엔터티 추출을 사용합니다.<br /><br />예:`twtr OR @XDevelopers -$fb`
from:독립형특정 사용자의 Post와 일치하는 항목입니다.
값은 사용자 이름(@ 문자는 제외) 또는 사용자의 숫자형 사용자 ID일 수 있습니다’의 숫자형 사용자 id입니다.

사용자 이름/ID는 하나만 전달할 수 있습니다from:오퍼레이터.

예:from:XDevelopers OR from:api -from:X
받는 사람:독립형특정 사용자에게 달린 답글인 모든 Post와 일치합니다.
값은 사용자 이름(@ 문자를 제외) 또는 사용자’숫자형 사용자 id.

to: 연산자마다 사용자 이름/id는 하나만 전달할 수 있습니다받는 사람:운영자.

예:to:XDevelopers OR to:api -to:x
url:독립형유효한 형식의 Post URL에 대해 토큰화 기반 매칭을 수행합니다.

이 연산자는 urlexpanded_url 필드의 내용 모두와 일치시킬 수 있습니다.url또는expanded_urlfields. 예를 들어, 다음과 같은 내용을 포함한 Post”X Developer Labs를 살펴보세요:https://t.co/c0A36SWil4”(단축 URL이 다음으로 리디렉션되어https://developer.x.com)는 다음 두 규칙 모두와 일치합니다:

from:XDevelopers url:"https://developer.x.com"
(왜냐하면 그것이 내용과 일치하기 때문입니다entities.urls.expanded_url)

from:XDevelopers url:"https://t.co"
(이는 내용과 일치하기 때문입니다entities.urls.url)

구두점이나 특수 문자가 포함된 토큰 및 구는 큰따옴표로 감싸야 합니다(예:url:"/developer"). 마찬가지로, 특정 프로토콜과 일치시키려면 큰따옴표로 감싸세요(예:url:"https://developer.x.com").

항목당 URL은 하나만 전달할 수 있습니다url:오퍼레이터.
retweets_of:독립형사용 가능한 별칭: retweets_of_user:
지정한 사용자의 리트윗인 Post와 일치합니다. 값은 사용자 이름(@ 문자를 제외) 또는 사용자 ID(숫자)일 수 있습니다’숫자형 사용자 id입니다.

retweets_of: 연산자당 사용자 이름/id는 하나만 전달할 수 있습니다retweets_of:연산자.

예:retweets_of:XDevelopers OR retweets_of:twitterapi
참조여기에서숫자형 X 계정 id를 조회하는 방법은 여기를 참고하세요.
context:독립형특정 도메인 id 및/또는 도메인 id와 엔터티 id의 쌍과 일치하는 Post를 찾습니다. 여기서 * 는 와일드카드를 의미합니다. 이 연산자에 대해 자세히 알아보려면 다음 페이지를 방문하세요Post 주석.

context: 연산자마다 하나의 도메인/엔터티만 전달할 수 있습니다context:연산자.

context:domain_id.entity_id
context:domain_id.*
context:*.entity_id

예시:
context:10.799022225751871488
(domain_id.entity_id해당 도메인-엔터티 쌍과 일치하는 Post를 반환함)

context:47.*
(domain_id.*해당 도메인 id와 일치하는 Post를 반환하며, 도메인-엔터티 쌍은 어떤 조합이든 가능함)

context:*.799022225751871488
(*.entity_id해당 엔터티 ID와 일치하는 Post를 반환하며, 도메인-엔터티 쌍은 어떤 것이든 가능합니다.
entity:독립형특정 엔터티 문자열 값과 일치하는 Post를 반환합니다. 이 연산자에 대해 자세히 알아보려면 다음 페이지를 방문하세요주석(Annotations).

entity: 연산자에는 한 번에 하나의 엔터티만 전달할 수 있습니다.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)
소개:독립형사용 가능한 별칭: user_bio:
Post 게시자의 프로필 소개에 있는 키워드 또는 구문과 일치합니다’의 프로필 소개. 콘텐츠 내에서 토큰화된 일치 항목입니다설명내부 필드사용자 객체.

예:bio:developer OR bio:"data engineer" OR bio:academic
bio_name:독립형Post 게시자 내의 키워드와 일치’사용자 프로필 이름. 사용자의 콘텐츠 내에서 토큰화된 일치입니다.’s”이름”~ 내의 필드User 오브젝트.

예:bio_name:phd OR bio_name:md
bio_location:독립형사용 가능한 별칭: user_bio_location:
사용자 위치에 지정한 키워드 또는 구가 포함된 사용자가 게시한 Post와 일치하는 항목을 반환합니다. 이 연산자는 메시지 본문에 대한 일반 키워드 규칙과 유사하게 토큰화 기반 매치를 수행합니다.

이 위치는 다음의 일부입니다.사용자 객체, 에서 다음과 일치함’위치’필드이며, 비정규화된 사용자 생성 자유 형식 문자열입니다. 또한 Post와도 다릅니다’의 위치(참조:place:).

예:bio_location:"big apple" OR bio_location:nyc OR bio_location:manhattan
place:독립형지정된 위치 또는 X place ID로 태그된 Post를 매칭합니다. 여러 단어로 된 장소 이름(“New York City”, “Palo Alto”)은 따옴표로 묶어야 합니다.

place: 연산자에는 한 번에 하나의 장소만 지정할 수 있습니다place:연산자

참고: 다음을 참조하세요GET geo/searchX place ID를 얻는 방법에 대해서는 standard v1.1 엔드포인트 GET geo/search를 참조하세요.

참고: 이 연산자는 리트윗에는 일치하지 않습니다. 리트윗’의 장소는 원본 Post에 연결됩니다. 또한 Quote Tweet의 원본 Post에 연결된 장소와도 일치하지 않습니다.

예시:place:"new york city" OR place:seattle OR place:fd70c22040963ac7
place_country:독립형태그된 장소/위치에 연결된 국가 코드가 지정된 ISO 알파-2 문자 코드와 일치하는 Post를 반환합니다.

유효한 ISO 코드 목록은 다음에서 확인할 수 있습니다위키백과.

place_country: 연산자마다 ISO 코드 하나만 전달할 수 있습니다place_country:연산자

참고: 이 연산자는 리트윗에는 적용되지 않습니다. 리트윗’의 장소는 원본 Post에 연결됩니다. 또한 Quote Tweet의 원본 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입니다
- 모든 좌표는 소수점 표기 도(degree) 단위를 사용합니다
- 규칙 인수는 대괄호 안에 넣고, 공백으로 구분합니다

요청당 지정할 수 있는 지오 폴리곤은 하나뿐입니다point_radius:오퍼레이터.

참고: 이 연산자는 리트윗에는 일치하지 않습니다. 리트윗’의 장소는 원본 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위도입니다.
- 경계 상자의 너비와 높이는 25mi 미만이어야 합니다
- 경도는 ±180의 범위에 있습니다
- 위도는 ±90의 범위입니다
- 모든 좌표는 십진수 도(°) 단위입니다.
- 규칙 인수는 대괄호 안에 있으며 공백으로 구분됩니다.

bounding_box: 연산자에는 지오 폴리곤을 하나만 전달할 수 있습니다bounding_box:연산자.

Note: 이 연산자는 리트윗에는 매칭되지 않습니다. 리트윗’s 장소는 원본 Post에 연결됩니다. 또한 인용 트윗의 원본 Post에 연결된 장소와도 일치하지 않습니다.

예:bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
is:retweet접속사가 필요합니다지정된 규칙의 다른 조건과도 일치하는 리트윗을 매칭합니다. 이 연산자는 실제 리트윗(예: 리트윗 버튼으로 생성된 경우)만을 찾습니다. 인용 트윗은 이 연산자에 의해 매칭되지 않습니다.

예:data @XDevelopers -is:retweet
is:reply접속사가 필요합니다규칙과 일치하는 응답만 명시적으로 전달합니다. 부정을 사용해 해당 규칙과 일치하는 응답을 전달에서 제외할 수도 있습니다.

필터된 스트림과 함께 사용하면, 이 연산자는 원본 Post에 대한 답글, 인용된 Post의 답글, 그리고 리트윗의 답글과 일치합니다.

예시:from:XDevelopers is:reply
is:quote접속사가 필요합니다댓글이 포함된 Post(Quote Tweet)로 알려진 모든 항목을 반환합니다.

예제:"감정 분석" is:quote
is:verified접속사가 필요합니다작성자가 X에서 인증된 Post만 전달하세요.

예:#nowplaying is:verified
-is:nullcast접속사가 필요합니다ads.twitter.com에서 프로모션 전용으로 생성된 Post를 제거하며, 해당 Post에는source:"Twitter for Advertisers (레거시)"또는source:"Twitter for Advertisers".
이 연산자는 반드시 반전되어야 합니다.

Nullcast된 Post에 대한 자세한 내용은 다음 페이지를 참고하세요Post 사용 가능 여부.

예:"모바일 게임" -is:nullcast
has:hashtags접속사가 필요합니다하나 이상의 해시태그를 포함하는 Post와 일치합니다.

예시:from:XDevelopers -has:hashtags
has:cashtags접속사가 필요합니다캐시태그 기호가 포함된 Post와 일치합니다(앞에는 ‘’문자가붙습니다.:’ 문자가 붙습니다. 예: `tag)&#39;$&#39;문자. 예를 들어,$tag).<br /><br />예:#stonks has:cashtags`
has:links접속사가 필요합니다이 연산자는 Post 본문에 링크와 미디어가 포함된 Post를 일치시킵니다.

예:from:XDevelopers has:links
has:mentions접속사가 필요합니다다른 X 사용자를 언급한 Post를 매칭합니다.

예:#nowplaying has:mentions
has:media접속사가 필요합니다사용 가능한 별칭: has:media_link
X에서 판단한 사진, GIF, 동영상 등 미디어 객체를 포함하는 Post와 일치합니다. Periscope로 생성된 미디어나 다른 미디어 호스팅 사이트로 연결되는 링크가 있는 Post에는 일치하지 않습니다.

예:(kittens OR puppies) has:media
has:images접속사가 필요합니다인식된 이미지 URL을 포함하는 Post와 일치합니다.

예:#meme has:images
has:video_link접속사가 필요합니다사용 가능한 별칭: has:videos
X에 직접 업로드된 네이티브 X 동영상이 포함된 Post와 일치합니다. Periscope로 생성된 동영상이나 다른 동영상 호스팅 사이트 링크가 포함된 Post에는 일치하지 않습니다.

예:#아이스버킷챌린지 has:video_link
has:geo접속사가 필요합니다X 사용자가 제공한 Post 전용 지리정보가 포함된 Post와 일치합니다. 위치 정보는 X 장소 형태(해당 표시 이름, 지오 폴리곤 및 기타 fields 포함)일 수도 있고, 드문 경우 위도·경도 좌표일 수도 있습니다.

참고: 장소(포스트 지오)에 매칭하는 연산자는 원본 포스트에서의 일치만 포함합니다. 리트윗에는 장소 data가 포함되지 않습니다.

예:recommend #paris has:geo -bakery
샘플:접속사가 필요합니다규칙과 일치하는 전체 Post 집합이 아닌, 무작위로 추출한 백분율 샘플의 Post를 반환합니다. 백분율 값은 1부터 100 사이의 정수로 지정해야 합니다(예:sample:10무작위 10% 샘플을 반환합니다).

이 연산자는 먼저 스트림 범위를 지정한 비율만큼 축소한 뒤, 그로 샘플링된 하위 집합에 규칙/필터를 적용합니다. 다시 말해, 예를 들어 다음과 같은 경우에는,sample:10, 각 Post가 샘플에 포함될 확률은 10%입니다.

이 연산자는 전체 규칙에 적용되며 OR로 연결된 모든 항목을 하나로 묶어야 합니다’d 용어를 그룹화해야 합니다.

예:#nowplaying @spotify sample:15
lang:접속사가 필요합니다X에 의해 특정 언어로 분류된 Post와 일치합니다(해당 Post가 분류된 경우에만). 현재 각 Post는 하나의 언어로만 분류되므로 여러 언어를 AND 연산으로 함께 지정하면 결과가 반환되지 않습니다.

lang: 연산자당 BCP 47 언어 식별자는 하나만 전달할 수 있습니다lang:오퍼레이터.

참고: 언어를 분류할 수 없는 경우 제공되는 결과는 ‘und’(미정의)입니다’und’(정의되지 않은 경우).

예시:recommend #paris lang:en

아래 목록은 현재 지원되는 언어와 해당 BCP 47 언어 식별자를 나타냅니다:

언어BCP 47
*-
암하르어am
아랍어ar
아르메니아어hy
바스크어EU
벵골어bn
보스니아어bs
불가리아어bg
미얀마어my
크로아티아어hr
카탈án어ca
체코어cs
덴마크어da
네덜란드어nl
영어영어
에스토니아어et
핀란드어fi
프랑스어fr
조지아어ka
독일어de
그리스어el
구자라티어gu
아이티 크리올ht
히브리어iw
힌디안녕하세요
라틴 문자 표기의 힌디어hi-Latn
헝가리어hu
아이슬란드어is
인도네시아어in
이탈리아어it
일본어ja
칸나다kn
크메르km
한국어ko
라오어(라오스어)lo
라트비아어lv
리투아니아어lt
말라얄람ml
디베히어dv
마라티어mr
네팔어ne
노르웨이어아니요
오리아또는
펀자비어pa
파슈토ps
페르시아어fa
폴란드어pl
포르투갈어pt
루마니아어ro
러시아어ru
세르비아어sr
중국어(간체자)zh-CN
신드어sd
싱할라어si
슬로바크어sk
슬로베니아어sl
소라니 쿠르드어ckb
스페인어es
스웨덴어sv
타갈로그tl
타밀ta
텔루구te
태국어th
티벳어bo
번체 중국어zh-TW
터키어tr
우크라이나어영국
우르두ur
위구르어ug
베트남어vi
웨일스어cy
followers_count:작성자의 팔로워 수가 지정된 범위에 있을 때 해당 Post를 매칭합니다.
단일 숫자를 지정하면 해당 숫자 이상인 값이 모두 매치됩니다.

예:followers_count:500

또한 지정된 범위 내의 모든 숫자와 일치하도록 범위를 지정할 수 있습니다.

예시:followers_count:1000..10000
tweets_count:사용 가능한 별명: statuses_count:
작성자가 게시한 Post 수가 지정된 범위에 해당할 때 해당 Post와 일치합니다.
단일 숫자를 지정하면 해당 숫자 이상인 모든 값이 매치됩니다.

예시:tweets_count:1000

또한 지정된 범위 내의 임의의 숫자와 일치하도록 범위를 지정할 수 있습니다.

예:tweets_count:1000..10000
following_count:사용 가능한 별칭: friends_count:
작성자가 팔로우하는 사용자 수(friends)가 지정된 범위에 해당하는 Post를 매칭합니다.
단일 숫자를 지정하면, 그 숫자 이상인 값은 모두 매칭됩니다.

예:following_count:500

또한 지정된 범위 내의 임의의 숫자와 일치하도록 범위를 지정할 수 있습니다.

예시:following_count:1000..10000
listed_count:사용 가능한 별칭: user_in_lists_count:
작성자가 지정된 개수의 리스트(Lists)에 포함된 Post와 일치합니다.
단일 숫자를 지정하면 해당 숫자 이상인 값이 모두 매칭됩니다.

예시:listed_count:10

또한 지정된 범위 내의 임의의 숫자와 일치하도록 범위를 지정할 수 있습니다.

예:listed_count:10..100
url_title:사용 가능한 별칭: within_url_title:
확장된 URL의 HTML 제목 메타데이터에서 키워드/문구 일치를 수행합니다.

예:url_title:snow
url_description:사용 가능한 별칭: within_url_description:
확장된 페이지 설명 메타데이터에서 키워드/구문을 매칭합니다.

예시:url_description:weather
url_contains:지정한 구문 또는 키워드를 글자 그대로 포함한 URL이 있는 Post와 일치시킵니다. 구두점이 포함된 패턴(예: google.com)을 검색하려면 검색어를 따옴표로 묶으세요.
참고: 이는 확장된 URL에도 매칭됩니다.

예:url_contains:photos
source:지정된 소스 App에서 생성된 모든 Post와 일치합니다. 값은 애플리케이션 이름 또는 애플리케이션의 URL이어야 합니다.‘s의 URL입니다. 단독으로 사용할 수 없습니다.

예시:source:"iPhone용 X"

참고: X App 개발자인 경우, 애플리케이션이 프로그램적으로 생성한 Post에는 애플리케이션 설정에서 설정한 애플리케이션 이름과 웹사이트 URL이 소스로 표시됩니다.App 설정.
in_reply_to_tweet_id:사용 가능한 별칭: in_reply_to_status_id:
지정된 Post에 대한 명시적 Reply만 전달합니다.

예:in_reply_to_tweet_id:1539382664746020864
retweets_of_tweet_id:사용 가능한 별칭: retweets_of_status_id:
지정된 Post의 명시적(또는 네이티브) 리트윗만 반환합니다. 사용되는 status id는 리트윗이 아닌 원본 Post의 id여야 합니다.

예:retweets_of_tweet_id:1539382664746020864