keyword | 단항 | Core | 게시물 본문에 포함된 키워드를 매칭합니다. 이는 토큰화 기반 매치로, 사용자의 키워드 문자열이 게시물 본문의 토큰화된 텍스트와 비교된다는 의미입니다. 토큰화는 단어를 문장 부호, 기호, 그리고 유니코드 기본 평면 구분 문자를 기준으로 분리합니다. 예를 들어 텍스트가 “I like coca-cola”인 게시물은 다음 토큰으로 분리됩니다: I, like, coca, cola. 그런 다음 이 토큰들을 쿼리에서 사용한 키워드 문자열과 비교합니다. 문장 부호(예: coca-cola), 기호, 또는 구분 문자를 포함하는 문자열을 매칭하려면 키워드를 큰따옴표로 감싸야 합니다. 예: pepsi OR cola OR "coca cola" |
emoji | 단항 | Core | 게시물 본문에 포함된 이모지를 일치시킵니다. 키워드와 마찬가지로 이모지는 토큰화된 단위로 매치되며, 이는 사용한 이모지가 게시물 본문의 토큰화된 텍스트와 비교되어 일치 여부를 판단한다는 의미입니다. 이모지에 변형(variant)이 있는 경우 쿼리에 추가하려면 반드시 큰따옴표로 감싸야 합니다. 예: (😃 OR 😡) 😬 |
"exact phrase match" | 단항 | Core | 게시물 본문에서 정확한 구절을 검색합니다. 예시: ("X API" OR #v2) -"recent counts" |
# | 단항 | Core | 해시태그가 포스트 내에서 인식된 엔티티인 경우, 해당 해시태그를 포함하는 모든 포스트와 일치합니다. 이 연산자는 토큰화 기반 일치가 아닌 정확한 일치를 수행하므로, 규칙 #thanku는 해시태그 #thanku가 정확히 포함된 포스트와만 일치하고, #thankunext 해시태그가 포함된 포스트와는 일치하지 않습니다. 예: #thankunext #fanart OR @arianagrande |
@ | 단항 | Core | 지정한 사용자 이름을 언급하는 모든 게시물과 일치하며, 해당 사용자 이름이(@ 문자를 포함한) 인식된 엔티티인 경우에만 적용됩니다. 예: (@XDevelopers OR @API) -@X |
$ | 단항 | Advanced | 지정된 ‘캐시태그’를 포함하는 모든 게시물과 일치합니다(토큰의 첫 글자가 ‘’문자일때).캐시태그연산자는본문자체에서캐시태그를직접추출하려고시도하는대신,X의‘symbols’엔터티추출기능에의존해캐시태그를일치시킨다는점에유의하세요.예:‘twtr OR @XDevelopers -$fb` |
from: | 단항 | Core | 특정 사용자가 작성한 모든 게시물과 일치합니다. 값으로는 사용자 이름(@ 문자는 제외) 또는 사용자의 숫자형 user ID를 사용할 수 있습니다. 각 from: 연산자에는 하나의 사용자 이름/ID만 전달할 수 있습니다. 예시: from:XDevelopers OR from:API -from:X |
to: | 단항 | Core | 특정 사용자에게 보내는 답글인 모든 게시물을 일치시킵니다. 값은 사용자 이름(‘@’ 문자는 제외)이나 해당 사용자의 숫자형 ID가 될 수 있습니다. to: 연산자마다 하나의 사용자 이름/ID만 전달할 수 있습니다. 예시: to:XDevelopers OR to:API -to:X |
url: | 단항 | Core | 게시물의 올바르게 형식화된 모든 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" 및 from:XDevelopers url:"https://t.co". 구두점이나 특수 문자가 포함된 토큰이나 구는 큰따옴표로 감싸야 합니다. |
retweets_of: | 단항 | Core | 지정한 사용자의 게시물을 리포스트한 포스트와 일치합니다. 값은 사용자 이름(@ 문자 제외) 또는 사용자의 숫자형 사용자 ID 중 하나일 수 있습니다. retweets_of: 연산자당 하나의 사용자 이름 또는 ID만 전달할 수 있습니다. 예: retweets_of:XDevelopers OR retweets_of:API |
context: | 단항 | Core | 특정 도메인 id/엔터티 id 쌍이 있는 포스트를 매칭합니다. context: 연산자에는 하나의 도메인/엔터티만 지정할 수 있습니다. 예시: context:domain_id.entity_id. OR 연산자를 사용해 여러 도메인/엔터티를 결합할 수 있습니다: (context:47.113922 9372198469633 OR context:11.1088514520308342784) |
entity: | 단항 | Core | 특정 엔터티 문자열 값을 가진 포스트를 검색합니다. entity: 연산자는 하나만 사용할 수 있습니다. 예: entity:"string declaration of entity/place". 이 기능은 최근 검색 엔드포인트에서만 사용할 수 있습니다. |
conversation_id: | 단항 | Core | 같은 대화 ID를 가진 포스트를 매칭합니다. 대화 ID는 해당 대화를 시작한 게시물의 Post ID로 설정됩니다. 게시물에 답글이 달릴 때마다, 답글에 대한 답글까지 포함해 conversation_id가 해당 JSON 페이로드에 추가됩니다. 하나의 conversation_id: 연산자에는 하나의 대화 ID만 전달할 수 있습니다. 예시: conversation_id:1334987486343299072 (from:XDevelopers OR from:API) |
list: | 단항 | Advanced | 지정된 리스트에 포함된 사용자가 작성한 포스트와 일치하는 결과를 반환합니다. 예를 들어 @XDevelopers와 @API가 리스트 123의 멤버이고, 쿼리에 list:123을 포함했다면, 응답에는 해당 계정들이 게시한 포스트만 포함됩니다. 리스트 ID는 List 조회 엔드포인트를 사용해서 확인할 수 있습니다. 예시: list:123 |
place: | 단항 | Advanced | 지정한 위치 또는 X place ID가 태그된 포스트를 매칭합니다. 여러 단어로 된 장소 이름(“New York City”, “Palo Alto”)은 따옴표로 묶어야 합니다. place: 연산자마다 하나의 장소만 지정할 수 있습니다. 참고: X place ID를 얻는 방법은 GET geo/search standard v1.1 엔드포인트를 참조하세요. 예: place:"new york city" OR place:seattle OR place:fd70c22040963ac7 |
place_country: | 단항 | Advanced | 태그된 장소/위치에 연관된 국가 코드가 지정된 ISO 알파-2 두 글자 코드와 일치하는 포스트를 매칭합니다. 유효한 ISO 코드 목록은 위키백과에서 확인할 수 있습니다. place_country: 연산자마다 하나의 ISO 코드만 지정할 수 있습니다. 예: place_country:US OR place_country:MX OR place_country:CA |
point_radius: | 단항 | Advanced | 존재하는 경우 게시물의 place.geo.coordinates 객체와, X에서는 장소 지오 폴리곤과 매칭하며, 이때 장소 폴리곤은 지정된 영역 안에 완전히 포함되어 있어야 합니다. point_radius:[longitude latitude radius]. 지원되는 반지름 단위는 마일(mi)과 킬로미터(km)입니다. 반지름은 25mi 미만이어야 합니다. 경도는 ±180 범위입니다. 위도는 ±90 범위입니다. 모든 좌표는 십진수 도 단위를 사용합니다. 규칙 인수는 대괄호 안에 포함되며, 공백으로 구분됩니다. 예시: point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] |
bounding_box: | 단항 | Advanced | Post에 place.geo.coordinates 객체가 있을 경우 이를 기준으로 매칭하며, X에서는 장소 지오 폴리곤(place geo polygon)을 대상으로, 해당 장소 폴리곤이 정의된 영역 안에 완전히 포함되는 경우에 매칭합니다. bounding_box:[west_long south_lat east_long north_lat]. 바운딩 박스의 너비와 높이는 25mi 미만이어야 합니다. 경도(Longitude)는 ±180 범위여야 합니다. 위도(Latitude)는 ±90 범위여야 합니다. 모든 좌표는 십진 도(degree) 단위입니다. 규칙 인수는 대괄호로 둘러싸여 있으며, 공백으로 구분됩니다. 예시: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
is:retweet | AND 연산자 필수 | 기본 | 지정된 규칙의 나머지 조건과도 일치하는 Retweet을 매칭합니다. 이 연산자는 진짜 Retweet(예: Retweet 버튼을 사용해 생성된 Retweet)만을 대상으로 합니다. Quote Tweet은 이 연산자로 매칭되지 않습니다. 예시: data @XDevelopers -is:retweet |
is:reply | AND 연산자 필수 | 기본 | 규칙과 일치하는 명시적인 답글만 전달합니다. 또한 부정 형태로 사용하면, 쿼리와 일치하는 답글을 전달 대상에서 제외할 수 있습니다. 참고: 이 연산자는 filtered stream 엔드포인트에서도 사용할 수 있습니다. filtered stream과 함께 사용할 때, 이 연산자는 원본 게시물에 대한 답글, 인용 포스트에 대한 답글, 리트윗에 대한 답글과 일치합니다. 예시: from:XDevelopers is:reply |
is:quote | AND 연산자 필수 | 기본 | 댓글이 포함된 포스트로도 알려진 모든 Quote Tweet을 반환합니다. 예: "sentiment analysis" is:quote |
is:verified | AND 연산자 필수 | 기본 | 작성자가 X에서 인증된 포스트만 반환합니다. 예: #nowplaying is:verified |
-is :nullcast | AND 연산자 필수 | 고급 | ads.x.com에서 프로모션 목적으로만 생성되고 "source":"Twitter for Advertisers (legacy)" 또는 "source":"Twitter for Advertisers" 값을 가진 포스트를 제외합니다. 이 연산자는 반드시 부정형으로 사용해야 합니다. 널캐스트된 포스트에 대한 자세한 내용은 포스트 이용 가능 여부 페이지를 참조하세요. 예시: "mobile games" -is:nullcast |
has:hashtags | AND 연산자 필수 | 기본 | 하나 이상의 해시태그를 포함하는 포스트와 일치합니다. 예: from:XDevelopers -has:hashtags |
has:cashtags | AND 연산자 필수 | 고급 | 앞에 ‘’문자가붙은캐시태그기호(예:‘tag)를 포함하는 포스트와 일치합니다. 예시: #stonks has:cashtags` |
has:links | AND 연산자 필수 | 기본 | 이 연산자는 게시물 본문에 링크와 미디어가 포함된 포스트를 검색합니다. 예: from:XDevelopers announcement has:links |
has:mentions | AND 연산자 필수 | 기본 | 다른 X 사용자를 언급한 포스트와 일치합니다. 예: #nowplaying has:mentions |
has:media | AND 연산자 필수 | 기본 | X에서 사진, GIF, 동영상과 같은 미디어가 포함된 것으로 판단한 포스트와 일치합니다. Periscope에서 생성된 미디어나 다른 미디어 호스팅 사이트로 연결되는 링크가 포함된 포스트와는 일치하지 않습니다. 예시: (kittens OR puppies) has:media |
has:images | AND 연산자 필수 | 기본 | 이미지로 인식된 URL을 포함하는 포스트와 일치합니다. 예: #meme has:images |
has:videos | AND 연산자 필수 | 기본 | X에 직접 업로드된 네이티브 X 동영상이 포함된 포스트와 일치합니다. Periscope로 생성된 동영상이나 다른 동영상 호스팅 사이트 링크가 포함된 포스트에는 일치하지 않습니다. 예: #icebucketchallenge has:videos |
has:geo | AND 연산자 필수 | 고급 | X 사용자가 제공한, 포스트 전용 위치 정보(geolocation) 데이터를 가진 포스트와 일치합니다. 이는 X place 형태의 위치(해당 표시 이름, geo 폴리곤 및 기타 필드를 포함)일 수도 있고, 드문 경우에는 위도/경도 좌표(geo lat-long)일 수도 있습니다. 참고: place(포스트 geo)를 기준으로 매칭하는 연산자는 원본 포스트에서의 일치 항목만 포함합니다. 리트윗에는 place 데이터가 포함되지 않습니다. 예시: recommend #paris has:geo -bakery |
lang: | AND 연산자 필수 | 기본 | X에서 특정 언어로 분류한 포스트와 일치합니다(포스트가 분류된 경우에만 해당). 각 포스트는 현재 하나의 언어로만 분류되므로, 여러 언어를 AND 연산으로 함께 사용하면 결과가 나오지 않는다는 점에 유의해야 합니다. lang: 연산자마다 하나의 BCP 47 언어 식별자만 전달할 수 있습니다. 참고: 언어 분류를 할 수 없으면 제공되는 결과는 ‘und’(미정의, undefined)입니다. 예: recommend #paris lang:en |
