메인 콘텐츠로 건너뛰기

Enterprise 규칙 및 쿼리 시작하기

Enterprise 연산자를 활용하는 제품은 설정한 필터링 규칙에 따라 소셜 데이터를 제공합니다. 규칙은 하나 이상의 ‘절’로 이루어지며, 절은 키워드, 정확한 구문, 또는 다양한 Enterprise 연산자 중 하나일 수 있습니다. Enterprise 연산자로 규칙을 만들기 전에 아래에 설명된 구문을 검토하고, 사용 가능한 연산자 목록을 살펴보고, 규칙 작성에 대한 제한 사항을 이해해야 합니다. 또한 규칙이 논리적으로 어떻게 평가되는지에 대한 세부 사항은 “연산 순서” 섹션에서 반드시 숙지하시기 바랍니다. 여러 절은 “and”와 “or” 논리를 함께 사용해 결합할 수 있습니다. 참고: “and” 논리는 절 사이의 공백으로, “or” 논리는 대문자 OR로 지정합니다. 각 규칙은 최대 2,048자까지 작성할 수 있으며, 긍정 절(일치 또는 필터링하려는 대상)과 부정 절(제외하여 일치하지 않도록 하려는 대상)의 개수에는 제한이 없습니다.  

규칙과 쿼리 만들기 

