연산자 목록
참고: 일부 연산자는 다른 이름(별칭)을 사용할 수 있습니다.
| 연산자 | Type | 설명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
keyword | 단독 사용 가능 | 게시물 본문에서 키워드를 일치시킵니다. 이는 토큰 단위 일치 방식으로, 입력한 키워드 문자열을 게시물 본문의 토큰화된 텍스트와 비교해 일치 여부를 판단한다는 의미입니다. 토큰화는 단어를 문장 부호, 기호, 그리고 유니코드 기본 평면의 구분 문자(separator)를 기준으로 분리합니다. 예를 들어 “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) -"filtered stream" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
"keyword1 keyword2"~N | 단독 사용 가능 | 키워드가 서로 N개의 토큰 이내에 위치해 있을 때 해당 게시물을 매칭하는 근접 연산자입니다.역순으로 나타나는 키워드는 서로 N-2개의 토큰보다 멀리 떨어져 있을 수 없습니다. N은 6을 초과할 수 없습니다.예시: "social media"~5 OR "API"~3 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
# | 단독 사용 가능 | 해시태그가 게시물 내에서 인식된 엔티티인 경우, 해당 해시태그를 포함하는 모든 게시물과 일치합니다. 이 연산자는 토큰 단위의 일치가 아닌 정확히 일치하는 방식으로 동작하므로, 규칙 #thanku는 해시태그 #thanku가 정확히 동일하게 포함된 게시물과만 일치하고, 해시태그 #thankunext가 포함된 게시물과는 일치하지 않습니다.예시: #thankunext #fanart OR @arianagrande | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@ | 단독 사용 가능 | 지정된 사용자 이름을 언급하는 모든 게시물과 일치합니다. 단, 사용자 이름이 인식된 엔티티(@ 문자를 포함)인 경우에만 해당합니다. 예시: (@XDevelopers OR @api) -@x | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
$ | 단독 사용 가능 | 지정된 ‘cashtag’를 포함하는 모든 게시물과 일치합니다(토큰의 첫 글자가 문자일 때).<br /><br />cashtag 연산자는 본문 자체에서 cashtag를 직접 추출하려고 시도하는 대신, cashtag를 매칭하기 위해 X의 'symbols' 엔티티 추출 기능에 의존한다는 점에 유의하세요.<br /><br />예시: `twtr OR @XDevelopers -$fb` | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
from: | 단독 사용 가능 | 특정 사용자가 작성한 모든 게시물을 반환합니다. 값은 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 사용자 ID일 수 있습니다. from: 연산자당 하나의 사용자 이름/ID만 전달할 수 있습니다.예시: from:XDevelopers OR from:api -from:X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
to: | 단독 사용 가능 | 특정 사용자에게 작성된 답글인 모든 게시물과 일치합니다. 값은 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 user 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.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:지정된 사용자의 게시물을 리트윗한 포스트와 일치합니다. 값으로는 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 user ID를 사용할 수 있습니다. retweets_of: 연산자당 하나의 사용자 이름/ID만 전달할 수 있습니다.예: retweets_of:XDevelopers OR retweets_of:twitterapi숫자형 X 계정 ID를 조회하는 방법은 여기를 참조하세요. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
context: | 단독 사용 가능 | 특정 도메인 id 및/또는 도메인 id, 엔티티 id 쌍과 일치하는 포스트를 반환하며, *는 와일드카드를 의미합니다. 이 연산자에 대해 더 알아보려면 Post annotations 페이지를 방문하세요.context: 연산자당 하나의 도메인/엔티티만 전달할 수 있습니다.context:domain_id.entity_idcontext:domain_id.*context:*.entity_id예시: context:10.799022225751871488( domain_id.entity_id는 해당 도메인-엔티티 쌍과 정확히 일치하는 포스트를 반환합니다)context:47.*( domain_id.*는 해당 도메인 id와 일치하고, 도메인-엔티티 쌍은 어떤 값이든 상관없는 포스트를 반환합니다)context:*.799022225751871488( *.entity_id는 해당 엔티티 id와 일치하고, 도메인-엔티티 쌍은 어떤 값이든 상관없는 포스트를 반환합니다) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
entity: | 단독 사용 가능 | 특정 엔티티 문자열 값을 가진 포스트를 검색합니다. 이 연산자에 대해 더 알아보려면 annotations 페이지를 방문하세요.entity: 연산자당 하나의 엔티티만 전달할 수 있습니다.entity:"string declaration of entity/place"예시: entity:"Michael Jordan" OR entity:"Barcelona" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
conversation_id: | 단독 사용 가능 | 공통 대화 ID를 공유하는 포스트와 일치시킵니다. 대화 ID는 대화를 시작한 게시물의 Post ID가 됩니다. 게시물에 답글이 달릴 때마다, 답글에 대한 답글까지 포함하여 모든 답글의 JSON 페이로드에 conversation_id가 추가됩니다.각 conversation_id: 연산자에는 하나의 대화 ID만 전달할 수 있습니다.예시: conversation_id:1334987486343299072 (from:XDevelopers OR from:api) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bio: | 단독 사용 가능 | 사용 가능한 별칭: user_bio:게시물 작성자의 bio에 포함된 키워드 또는 구를 기준으로 매칭합니다. 이는 User object의 description 필드 내용에 대해 토큰 단위로 일치시킵니다.예시: bio:developer OR bio:"data engineer" OR bio:academic | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bio_name: | 단독 사용 가능 | 게시물 작성자의 사용자 프로필 이름(bio name)에서 키워드를 일치시킵니다. 이는 User object의 “name” 필드 내용에 대해 토큰 단위로 일치 여부를 검사합니다. 예시: bio_name:phd OR bio_name:md | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bio_location: | 단독 사용 가능 | 사용 가능한 별칭: user_bio_location:위치 정보에 지정한 키워드나 구문이 포함된 사용자가 게시한 포스트와 일치합니다. 이 연산자는 메시지 본문에 대한 일반 키워드 규칙과 유사하게 토큰화 방식으로 매칭을 수행합니다. 이 위치 정보는 User object의 일부이며, ‘location’ 필드를 기준으로 매칭되며, 정규화되지 않은, 사용자가 임의로 입력하는 자유 형식 문자열입니다. 또한 포스트의 위치( place: 참조)와는 다릅니다.예시: bio_location:"big apple" OR bio_location:nyc OR bio_location:manhattan | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
place: | 단독 사용 가능 | 지정된 위치 또는 X place ID로 태그된 포스트를 일치시킵니다. 여러 단어로 구성된 장소 이름(“New York City”, “Palo Alto”)은 따옴표로 묶어야 합니다.place: 연산자에는 place를 하나만 전달할 수 있습니다.참고: X place ID를 얻는 방법은 GET geo/search 표준 v1.1 엔드포인트를 참고하세요. 참고: 이 연산자는 Retweet의 place가 원본 게시물에 연결되기 때문에 Retweet에는 일치하지 않습니다. 또한 Quote Tweet의 원본 게시물에 연결된 place에도 일치하지 않습니다. 예시: 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 객체가 존재하는 경우 해당 게시물의 place.geo.coordinates 객체와 매칭되며, X에서는 장소 지오 폴리곤을 기준으로 매칭합니다. 이때 Place 폴리곤은 정의된 영역 안에 완전히 포함되어 있어야 합니다.point_radius:[longitude latitude radius]- 지원되는 반지름 단위는 마일(mi)과 킬로미터(km)입니다 - 반지름은 25mi 미만이어야 합니다 - 경도는 ±180 범위입니다 - 위도는 ±90 범위입니다 - 모든 좌표는 십진수 도(degree)입니다 - 규칙 인수는 대괄호 안에 공백으로 구분하여 넣습니다 point_radius: 연산자당 하나의 지오 폴리곤만 전달할 수 있습니다.주의: 이 연산자는 리트윗에는 매칭되지 않습니다. 리트윗의 장소 정보는 원본 게시물에 연결되어 있기 때문입니다. 또한 Quote 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)에 연결되기 때문입니다. 또한 Quote Tweet의 원본 게시물에 연결된 장소 정보에도 매칭되지 않습니다. 예시: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
is:retweet | 다른 조건과 결합 필수 | 지정한 규칙의 나머지 조건과 모두 일치하는 Retweet에 매칭합니다. 이 연산자는 실제 Retweet(예: Retweet 버튼으로 생성된 Retweet)만을 대상으로 합니다. Quote Tweet은 이 연산자에 의해 매칭되지 않습니다. 예시: data @XDevelopers -is:retweet | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
is:reply | 다른 조건과 결합 필수 | 규칙과 일치하는 명시적인 답글만 전달합니다. 또한 규칙과 일치하는 답글을 전달 대상에서 제외하도록 부정 형태로도 사용할 수 있습니다. 필터링된 스트림에서 사용하면, 이 연산자는 원본 게시물에 대한 답글, 인용 포스트에 대한 답글, 리트윗에 대한 답글을 대상으로 일치 여부를 판단합니다. 예: from:XDevelopers is:reply | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
is: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" 값을 가진 포스트를 제외합니다.이 연산자는 반드시 부정형으로 사용해야 합니다. Nullcasted 포스트에 대한 자세한 내용은 Post availability 페이지를 참고하세요. 예시: "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 사용자가 제공한, 게시물 단위의 위치 정보(geolocation data)가 있는 게시물과 일치합니다. 이는 표시 이름, geo polygon, 기타 필드를 포함하는 X place 형태의 위치이거나, 드문 경우 위도·경도(geo lat-long) 좌표일 수 있습니다. 참고: place(게시물 geo)에 대해 매칭하는 연산자는 원본 게시물에서의 일치 결과만 포함합니다. 리트윗에는 place 데이터가 포함되지 않습니다. 예시: recommend #paris has:geo -bakery | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sample: | 다른 조건과 결합 필수 | 규칙과 일치하는 전체 포스트 집합이 아니라, 그중 일부를 무작위로 추출한 백분율 샘플을 반환합니다. 백분율 값은 1에서 100 사이의 정수로 표현해야 합니다(예: sample:10은 무작위 10% 샘플을 반환합니다).이 연산자는 먼저 스트림의 범위를 지정한 백분율로 축소한 다음, 그 샘플 하위 집합에 규칙/필터를 적용합니다. 다시 말해, 예를 들어 sample:10을 사용하는 경우 각 포스트가 샘플에 포함될 확률은 10%입니다.이 연산자는 전체 규칙에 적용되며, OR로 연결된 모든 항을 그룹화해야 합니다. 예: #nowplaying @spotify sample:15 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lang: | 다른 조건과 결합 필수 | X가 특정 언어로 분류한 포스트와 일치합니다(포스트가 분류된 경우에만 해당). 각 게시물은 현재 하나의 언어로만 분류되므로, 여러 언어를 AND 조건으로 함께 사용하면 어떤 결과도 반환되지 않는다는 점이 중요합니다. 각 lang: 연산자에는 하나의 BCP 47 언어 식별자만 전달할 수 있습니다.참고: 언어 분류를 할 수 없는 경우 반환되는 값은 ‘und’(미정의)입니다. 예시: recommend #paris lang:en아래 목록은 현재 지원되는 언어와 해당 BCP 47 언어 식별자를 나타냅니다. | 언어 | BCP 47 | * | - | 암하라어 | am | 아랍어 | ar | 아르메니아어 | hy | 바스크어 | eu | 벵골어 | bn | 보스니아어 | bs | 불가리아어 | bg | 미얀마어 | my | 크로아티아어 | hr | 카탈루냐어 | ca | 체코어 | cs | 덴마크어 | da | 네덜란드어 | nl | 영어 | en | 에스토니아어 | et | 핀란드어 | fi | 프랑스어 | fr | 조지아어 | ka | 독일어 | de | 그리스어 | el | 구자라티어 | gu | 아이티 크리올어 | ht | 히브리어 | iw | 힌디어 | hi | 로마자 표기 힌디어 | hi-Latn | 헝가리어 | hu | 아이슬랜드어 | is | 인도네시아어 | in | 이탈리아어 | it | 일본어 | ja | 칸나다어 | kn | 크메르어 | km | 한국어 | ko | 라오어 | lo | 라트비아어 | lv | 리투아니아어 | lt | 말라얄람어 | ml | 디베히어 | dv | 마라티어 | mr | 네팔어 | ne | 노르웨이어 | no | 오리야어 | or | 펀자브어 | 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 | 우크라이나어 | uk | 우르두어 | ur | 위구르어 | ug | 베트남어 | vi | 웨일스어 | cy | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
followers_count: | 작성자의 팔로워 수가 지정된 범위 내에 있을 때 포스트와 일치합니다. 단일 숫자를 지정하면, 그 숫자 이상인 모든 값이 일치합니다. 예시: followers_count:500또한 범위를 지정하여 해당 범위 내의 모든 숫자와 일치하도록 할 수 있습니다. 예시: followers_count:1000..10000 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tweets_count: | 사용 가능한 별칭: statuses_count:작성자의 총 포스트 수가 지정된 범위에 있을 때 해당 작성자의 포스트와 일치합니다. 단일 숫자만 지정하면, 그 숫자 이상인 경우가 모두 일치합니다. 예: tweets_count:1000또한 범위를 지정하여 해당 범위에 속하는 모든 값과 일치시키도록 할 수 있습니다. 예: tweets_count:1000..10000 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
following_count: | 사용 가능한 별칭: friends_count:작성자의 친구 수(팔로우하는 사용자 수)가 지정된 범위 안에 있을 때 해당 포스트와 매칭됩니다. 단일 숫자를 지정하면, 그 숫자 이상인 경우 모두 매칭됩니다. 예시: following_count:500또한 범위를 지정하여 해당 범위에 포함되는 모든 수와 매칭되도록 할 수 있습니다. 예시: following_count:1000..10000 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
listed_count: | 사용 가능한 별칭: user_in_lists_count:작성자가 지정된 수의 리스트에 포함되어 있는 포스트와 일치합니다. 단일 숫자를 지정하면 해당 숫자 이상인 모든 값이 일치합니다. 예시: listed_count:10또한 범위를 지정하면 해당 범위에 속하는 모든 숫자가 일치합니다. 예시: listed_count:10..100 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url_title: | 사용 가능한 별칭: within_url_title:확장된 URL의 HTML title 메타데이터에서 키워드/구문을 기준으로 일치 여부를 검사합니다. 예시: url_title:snow | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url_description: | 사용 가능한 별칭: within_url_description:확장된 페이지 설명 메타데이터에서 키워드/문구 일치 검색을 수행합니다. 예시: url_description:weather | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url_contains: | 지정한 구 또는 키워드를 그대로 포함하는 URL이 있는 포스트와 일치합니다. 문장 부호가 포함된 패턴(예: google.com)을 검색하려면 검색어를 따옴표로 감싸십시오. NOTE: 확장된 URL에도 일치합니다. 예: url_contains:photos | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
source: | 지정된 소스 애플리케이션에서 생성된 모든 게시물과 일치합니다. 값은 애플리케이션 이름이거나 애플리케이션 URL이어야 합니다. 단독으로는 사용할 수 없습니다. 예시: source:"X for iPhone"참고: X 앱 개발자인 경우, 애플리케이션에서 프로그램 방식으로 생성한 포스트에는 앱 설정에서 설정한 애플리케이션 이름과 웹사이트 URL이 소스로 지정됩니다. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
in_reply_to_tweet_id: | 사용 가능한 별칭: in_reply_to_status_id:지정된 게시물에 대한 명시적 답글만 전달합니다. 예시: in_reply_to_tweet_id:1539382664746020864 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
retweets_of_tweet_id: | 사용 가능한 별칭: retweets_of_status_id:지정된 게시물에 대한 명시적(또는 네이티브) 리트윗만 반환합니다. 사용되는 status ID는 리트윗이 아닌 원본 게시물의 ID여야 합니다. 예시: retweets_of_tweet_id:1539382664746020864 |