키워드 매칭 키워드 매칭은 검색 인터페이스의 쿼리와 유사합니다. 예를 들어, 다음 엔터프라이즈 연산자 규칙은 본문 텍스트에 “social”이라는 용어가 포함된 활동과 매칭됩니다. social 공백으로 용어 AND 결합하기 키워드를 하나 더 추가하는 것은 매칭을 찾기 위한 조건을 하나 더 추가하는 것과 같습니다. 예를 들어, 이 규칙은 텍스트에 “social”과 “media”가 모두 포함된 경우에만, 순서와 상관없이 매칭됩니다 — 용어 사이의 공백은 불리언 AND 로직으로 동작합니다. 규칙에 명시적으로 AND를 포함하면 규칙 엔드포인트에서 거부됩니다. social media 대문자 OR로 용어 OR 결합하기 많은 상황에서는 불리언 OR 로직이 필요합니다. 이것도 쉽게 구현할 수 있습니다. OR 연산자는 반드시 대문자여야 하며, 소문자 ‘or’는 일반 키워드로 처리된다는 점에 유의하세요. social OR data 용어 부정하기 다른 시나리오에서는 특정 키워드가 포함된 결과를 제외해야 할 수도 있습니다(불리언 NOT 로직). 예를 들어, ‘happy’가 있지만 텍스트에 ‘birthday’가 있는 것은 제외합니다. social -personality 괄호로 그룹화하기 이러한 로직은 괄호를 사용해 그룹화하여 결합할 수 있으며, 훨씬 더 복잡한 쿼리로 확장할 수 있습니다. (social OR data) (academic OR research) -personality -information -university 하지만 이는 시작에 불과합니다. 위의 예시는 키워드에 대한 토큰화 기반 매칭에만 의존하지만, 엔터프라이즈 제품은 텍스트에 대해 다양한 유형의 매칭을 수행하는 연산자도 제공합니다. 정확 일치 "social media research" 부분 문자열 매칭 contains:info 근접 매칭 "social media research"~3 또한 다른 연산자를 사용하면 텍스트뿐 아니라 소셜 데이터의 고유한 속성을 기준으로 필터링할 수 있습니다.  게시물을 올리는 사용자 from:XDeveloeprs 미국 콜로라도주 볼더 Pearl St. 반경 10마일 내 지오태그된 트윗 point_radius:[-105.27346517 40.01924738 10.0mi] 모든 것을 종합하기 이는 위에서 설명한 동일한 유형의 로직으로 텍스트 필터와 결합할 수 있습니다. (social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university

불리언 구문

이전 섹션의 예시는 다양한 유형의 불리언 논리와 그룹화를 사용했습니다. 각 항목의 구문과 요구 사항에 대한 자세한 내용은 아래 표를 참고하세요.
논리 유형연산자 구문설명
ANDsocial data두 연산자 사이에 공백이 있으면 그 사이에 AND 논리가 적용됩니다.

두 키워드(“social”, “data”)를 모두 포함하는 활동과 일치합니다.

규칙에서 AND를 명시적으로 사용하지 마세요. 공백만 사용하세요. AND를 명시적으로 쓰면 일반 키워드로 처리됩니다.
ORsocial OR data두 연산자를 OR로 연결하려면, 공백으로 둘러싸인 대문자 OR을 사이에 넣으세요.

두 키워드 중 하나(“social” OR “data”)를 포함하는 활동과 일치합니다.

하나의 규칙에서 OR과 AND 기능을 결합하는 경우, “연산자 적용 순서” 섹션에 설명된 순서를 이해하고, 아래에 설명된 대로 괄호를 사용해 부정되지 않은 연산자들을 함께 그룹화하여 규칙이 예상대로 동작하도록 하세요.

규칙에서는 반드시 대문자 “OR”을 사용해야 합니다. 소문자 ‘or’는 일반 키워드로 처리됩니다.
NOTsocial data
-apple -android -phone
연산자 또는 연산자 그룹 바로 앞에 - 문자를 붙이세요.

예시 규칙은 키워드 “social”을 포함하는 활동과 일치하지만, 키워드 “data”를 포함하는 항목은 제외합니다.

부정된 OR은 규칙이 “firehose에서 부정을 제외한 모든 것”을 요청하게 되는 경우 허용되지 않습니다. 예를 들어, apple OR -ipad는 “ipad”를 언급하지 않는 모든 활동과 일치하게 되므로 유효하지 않습니다.
그룹화(social OR data) -XDevelopers -api여러 연산자를 괄호로 감싸면 기능적 “그룹”이 생성됩니다.

그룹은 개별 절과 마찬가지로 공백(AND)이나 OR로 절과 연결할 수 있습니다. 다만 전체 그룹에 부정을 적용하여 부정을 한데 묶는 방식은 권장되지 않습니다. 대신 각 개별 연산자를 부정하고 공백(AND)으로 나열하세요. 

예를 들어, -(iphone OR imac OR macbook)을 사용하는 대신 다음을 사용하세요: -iphone -imac -macbook

그룹화는 하나의 규칙에 AND와 OR 기능을 함께 사용하는 경우 특히 중요합니다. 규칙을 평가할 때 적용되는 연산자 순서 때문입니다. 자세한 내용은 아래를 참조하세요.
참고: 연산자는 긍정 또는 부정일 수 있습니다. 긍정 연산자는 결과에 포함하고자 하는 대상을 정의합니다. 예: has:hashtags 연산자는 “해시태그를 포함하는 활동을 원한다”는 의미입니다. 부정 연산자는 결과에서 제외하고자 하는 대상을 정의하며, 위에서 설명한 불리언 NOT 논리를 사용해 생성됩니다. 예를 들어, -has:hashtags는 “다른 조건이 일치하더라도 해시태그를 포함하는 모든 활동을 제외하라”는 의미입니다. Premium 연산자 제품은 최대 길이 2,048자 내에서 긍정 및 부정 절의 개수에 제한이 없습니다.  

연산 순서

단일 규칙에서 AND와 OR 기능을 함께 사용할 때에는 아래 연산 순서에 따라 규칙이 평가됩니다.
  1. AND 논리로 연결된 연산자가 먼저 결합됩니다
  2. 그다음 OR 논리로 연결된 연산자가 적용됩니다
예시:
  • apple OR iphone ipadapple OR (iphone ipad)로 평가됩니다
  • ipad iphone OR android(iphone ipad) OR android로 평가됩니다
모호성을 줄이고 규칙이 의도대로 평가되도록 하려면, 필요한 경우 괄호로 항목을 묶으세요. 예:
  • (apple OR iphone) ipad
  • iphone (ipad OR android)

구두점, 발음 구별 부호, 대소문자 구분

Enterprise 연산자용 키워드 또는 해시태그 규칙에 악센트나 발음 구별 부호가 포함되어 있으면, 해당 부호를 고려해 게시물 텍스트(해시태그 또는 키워드)와 매칭됩니다. 키워드 Diacr**í**tica 또는 해시태그 #cumplea**ñ**os가 포함된 규칙은 “Diacrítica” 또는 “#cumpleaños”와는 매칭되지만, 물결표가 없는 “Diacritica” 또는 “#cumpleanos”에는 매칭되지 않습니다. í 또는 스페인어의 **에녜(eñe)**가 없는 경우는 제외됩니다. 악센트나 발음 구별 부호가 있는 문자는 일반 문자와 동일하게 취급되며 단어 경계로 간주되지 않습니다. 예를 들어, 규칙이 cumpleaños인 경우 cumpleaños라는 단어를 포함한 활동에만 매칭되며, cumplea, cumplean, 또는 os를 포함한 활동에는 매칭되지 않습니다. 모든 연산자는 대소문자를 구분하지 않고 평가됩니다. 예를 들어, 규칙 Cat은 다음 모든 항목과 매칭됩니다: “cat”, “CAT”, “Cat”.

PowerTrack 규칙 태그

Matching rules” 페이지에 설명된 대로, 각 규칙에는 태그를 지정하여 생성할 수 있습니다. 이 태그들은 필터링에는 영향을 주지 않지만 앱 내에서 규칙을 논리적으로 묶는 데 사용할 수 있습니다. 각 규칙에는 태그를 하나만 지정할 수 있으며 최대 255자까지 가능합니다. 태그는 API를 통해 규칙을 생성할 때 JSON 형식의 규칙과 함께 포함되며, 자세한 내용은 “Matching rules” 페이지를 참고하세요.

규칙을 JSON 형식으로 작성하기

API를 통해 스트림에 규칙을 추가하거나 삭제하려면 규칙은 JSON 형식을 사용해야 합니다. 기본적으로 각 규칙을 다음 구조로 넣어야 합니다: {"value":"insert_rule_here"} 큰따옴표가 포함된 규칙 규칙에 정확 일치 또는 기타 연산자와 관련된 큰따옴표 문자(“)가 포함된 경우, JSON 구조와 구분되도록 백슬래시로 이스케이프해야 합니다. "social data" @XDevelopers JSON 형식의 규칙은 다음과 같습니다: {"value":"\"social data\" @XDevelopers"} 큰따옴표 문자열 리터럴이 있는 규칙 정확 일치 구문 내에 문자열 리터럴로 큰따옴표 문자를 포함하려면 두 번 이스케이프해야 합니다. 예를 들어, “R” 주위의 큰따옴표를 포함하여 정확한 구문 “Toys “R” Us”에 일치하는 규칙의 일반 텍스트 표기는 다음과 같습니다: "Toys \"R\" Us" 이를 JSON 형식으로 변환할 때는 다음 구조를 사용하세요: {"value":"\"Toys \\\"R\\\" Us\""} 태그가 있는 규칙 위에서 설명한 대로 규칙에 선택적 태그를 포함하려면 규칙 값과 함께 추가 tag 필드를 넣으면 됩니다. {"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"} API 요청 형식 API를 통해 스트림에서 규칙을 추가하거나 삭제할 때, 여러 JSON 형식의 규칙은 쉼표로 구분하고 아래와 같이 JSON “rules” 배열로 감싸야 합니다: {"rules":[{"value":"from:XDevelopers"},{"value":"\social data\" @XDevelopers","tag":"RULE-TAG-01"}]}

인용 트윗과 일치하는 연산자

PowerTrack API 및 Historical PowerTrack API를 사용할 때 아래 연산자는 인용된 원본 게시물과 새 인용 트윗의 콘텐츠 모두에 대해 매칭됩니다. 반면 Search API를 사용하는 경우, 이러한 연산자는 인용 트윗의 콘텐츠에만 매칭되며 인용된 원본 게시물의 콘텐츠에는 매칭되지 않습니다.
  • Keywords
  • Phrases
  • Proximity
  • #hashtags
  • @mentions
  • $cashtags
  • url:
  • url_contains:
  • has:links
  • has:mentions
  • has:hashtags
  • has:media
  • has:symbols
  • is:quote
  • is:reply

Enterprise 연산자

아래는 PowerTrack 및 Historical PowerTrack에서 사용할 수 있는 연산자입니다. 이 중 일부는 30-Day 및 Full-Archive 검색 API에서도 사용할 수 있습니다. 제품별 사용 가능 연산자 목록은 이 표를 참조하세요. 
연산자설명
keyword게시물의 텍스트 본문 또는 URL 내에서 키워드를 일치시킵니다. 키워드는 숫자(0-9) 또는 구두점이 아닌 문자로 시작해야 합니다.
키워드 일치는 토큰화되어 있으며, 이는 키워드가 게시물 본문의 토큰화된 텍스트와 일치함을 의미합니다.
구두점이 포함된 문자열(예: “coca-cola”)의 경우 따옴표로 묶인 “정확한 구문 일치”를 사용하세요.
예시: (social OR pizza OR wildfire) -planet
emoji게시물 본문 내에서 이모지를 일치시키며, 구두점, 기호/이모지, 구분 문자를 기반으로 토큰화된 일치를 사용합니다.
이모지에 변형이 있는 경우 정확한 일치를 위해 따옴표를 사용하세요.
예시: (🍕 OR 💜 OR 🐢) -🤖
”exact phrase match”게시물 본문 내에서 정확한 구문을 일치시킵니다. 구두점은 공백으로 처리됩니다.
예시: ("social media" OR "developer.x.com" OR "wildfire911" OR "coca-cola") -"planet earth"
#지정된 해시태그가 포함된 모든 게시물을 일치시킵니다. 이는 정확한 일치이므로 #2016#2016이 포함된 게시물과 일치하지만 #2016election과는 일치하지 않습니다.
예시: (#social OR #pizza OR #2016election) -#planet
@지정된 사용자 이름을 언급하는 모든 게시물을 일치시킵니다.
예시: (@XDevelopers OR @api OR @twittereng) -@jack
”keyword1 keyword2”~N키워드가 서로 N개의 토큰 이내에 있는 게시물을 일치시키는 근접 연산자입니다.
역순의 키워드는 N-2개 토큰 이상 떨어져 있을 수 없습니다. N은 6보다 클 수 없습니다.
예시: "social media"~5 OR "API"~3
contains:토큰화와 관계없이 본문에 지정된 부분 문자열이 포함된 게시물에 대한 부분 문자열 일치입니다.
공백이나 구두점이 포함된 부분 문자열에는 큰따옴표를 사용하세요.
예시: (contains:social OR contains:"wikipedia.com") -contains:"buy now"
from:X 숫자 계정 ID 또는 사용자 이름(@ 제외)으로 특정 사용자의 모든 게시물을 일치시킵니다.
예시: (from:2244994945 OR from:api OR from:twittereng) -from:jack
to:X 숫자 계정 ID 또는 사용자 이름(@ 제외)으로 특정 사용자에게 답장하는 모든 게시물을 일치시킵니다.
예시: (to:2244994945 OR to:api OR to:twittereng) -to:jack
url:게시물의 확장된 URL에 대해 토큰화된(키워드/구문) 일치를 수행합니다.
예시: @XDevelopers url:"developer.x.com"
url_title:확장된 URL HTML 제목 메타데이터에 대해 키워드/구문 일치를 수행합니다.
PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
url_description:확장된 페이지 설명 메타데이터에 대해 키워드/구문 일치를 수행합니다.
PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
url_contains:지정된 구문 또는 키워드가 포함된 URL이 있는 게시물을 일치시킵니다.
구두점이 포함된 검색어는 따옴표로 묶으세요.
예시: (url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit
bio:게시물의 사용자 소개 내에서 키워드 또는 구문을 일치시킵니다. 이는 User 객체 내의 ‘description’ 필드 내에서 토큰화된 일치입니다.
예시: (bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:troll
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
bio_name:게시물의 사용자 소개 이름 내에서 키워드를 일치시킵니다. 이는 User 객체의 사용자 “name” 필드 내에서 토큰화된 일치입니다.
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
bio_location:User 객체의 위치에 지정된 키워드 또는 구문이 포함된 게시물을 일치시킵니다.
이 연산자는 메시지 본문의 일반 키워드 규칙과 유사하게 토큰화된 일치를 수행합니다.
이 위치는 User 객체의 일부이며, 계정의 ‘홈’ 위치입니다.
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
statuses_count:작성자가 주어진 범위 내에서 일정 수의 상태를 게시한 경우 게시물을 일치시킵니다.
단일 숫자가 지정된 경우 해당 숫자 이상의 모든 숫자가 일치합니다.
범위를 지정하여 범위 내의 모든 숫자를 일치시킬 수 있습니다(예: statuses_count:1000..10000).
예시: to:api statuses_count:10
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
followers_count:작성자의 팔로워 수가 주어진 범위 내에 있는 경우 게시물을 일치시킵니다.
단일 숫자가 지정된 경우 해당 숫자 이상의 모든 숫자가 일치합니다.
범위를 지정하여 범위 내의 모든 숫자를 일치시킬 수 있습니다(예: followers_count:1000..10000).
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
friends_count:작성자의 친구 수(팔로우하는 사용자 수)가 주어진 범위 내에 있는 경우 게시물을 일치시킵니다.
단일 숫자가 지정된 경우 해당 숫자 이상의 모든 숫자가 일치합니다.
범위를 지정하여 범위 내의 모든 숫자를 일치시킬 수 있습니다(예: friends_count:1000..10000).
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
listed_count:작성자가 X 내에서 주어진 범위 내의 특정 횟수만큼 목록에 추가된 경우 게시물을 일치시킵니다.
단일 숫자가 지정된 경우 해당 숫자 이상의 모든 숫자가 일치합니다.
범위를 지정하여 범위 내의 모든 숫자를 일치시킬 수 있습니다(예: listed_count:10..100).
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
$지정된 ‘캐시태그’ 엔티티가 포함된 모든 게시물을 일치시킵니다.
예시: ($TWTR OR $TSLA OR $BRK.A) -$F
참고: 캐시태그 연산자는 본문 자체에서 추출하는 것이 아니라 X의 ‘symbols’ 엔티티 추출에 의존하여 캐시태그를 일치시킵니다.
retweets_of:지정된 사용자의 리트윗인 게시물을 일치시킵니다.
사용자 이름과 숫자 X 계정 ID를 모두 허용합니다(게시물 상태 ID가 아님).
예시: (retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack
retweets_of_status_id:지정된 게시물의 명시적 리트윗만 전달합니다. 리트윗이 아닌 원본 게시물의 ID를 사용하세요.
예시: retweets_of_status_id:1293593516040269825
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
in_reply_to_status_id:지정된 게시물에 대한 명시적 답장만 전달합니다.
예시: in_reply_to_status_id:1293593516040269825
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
sample:규칙과 일치하는 게시물의 무작위 샘플을 반환합니다. 샘플 백분율은 1에서 100 사이의 정수여야 합니다.
연산자는 범위를 X%로 줄인 다음 해당 샘플링된 하위 집합에 규칙/필터를 적용합니다.
예시: #happybirthday sample:5
"happy birthday"~5 sample:80
참고: PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.
source:지정된 소스 애플리케이션에서 생성된 모든 게시물을 일치시킵니다. 값은 애플리케이션 이름 또는 애플리케이션의 URL일 수 있습니다.
예시: #happybirthday source:"X for iPhone"
"This is a test X from my TestingApp" source:MyTestAppName
참고: source 연산자는 게시물 소스 속성을 검색하며 단독으로 사용할 수 없습니다.
lang:X에서 특정 언어로 분류된 게시물을 일치시킵니다. 게시물은 현재 하나의 언어로만 분류되므로 여러 언어를 일치시키면 결과가 나오지 않습니다. 단독으로 사용하는 것은 권장되지 않습니다.
아래 목록은 현재 지원되는 언어와 해당 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
예: (@XDevelopers OR to:XDevelopers) lang:es 참고: 언어 연산자는 X에서 판별하여 Post의 lang 속성으로 설정한 특정 Post 언어와 일치합니다. X Entities JSON 속성에 대한 자세한 내용은 여기를 참조하세요. 특정 Post에 대해 언어 분류를 할 수 없는 경우 해당 Post의 lang은 ‘und’(정의되지 않음)로 설정됩니다.
연산자설명
place지정된 위치 또는 X 장소 ID로 태그된 게시물을 찾습니다.
여러 단어로 된 장소 이름은 따옴표로 묶어야 합니다.
예시: (place:London OR place:"Great Britain") -place:USA
place:fd70c22040963ac7
참고: X 장소 ID를 얻는 방법은 GET geo/search 공개 API 엔드포인트를 참조하세요.
참고: 리트윗 장소는 원본 게시물에 첨부되므로 리트윗 또는 인용 트윗에서는 일치하지 않습니다.
place_country태그된 장소/위치와 연결된 국가 코드가 지정된 ISO alpha-2 문자 코드와 일치하는 게시물을 찾습니다.
예시: place_country:GB OR place_country:AU OR place_country:CA
참고: 리트윗 장소는 원본 게시물에 첨부되므로 리트윗 또는 인용 트윗에서는 일치하지 않습니다.
유효한 ISO 코드: ISO 3166-1 alpha-2.
point_radius:[lon lat radius]게시물의 정확한 위치(x,y) 또는 정의된 반경 내의 “장소” 지오 폴리곤을 찾습니다.
_ 반경: < 25mi
_ 지원 단위: mi, km
_ 경도: ±180
_ 위도: ±90
좌표는 십진 도 단위입니다.
인수는 대괄호로 묶고 공백으로 구분됩니다.
예시: point_radius:[-105.27346517 40.01924738 0.5mi]
예시: point_radius:[2.355128 48.861118 16km]
참고: 리트윗 또는 인용 트윗에서는 일치하지 않습니다.
bounding_box:[west_long south_lat east_long north_lat]경계 상자에 완전히 포함된 정확한 위치 또는 “장소” 지오 폴리곤을 찾습니다.
인수는 대괄호로 묶고 공백으로 구분됩니다.
좌표: 십진 도 단위(±180 경도, ±90 위도).
너비와 높이는 < 25mi여야 합니다.
예시: bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
참고: 리트윗 또는 인용 트윗에서는 일치하지 않습니다.
profile_country작성자의 프로필 지오 국가 코드가 지정된 ISO-3166-1-alpha-2 두 글자 코드와 일치하는 게시물을 찾습니다.
profile_region작성자의 프로필 지오 보강에서 “region” 필드와 정확히 일치하는 전체 문자열을 찾습니다.
공백이나 구두점이 포함된 하위 문자열에는 큰따옴표를 사용하세요.
예시: profile_region:"New York"
profile_locality작성자의 프로필 지오 보강에서 “locality” 필드와 정확히 일치하는 전체 문자열을 찾습니다.
공백이나 구두점이 포함된 하위 문자열에는 큰따옴표를 사용하세요.
예시: profile_locality:"San Francisco"
profile_subregion특정 카운티 또는 대도시 지역을 포함하여 작성자의 프로필 지오 보강에서 “subRegion” 필드를 찾습니다.
정확히 일치하는 전체 문자열입니다.
예시: profile_subregion:"Santa Clara County"
has:geo표시 이름과 지오 폴리곤이 있는 “geo” 위도-경도 또는 “장소” 위치 데이터를 포함하여 X의 게시물별 지오 위치 데이터가 있는 게시물을 찾습니다.
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.
has:profile_geo값에 관계없이 프로필 지오 메타데이터가 있는 게시물을 찾습니다.
사용 가능한 별칭: has:derived_user_geo.
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.
has:links미디어 및 인용 트윗을 포함하여 페이로드의 “text” 객체에 링크 또는 참조된 미디어가 있는 게시물을 찾습니다.
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.
is:retweet명시적 리트윗만 반환합니다. 부정하여 리트윗을 제외하고 원본 콘텐츠만 반환할 수 있습니다.
이 연산자는 진정한 리트윗만 찾으며 인용 트윗은 찾지 않습니다.
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.
is:reply명시적 답글만 반환합니다. 부정하여 답글을 제외할 수 있습니다.
PowerTrack은 원본 게시물에 대한 답글, 인용된 게시물의 답글 및 리트윗의 답글을 찾습니다.
Search API는 원본 게시물에 대한 답글만 찾습니다.
예시: @XDevelopers -is:reply
is:quote인용 트윗 또는 다른 게시물을 참조하는 게시물만 반환합니다.
부정하여 인용 트윗을 제외할 수 있습니다.
예시: @XDevelopers is:quote
is:verified”인증된” 작성자의 게시물만 반환합니다. 부정하여 인증된 작성자의 게시물을 제외할 수 있습니다.
예시: @XDevelopers is:verified
has:mentions다른 X 사용자를 언급하는 게시물을 찾습니다.
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.
has:hashtags해시태그가 포함된 게시물을 찾습니다.
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.
has:mediaX에서 분류한 미디어 URL이 포함된 게시물을 찾습니다(예: pic.x.com).
사용 가능한 별칭: has:media_link.
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.
has:images미디어 URL이 포함된 게시물을 찾습니다(예: pic.x.com).
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.
has:videosX에 업로드된 네이티브 X 동영상이 포함된 게시물을 찾습니다.
사용 가능한 별칭: has:video_link.
이 연산자는 YouTube, Periscope 또는 기타 동영상 호스팅 사이트의 동영상과 일치하지 않습니다.
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.
has:symbols캐시태그 기호가 포함된 게시물을 찾습니다(예: $TWTR).
참고: Search API에서는 is: 또는 has:가 아닌 연산자와 결합해야 합니다.

제품별 연산자

규칙 및 필터링: Enterprise

모든 Enterprise 연산자는 PowerTrack 및 Historical PowerTrack API에서 사용할 수 있습니다. 다만, 이 페이지에 설명된 바와 같이 Enterprise Search API에서는 일부 연산자만 지원됩니다. 짙은 파란색 태그는 각 Enterprise 제품에서 지원되는 연산자를 표시합니다: PowerTrack Search
연산자제품설명페이로드 요소 일치 대상
”exact phrase match”PowerTrack

Search
게시물 본문 내에서 정확한 구문과 일치합니다.

검색 연산자로 변환될 수 있는 구성 요소는 단어로 처리됩니다. 즉:

_ "#hashtag"hashtag와 일치하지만 #hashtag와는 일치하지 않습니다(실제 해시태그와 일치시키려면 따옴표 없이 해시태그 연산자를 사용하세요)
_ "$TWTR"은 단어 TWTR과 일치하지만 캐시태그 $TWTR과는 일치하지 않습니다(실제 캐시태그와 일치시키려면 따옴표 없이 캐시태그 연산자를 사용하세요)

참고: 30 Day Search 및 Full Archive Search(Enterprise 및 Premium)에서는 구두점이 토큰화되지 않고 공백으로 처리됩니다.
text
@PowerTrack

Search
지정된 사용자 이름을 언급하는 모든 게시물과 일치합니다. 값은 사용자 이름(@ 문자 제외) 또는 사용자의 숫자 ID(예: GET users/lookup 엔드포인트를 통해 얻을 수 있음)일 수 있습니다.entities.user_mentions
#PowerTrack

Search
지정된 해시태그가 포함된 모든 게시물과 일치합니다.

이 연산자는 정확한 일치를 수행합니다. 예를 들어 규칙 #1989는 정확한 해시태그 #1989가 포함된 게시물과 일치하지만 해시태그 #TaylorSwift1989가 포함된 게시물과는 일치하지 않습니다.

참고: 이 연산자는 본문 자체에서 해시태그를 추출하는 대신 X의 엔티티 추출을 사용하여 해시태그를 일치시킵니다. 엔티티의 JSON 속성에 대한 자세한 내용은 X Entities를 참조하세요.
entities.hashtags
$PowerTrack

Search
지정된 캐시태그(토큰의 첫 문자가 $인 경우)가 포함된 모든 게시물과 일치합니다.

**참고: **이 연산자는 본문 자체에서 링크를 추출하는 대신 X의 엔티티 추출을 사용하여 링크를 일치시킵니다. 엔티티의 JSON 속성에 대한 자세한 내용은 X Entities를 참조하세요.
entities.symbols
bio:PowerTrack사용 가능한 별칭: user_bio:

게시물의 사용자 약력 내에서 키워드(토큰화된 일치 사용) 또는 구문과 일치합니다. 구문을 일치시키려면 큰따옴표를 사용하세요. 즉:

_ bio:software engineer는 약력에 software라는 단어가 있는 사용자가 작성한 게시물 중 키워드 engineer가 포함된 게시물과 일치합니다
_ bio:"software engineer"는 약력에 software engineer라는 구문이 있는 사용자가 게시한 모든 게시물과 일치합니다
user``.description
bio_location:PowerTrack사용 가능한 별칭: user_bio_location:

User 객체의 위치에 지정된 키워드(토큰화된 일치 사용) 또는 구문이 포함된 게시물과 일치합니다.

이 위치는 정규화되지 않은 사용자 생성 자유 형식 문자열이며, 게시물의 위치(사용 가능한 경우)와는 다릅니다.
user.location
bio_name:PowerTrackUser 객체의 이름에 지정된 키워드(토큰화된 일치 사용) 또는 구문이 포함된 게시물과 일치합니다.user.name
bounding_box:PowerTrack

Search
사용 가능한 별칭: geo_bounding_box:

게시물의 정확한 위치(경도, 위도)(있는 경우) 및 지오 폴리곤(Place가 정의된 영역 내에 완전히 포함된 경우)과 일치합니다.

_ west_long south_lat는 경계 상자의 남서쪽 모서리를 나타내며, 여기서 west-long은 해당 지점의 경도이고 south_lat는 위도입니다.
_ east_long 및 north_lat는 경계 상자의 북동쪽 모서리를 나타내며, 여기서 east_long은 해당 지점의 경도이고 north_lat는 위도입니다.
_ 경계 상자의 너비와 높이는 25마일 미만이어야 합니다
_ 경도는 ±180 범위입니다
_ 위도는 ±90 범위입니다
_ 모든 좌표는 십진수 도 단위입니다.
* 규칙 인수는 대괄호 안에 공백으로 구분되어 포함됩니다.

참고: 장소(게시물 지오)와 일치하는 연산자는 원본 게시물의 일치 항목만 포함합니다. 리트윗에는 장소 데이터가 포함되지 않습니다.
place (원본 게시물만)
contains:PowerTrack토큰화와 관계없이 본문에 지정된 부분 문자열이 있는 게시물에 대한 부분 문자열 일치입니다. 즉, 순수한 부분 문자열 일치를 수행하며 단어 경계를 고려하지 않습니다.

공백이나 구두점이 포함된 부분 문자열을 일치시키려면 큰따옴표를 사용하세요.
text
<emoji>PowerTrack

Search
게시물 본문 내의 이모지와 일치합니다.

이것은 토큰화된 일치이므로 이모지가 게시물 본문의 토큰화된 텍스트와 비교됩니다. 토큰화는 구두점, 기호/이모지 및 구분 기호 유니코드 기본 평면 문자를 기반으로 합니다. 예를 들어 “I like 🍕“라는 텍스트가 있는 게시물은 다음 토큰으로 분할됩니다: I, like, 🍕. 그런 다음 이러한 토큰이 규칙에 사용된 이모지와 비교됩니다.

참고: 이모지에 변형이 있는 경우 규칙에 추가하려면 큰따옴표를 사용해야 합니다.
text
followers_count:PowerTrack작성자의 팔로워 수가 지정된 범위 내에 있을 때 게시물과 일치합니다.

_ 단일 숫자(예: followers_count:42)는 지정된 값 이상의 모든 숫자와 일치합니다.
_ 범위(예: followers_count:42..1337)는 지정된 범위의 모든 숫자와 일치합니다.
user.followers_count
friends_count:PowerTrack사용 가능한 별칭: following_count:

작성자의 친구 수(팔로우하는 사용자 수)가 지정된 범위 내에 있을 때 게시물과 일치합니다.

_ 단일 숫자(예: followers_count:42)는 지정된 값 이상의 모든 숫자와 일치합니다.
_ 범위(예: followers_count:42..1337)는 지정된 범위의 모든 숫자와 일치합니다.
user.friends_count
from:PowerTrack

Search
특정 사용자의 모든 게시물과 일치합니다. 값은 사용자 이름(@ 문자 제외) 또는 사용자의 숫자 ID(예: GET users/lookup 엔드포인트를 통해 얻을 수 있음)일 수 있습니다.user.id, user.id_str (User ID 사용 시)

user.screen_name (사용자 이름 사용 시)
has:geoPowerTrack

Search
X에서 제공하는 게시물별 지리적 위치 데이터가 있는 게시물과 일치합니다. 이는 “geo” 위도-경도 좌표이거나 해당 표시 이름, 지오 폴리곤 및 기타 필드가 있는 X Place 형태의 “location”일 수 있습니다.

독립 실행형 연산자로 사용할 수 없습니다.

참고: 장소(게시물 지오)와 일치하는 연산자는 원본 게시물의 일치 항목만 포함합니다. 리트윗에는 장소 데이터가 포함되지 않습니다.
place (원본 게시물만)
has:hashtagsPowerTrack

Search
하나 이상의 해시태그를 포함하는 게시물과 일치합니다.

독립 연산자로 사용할 수 없습니다.
entities.hashtags
has:imagesPowerTrack

Search
하나 이상의 분류된 이미지 URL을 포함하는 게시물과 일치합니다.

독립 연산자로 사용할 수 없습니다.
entities.media
has:langPowerTrackX에서 특정 언어로 분류한 게시물과 일치합니다.

게시물이 분류되지 않은 경우 연산자가 일치하지 않습니다. 각 게시물은 현재 하나의 언어로만 분류되므로 여러 언어를 AND로 결합하면 결과가 반환되지 않습니다.

독립 연산자로 사용할 수 없습니다.
lang when value is not und
has:linksPowerTrack

Search
이 연산자는 게시물 본문에 링크를 포함하는 게시물과 일치합니다.

독립 연산자로 사용할 수 없습니다.

참고: 이 연산자는 본문 자체에서 링크를 추출하는 대신 X의 엔티티 추출을 사용하여 링크를 일치시킵니다. 엔티티의 JSON 속성에 대한 자세한 내용은 X 엔티티를 참조하십시오.
entities.urls
has:mediaPowerTrack

Search
사용 가능한 별칭: has:media_link

하나 이상의 분류된 미디어 URL을 포함하는 게시물과 일치합니다.

독립 연산자로 사용할 수 없습니다.
entities.media
has:mentionsPowerTrack

Search
다른 X 사용자를 멘션하는 게시물과 일치합니다.

독립 연산자로 사용할 수 없습니다.
entities.user_mentions
has:profile_geoPowerTrack

Search
사용 가능한 별칭: has:derived_user_geo

실제 값에 관계없이 프로필 지오 메타데이터를 포함하는 게시물과 일치합니다.

독립 연산자로 사용할 수 없습니다.
user.location
has:symbolsPowerTrack

Enterprise
캐시태그 기호(예: $TWTR)를 포함하는 게시물과 일치합니다.

독립 연산자로 사용할 수 없습니다.
entities.symbols
has:videosPowerTrack

Search
사용 가능한 별칭: has:video_link

하나 이상의 분류된 미디어 URL을 포함하는 게시물과 일치합니다.

독립 연산자로 사용할 수 없습니다.
entities.media
in_reply_to_status_id:PowerTrack사용 가능한 별칭: in_reply_to_tweet_id:

지정된 게시물에 대한 명시적 답글만 전달합니다.
id, id_str of the target Post
is:quotePowerTrack규칙과 일치하는 명시적 인용 트윗을 전달합니다.

부정(-is:quote)하여 규칙과 일치하는 인용 트윗을 전달에서 제외할 수도 있습니다.

독립 연산자로 사용할 수 없습니다.
is_quote_status (if true)
is:replyPowerTrack

Search
규칙과 일치하는 답글만 전달합니다.

부정(-is:reply)하여 지정된 규칙과 일치하는 답글의 전달을 제외할 수도 있습니다.

PowerTrack에서 이 연산자는 다음과 일치합니다:

_ 원본 게시물에 대한 답글
_ 인용된 게시물의 답글
* 리트윗의 답글


Search API와 함께 사용할 경우 이 연산자는 원본 게시물에 대한 답글과 일치하지만 인용 트윗의 답글과 리트윗의 답글은 제외합니다.

이 연산자를 is:retweetis:quote와 함께 사용하여 원본 게시물에 대한 답글만 전달할 수 있습니다.

Search API에서는 독립 연산자로 사용할 수 없습니다.

참고: Premium의 경우 이 연산자는 Sandbox 개발 환경에서 사용할 수 없습니다.
Reply elements, e.g. in_reply_to_status_id
is:retweetPowerTrack

Search
규칙과 일치하는 명시적 리트윗만 전달합니다.

부정(-is:retweet)하여 규칙과 일치하는 리트윗을 전달에서 제외하고 원본 콘텐츠만 전달할 수도 있습니다.

이 연산자는 진정한 리트윗(즉, 리트윗 버튼을 사용하여 게시된 리트윗)만 찾습니다. X의 리트윗 기능을 사용하지 않는 인용 트윗 및 수정된 게시물은 이 연산자와 일치하지 않습니다.

독립 연산자로 사용할 수 없습니다.
Retweet elements, e.g. retweeted_status
is:verifiedPowerTrack

Search
작성자가 X에서 인증된 게시물만 전달합니다.

부정하여 작성자가 인증된 게시물을 제외할 수도 있습니다.

독립 연산자로 사용할 수 없습니다.
user.verified
keywordPowerTrack

Search
게시물 본문 내의 키워드와 일치합니다.

이것은 토큰화된 일치로, 키워드 문자열이 게시물 본문의 토큰화된 텍스트와 비교됩니다. 토큰화는 구두점, 기호/이모지 및 구분 기호 유니코드 기본 평면 문자를 기반으로 합니다. 예를 들어, “I like coca-cola”라는 텍스트가 있는 게시물은 다음 토큰으로 분할됩니다: I, like, coca, cola. 그런 다음 이러한 토큰이 규칙에 사용된 키워드 문자열과 비교됩니다. 구두점(예: coca-cola), 기호 또는 구분 기호 문자를 포함하는 문자열을 일치시키려면 정확한 구문 일치 연산자를 사용해야 합니다.
text
lang:PowerTrack

Search
X에서 특정 언어로 분류된 게시물과 일치합니다(게시물이 분류된 경우에만 해당). 각 게시물은 하나의 언어로만 분류되므로 여러 언어를 AND 연산으로 결합하면 결과가 반환되지 않습니다.

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

이 연산자는 지원되는 언어에 대해서만 일치합니다. 다른 값(und 포함)을 제공하면 연산자가 무시됩니다(즉, 이 연산자로 게시물이 필터링되지 않습니다). 아래 목록은 현재 지원되는 언어와 해당 BCP 47 언어 식별자를 나타냅니다:

am 암하라어

hu 헝가리어

pt 포르투갈어

ar 아랍어

is 아이슬란드어

ro 루마니아어

hy 아르메니아어

in 인도네시아어

ru 러시아어

bn 벵골어

it 이탈리아어

sr 세르비아어

bg 불가리아어

ja 일본어

sd 신디어

my 버마어

kn 칸나다어

si 싱할라어

zh 중국어

km 크메르어

sk 슬로바키아어

cs 체코어

ko 한국어

sl 슬로베니아어

da 덴마크어

lo 라오어

ckb 소라니 쿠르드어

nl 네덜란드어

lv 라트비아어

es 스페인어

en 영어

lt 리투아니아어

sv 스웨덴어

et 에스토니아어

ml 말라얄람어

tl 타갈로그어

fi 핀란드어

dv 몰디브어

ta 타밀어

fr 프랑스어

mr 마라티어

te 텔루구어

ka 조지아어

ne 네팔어

th 태국어

de 독일어

no 노르웨이어

bo 티베트어

el 그리스어

or 오리야어

tr 터키어

gu 구자라트어

pa 펀자브어

uk 우크라이나어

ht 아이티어

ps 파슈토어

ur 우르두어

iw 히브리어

fa 페르시아어

ug 위구르어

hi 힌디어

pl 폴란드어

vi 베트남어

cy 웨일스어
lang (값이 und가 아닌 경우)
listed_count:PowerTrack사용 가능한 별칭: user_in_lists_count:

작성자가 X에서 목록에 추가된 횟수가 지정된 범위 내에 있는 게시물과 일치합니다.

_ 단일 숫자(예: listed_count:42)는 지정된 값 이상의 모든 숫자와 일치합니다.
_ 범위(예: listed_count:42..1337)는 지정된 범위 내의 모든 숫자와 일치합니다.
user.listed_count
place_country:PowerTrack

Search
태그된 장소/위치와 연결된 국가 코드가 지정된 ISO alpha-2 문자 코드와 일치하는 게시물을 매칭합니다.

참고: 장소(게시물 지리 정보)를 매칭하는 연산자는 원본 게시물의 일치 항목만 포함합니다. 리트윗에는 장소 데이터가 포함되지 않습니다.
place (원본 게시물만 해당)
place:PowerTrack

Search
지정된 위치 또는 X 장소 ID로 태그된 게시물과 일치합니다. 여러 단어로 구성된 장소 이름은 따옴표로 묶어야 합니다(예: place:"San Francisco").

참고: 장소(게시물 지리 정보)를 매칭하는 연산자는 원본 게시물의 일치 항목만 포함합니다. 리트윗에는 장소 데이터가 포함되지 않습니다.
place (원본 게시물만 해당)
point_radius:PowerTrack

Search
참고: 장소(게시물 지리 정보)를 매칭하는 연산자는 원본 게시물의 일치 항목만 포함합니다. 리트윗에는 장소 데이터가 포함되지 않습니다.place (원본 게시물만 해당)
profile_bounding_box:[west_long south_lat east_long north_lat]PowerTrack프로필 지리 정보 보강에서 사용자의 정확한 위치(경도, 위도)와 일치하며, 장소가 정의된 영역 내에 완전히 포함되어 있습니다.

_ west_long south_lat는 경계 상자의 남서쪽 모서리를 나타내며, west-long은 해당 지점의 경도이고 south_lat는 위도입니다.
_ east_long과 north_lat는 경계 상자의 북동쪽 모서리를 나타내며, east_long은 해당 지점의 경도이고 north_lat는 위도입니다.
_ 경계 상자의 너비와 높이는 25마일 미만이어야 합니다.
_ 경도는 ±180 범위입니다.
_ 위도는 ±90 범위입니다.
_ 모든 좌표는 십진법 도 단위입니다.
* 규칙 인수는 대괄호 안에 공백으로 구분되어 포함됩니다.

참고: 장소(게시물 지리 정보)를 매칭하는 연산자는 원본 게시물의 일치 항목만 포함합니다. 리트윗에는 장소 데이터가 포함되지 않습니다.
user.derived.locations.geo.coordinates
profile_country:PowerTrack

Search
프로필 지리 정보 보강의 국가 코드와 정확히 일치합니다.

ISO-3166-1-alpha-2 사양을 기반으로 정규화된 두 글자 국가 코드 세트를 사용합니다.

간결성을 위해 이 연산자는 주소 객체의 국가 필드에 대한 연산자 대신 제공됩니다.

참고: 장소(게시물 지리 정보)를 매칭하는 연산자는 원본 게시물의 일치 항목만 포함합니다. 리트윗에는 장소 데이터가 포함되지 않습니다.
user.derived.locations.country_code
profile_locality:PowerTrack

Search
프로필 지리 정보 보강의 지역 필드와 정확히 일치합니다.

이것은 정확한 전체 문자열 일치입니다.

백슬래시로 문자를 이스케이프할 필요가 없습니다. 예를 들어 슬래시가 포함된 항목과 일치시키려면 one/two를 사용하십시오.

공백이나 구두점이 포함된 부분 문자열과 일치시키려면 큰따옴표를 사용하십시오(예: profile_locality:"Lower East Side").
user.derived.locations.locality
profile_point_radius:[lon lat radius]PowerTrack사용자의 프로필 지리 정보 보강의 정확한 위치(x,y)와 일치합니다.

_ 지원되는 반경 단위는 마일(mi)과 킬로미터(km)입니다.
_ 반경은 25마일 미만이어야 합니다.
_ 경도는 ±180 범위입니다.
_ 위도는 ±90 범위입니다.
_ 모든 좌표는 십진법 도 단위입니다.
_ 규칙 인수는 대괄호 안에 공백으로 구분되어 포함됩니다.

참고: 장소(게시물 지리 정보)를 매칭하는 연산자는 원본 게시물의 일치 항목만 포함합니다. 리트윗에는 장소 데이터가 포함되지 않습니다.
user.derived.locations.geo
profile_region:PowerTrack

Search
프로필 지역 보강의 Region 필드와 정확히 일치합니다.

전체 문자열 정확 일치입니다.

백슬래시로 문자를 이스케이프할 필요가 없습니다. 예를 들어 슬래시가 포함된 항목과 일치시키려면 one/two를 사용하십시오.

공백이나 구두점이 포함된 부분 문자열과 일치시키려면 큰따옴표를 사용하십시오(예: profile_locality:"New York").
user.derived.locations.region
profile_subregion:PowerTrack프로필 지역 보강의 Subregion 필드와 정확히 일치합니다.

전체 문자열 정확 일치입니다.

백슬래시로 문자를 이스케이프할 필요가 없습니다. 예를 들어 슬래시가 포함된 항목과 일치시키려면 one/two를 사용하십시오.

공백이나 구두점이 포함된 부분 문자열과 일치시키려면 큰따옴표를 사용하십시오(예: profile_locality:"Kings County").
user.derived.locations.sub_region
”keyword1 keyword2”~NPowerTrack

Search
일반적으로 근접 연산자라고 하며, 키워드가 서로 N개 이하의 토큰 거리에 있는 게시물과 일치합니다.

키워드가 반대 순서로 있는 경우 서로 N-2개 이하의 토큰 거리에 있어야 합니다.

따옴표 안에 임의의 개수의 키워드를 포함할 수 있습니다.

N은 6보다 클 수 없습니다.
text
retweets_of_status_id:PowerTrack사용 가능한 별칭: retweets_of_tweet_id:

지정된 원본 게시물의 명시적 리트윗만 전달합니다.
retweeted_status.id, retweeted_status.id_str
retweets_of:PowerTrack

Search
사용 가능한 별칭: retweets_of_user:

지정된 사용자의 리트윗인 모든 게시물과 일치합니다. 값은 사용자 이름(@ 문자 제외) 또는 사용자의 숫자 ID일 수 있습니다(예: GET users/lookup 엔드포인트를 통해 얻을 수 있음).
retweeted_status.id (if present)
sample:PowerTrack전체 게시물 집합이 아닌 규칙과 일치하는 게시물의 무작위 백분율 샘플을 반환합니다. 백분율 값은 1에서 100 사이의 정수로 표현되어야 합니다.

이 연산자는 전체 규칙에 적용되며 모든 OR 연결된 용어를 그룹화해야 합니다.

참고: sample 연산자는 먼저 파이어호스의 범위를 X%로 줄인 다음 해당 샘플링된 하위 집합에 규칙/필터를 적용합니다. 예를 들어 sample:10을 사용하는 경우 각 게시물은 샘플에 포함될 확률이 10%입니다.

참고: 샘플링은 결정론적이며, 실시간으로 얻는 데이터 샘플은 과거 데이터를 가져올 때와 동일합니다.
source:PowerTrack지정된 소스 애플리케이션에서 생성된 모든 게시물과 일치합니다. 값은 애플리케이션의 이름 또는 애플리케이션의 URL이어야 합니다.

독립 실행형 연산자로 사용할 수 없습니다.
source
statuses_count:PowerTrack사용 가능한 별칭: tweets_count:

작성자가 지정된 범위 내에 속하는 수의 상태를 게시한 경우 게시물과 일치합니다.

_ 단일 숫자(예: statuses_count:42)는 지정된 값보다 크거나 같은 모든 숫자와 일치합니다.
_ 범위(예: statuses_count:42..1337)는 지정된 범위 내의 모든 숫자와 일치합니다.
user``.statuses_count
to:PowerTrack

Search
특정 사용자에 대한 답글인 모든 게시물과 일치합니다. 값은 사용자 이름(@ 문자 제외) 또는 사용자의 숫자 ID일 수 있습니다(예: GET users/lookup 엔드포인트를 통해 얻을 수 있음).text
url:PowerTrack

Search
게시물의 확장된 URL에 대해 토큰화된 일치를 수행합니다. 구두점이나 특수 문자가 포함된 토큰과 구문은 큰따옴표로 묶어야 합니다(예: url:"/developer").

일반적으로 권장되지는 않지만, 연산자는 큰따옴표로 묶인 특정 프로토콜과도 일치할 수 있습니다(예: url:"https://developer.x.com").
entities.urls.expanded_url
url_contains:PowerTrack(새로운) 확장된 URL 제목 메타데이터 보강에 대해 키워드/구문 일치를 수행합니다.entities.urls.expanded_url
url_description:PowerTrack사용 가능한 별칭: within_url_description:

(새로운) 확장된 페이지 설명 메타데이터 보강에 대해 키워드/구문 일치를 수행합니다.
entities.urls.unwound.description
url_title:PowerTrack사용 가능한 별칭: within_url_title:

(새로운) 확장된 URL 제목 메타데이터 보강에 대해 키워드/구문 일치를 수행합니다.
entities.urls.title