All enterprise operators are available with PowerTrack and Historical PowerTrack APIs. However, only a subset of operators are available to the enterprise Search APIs, as noted on this page.
The dark blue tags note which operators are available to different enterprise products:
PowerTrack Search
Operator | Product | Description | Matches on payload element |
---|---|---|---|
"exact phrase match" | PowerTrack Search
|
Matches an exact phrase within the body of a Post. Components that can translate into a search operators will be treated as words. In other words:
Note: in 30 Day Search and Full Archive Search (Enterprise and Premium), punctuation is not tokenized and is instead treated as whitespace. |
text |
@ | PowerTrack Search
|
Matches any Post that mentions the given username. The value can be either the username (excluding the @ character) or the user’s numeric ID or (obtained for example via the GET users/lookup endpoint). |
entities.user_mentions |
# | PowerTrack Search
|
Matches any Post with the given hashtag. This operator performs an exact match. For example meaning the rule Note: this operator relies on X's entity extraction to match hashtags, rather than extracting the hashtag from the body itself. For more details on JSON attributes from entities, refer to X Entities. |
entities.hashtags |
$ | PowerTrack Search |
Matches any Post that contains the specified cashtag (where the leading character of the token is Note: this operator relies on X's entity extraction to match links, rather than extracting the link from the body itself. For more details on JSON attributes from entities, refer to X Entities. |
|
bio: | PowerTrack |
Available alias: user_bio: Matches a keyword (using tokenized match) or a phrase within the user bio of a Post. Use double quotes to match a phrase. In other words:
|
user .description |
bio_location: | PowerTrack |
Available alias: user_bio_location: Matches Posts where the User object's location contains the specified keyword (using tokenized match) or phrase. This location is a non-normalized, user-generated, free-form string, and is different from a Post's location (when available).
|
user.location |
bio_name: | PowerTrack |
Matches Posts where the User object's name contains the specified keyword (using tokenized match) or phrase. | user.name |
bounding_box: | PowerTrack Search
|
Available alias: geo_bounding_box: Matches against the exact location (long, lat) of the Post (when present), and against a geo polygon (where the Place is fully contained within the defined region).
Note: operators matching on place (Post geo) will only include matches from original Posts. Retweets do not contain any place data. |
place (original Posts only) |
contains: | PowerTrack |
Substring match for Posts that have the given substring in the body, regardless of tokenization. In other words, this does a pure substring match and does not consider word boundaries. Use double quotes to match substrings that contain whitespace or punctuation. |
text |
<emoji> | PowerTrack Search
|
Matches an emoji within the body of a Post. This is a tokenized match, so your emoji will be matched against the tokenized text of the Post body. Tokenization is based on punctuation, symbol/emoji, and separator Unicode basic plane characters. For example, a Post with the text “I like 🍕” would be split into the following tokens: I, like, 🍕. These tokens would then be compared to the emoji used in your rule. Note: if an emoji has a variant, you must use double quotes to add to a rule. |
text |
followers_count: | PowerTrack |
Matches Posts when the author has a followers count within the given range.
|
user.followers_count |
friends_count: | PowerTrack |
Available alias: following_count: Matches Posts when the author has a friends count (the number of users they follow) that falls within the given range.
|
user.friends_count |
from: | PowerTrack Search
|
Matches any Post from a specific user. The value can be either the username (excluding the |
|
has:geo | PowerTrack Search
|
Matches Posts that have Post-specific geolocation data provided from X. This can be either “geo” lat-long coordinate, or a “location” in the form of a X Place, with the corresponding display name, geo polygon, and other fields. Cannot be used as a standalone operator. Note: operators matching on place (Post geo) will only include matches from original posts. Retweets do not contain any place data. |
place (original Tweets only) |
has:hashtags | PowerTrack Search
|
Matches Posts that contain at least one hashtag. Cannot be used as a standalone operator. |
entities.hashtags |
has:images | PowerTrack Search
|
Matches Posts that contain at least one classified image URL. Cannot be used as a standalone operator. |
entities.media |
has:lang | PowerTrack |
Matches Posts that have been classified by X as being of a particular language. If a Post has not been classified, the operator will not match. Each Post is currently only classified as being of one language, so AND’ing together multiple languages will yield no results. Cannot be used as a standalone operator. |
lang when value is not und |
has:links | PowerTrack Search
|
This operator matches Posts which contain links in the Post body. Cannot be used as a standalone operator. Note: this operator relies on X's entity extraction to match links, rather than extracting the link from the body itself. For more details on JSON attributes from entities, refer to X Entities. |
entities.urls |
has:media | PowerTrack Search
|
Available alias: has:media_link Matches Posts that contain at least one classified media URL. Cannot be used as a standalone operator. |
entities.media |
has:mentions | PowerTrack Search
|
Matches Posts that mention another X user. Cannot be used as a standalone operator. |
entities.user_mentions |
has:profile_geo | PowerTrack Search
|
Available alias: has:derived_user_geo Matches Posts that have any Profile Geo metadata, regardless of the actual value. Cannot be used as a standalone operator. |
user.location |
has:symbols | PowerTrack Enterprise |
Matches Posts that contain a cashtag symbol (e.g. Cannot be used as a standalone operator. |
entities.symbols |
has:videos | PowerTrack Search
|
Available alias: has:video_link Matches Posts that contain at least one classified media URL. Cannot be used as a standalone operator. |
entities.media |
in_reply_to_status_id: | PowerTrack |
Available alias: in_reply_to_tweet_id: Deliver only explicit replies to the specified Post. |
id , id_str of the target Post |
is:quote | PowerTrack |
Deliver explicit Quote Tweets that match a rule. It can also be negated ( Cannot be used as a standalone operator. |
is_quote_status (if true ) |
is:reply | PowerTrack Search
|
Deliver only replies that match a rule. It can also be negated ( With PowerTrack, this operator matches on:
You can use this operators in conjunction with Cannot be used as a standalone operator with the Search API. Note: with Premium, this operator is not available in Sandbox dev environments. |
Reply elements, e.g. in_reply_to_status_id |
is:retweet | PowerTrack Search
|
Deliver only explicit Retweets that match a rule. It can also be negated ( This operator looks only for true Retweets (i.e. Retweets posted using the Retweet button). Quoted Tweets and modified Posts which do not use X's Retweet functionality will not be matched by this operator. Cannot be used as a standalone operator. |
Retweet elements, e.g. retweeted_status |
is:verified | PowerTrack Search
|
Deliver only Posts where the author is verified by X. It can also be negated to exclude Posts where the author is verified. Cannot be used as a standalone operator. |
user.verified |
keyword | PowerTrack Search
|
Matches a keyword within the body of a Post. This is a tokenized match, meaning that your keyword string will be matched against the tokenized text of the Post body. Tokenization is based on punctuation, symbol/emoji, and separator Unicode basic plane characters. For example, a Post with the text “I like coca-cola” would be split into the following tokens: |
text |
lang: | PowerTrack Search
|
Matches Posts that have been classified by X as being of a particular language (if, and only if, the post has been classified). Each Post will be classified with only one language, so AND’ing together multiple languages will yield no results. Note: if no language classification can be made the provided result is This operator will only match against supported languages. Providing any other value (including
|
lang when value is not und |
listed_count: | PowerTrack |
Available alias: user_in_lists_count:
Matches Posts when the author has been listed on X a number of times falls within the given range.
|
user.listed_count |
place_country: | PowerTrack Search
|
Matches Posts where the country code associated with a tagged place/location matches the given ISO alpha-2 character code. Note: operators matching on place (Post geo) will only include matches from original Posts. Retweets do not contain any place data. |
place (original Posts only) |
place: | PowerTrack Search
|
Matches Posts tagged with specified location or X place ID. Multi-word place names should be enclosed in quotes (e.g. Note: operators matching on place (Post geo) will only include matches from original posts. Retweets do not contain any place data. |
place (original Posts only) |
point_radius: | PowerTrack Search
|
Note: operators matching on place (Post geo) will only include matches from original posts. Retweets do not contain any place data. | place (original posts only) |
profile_bounding_box:[west_long south_lat east_long north_lat] | PowerTrack |
Matches against the user's exact Location (long, lat) in the Profile Geo enrichment where the Place is fully contained within the defined region.
Note: operators matching on place (Post geo) will only include matches from original posts. Retweets do not contain any place data. |
user.derived.locations.geo.coordinates |
profile_country: | PowerTrack Search
|
Exact match on the country code from the Profile Geo enrichment. Uses a normalized set of two-letter country codes, based on ISO-3166-1-alpha-2 specification. To be concise, this operator is provided in lieu of an operator for the country field from the address object. Note: operators matching on place (Post geo) will only include matches from original posts. Retweets do not contain any place data. |
user.derived.locations.country_code |
profile_locality: | PowerTrack Search
|
Exact match on the Locality field from the Profile Geo enrichment. This is an exact full string match. It is not necessary to escape characters with a backslash. For example, if matching something with a slash, use Use double quotes to match substrings that contain whitespace or punctuation, e.g.
|
user.derived.locations.locality |
profile_point_radius:[lon lat radius] | PowerTrack |
Matches against the Exact Location (x,y) of the user's Profile Geo enrichment.
Note: operators matching on place (Post geo) will only include matches from original posts. Retweets do not contain any place data. |
user.derived.locations.geo |
profile_region: | PowerTrack Search
|
Exact match on the Region field from the Profile Geo enrichment. This is an exact full string match. It is not necessary to escape characters with a backslash. For example, if matching something with a slash, use Use double quotes to match substrings that contain whitespace or punctuation, e.g. |
user.derived.locations.region |
profile_subregion: | PowerTrack |
Exact match on the Subregion field from the Profile Geo enrichment. This is an exact full string match. It is not necessary to escape characters with a backslash. For example, if matching something with a slash, use Use double quotes to match substrings that contain whitespace or punctuation, e.g. |
user.derived.locations.sub_region |
"keyword1 keyword2"~N | PowerTrack Search |
Commonly referred to as a proximity operator, this matches a Post where the keywords are no more than N tokens from each other. If the keywords are in the opposite order, they can not be more than N-2 tokens from each other. Can have any number of keywords in quotes. N cannot be greater than 6. |
text |
retweets_of_status_id: | PowerTrack |
Available alias: retweets_of_tweet_id: Deliver only explicit Retweets of the specified original Post. |
retweeted_status.id , retweeted_status.id_str |
retweets_of: | PowerTrack Search
|
Available alias: retweets_of_user: Matches any Post that are Retweets of the given user. The value can be either the username (excluding the |
retweeted_status.id (if present) |
sample: | PowerTrack |
Returns a random percent sample of Posts that match a rule rather than the entire set of Posts. The percent value must be represented by an integer between 1 and 100. This operator applies to the entire rule and requires all OR'd terms to be grouped. Note: the sample operator first reduces the scope of the firehose to X%, then the rule/filter is applied to that sampled subset. If you are using, for example, Note: the sampling is deterministic, and you will get the same data sample in realtime as you would if you pulled the data historically. |
|
source: | PowerTrack |
Matches any Post generated by the given source application. The value must be either the name of the application or the application’s URL. Cannot be used as a standalone operator. |
source |
statuses_count: | PowerTrack |
Available alias: tweets_count:
Matches Posts when the author has posted a number of statuses that falls within the given range.
|
user .statuses_count |
to: | PowerTrack Search
|
Matches any Post that is in reply to a particular user. The value can be either the username (excluding the @ character) or the user’s numeric ID or (obtained for example via the GET users/lookup endpoint). |
text |
url: | PowerTrack Search
|
Performs a tokenized match on the expanded URLs of a Post. Tokens and phrases containing punctuation or special characters should be double-quoted (e.g. While generally not recommended, the operator can also match on a specific protocol, enclosed in double-quotes (e.g. |
entities.urls.expanded_url |
url_contains: | PowerTrack |
Performs a keyword/phrase match on the (new) expanded URL title metadata enrichment. | entities.urls.expanded_url |
url_description: | PowerTrack |
Available alias: within_url_description: Performs a keyword/phrase match on the (new) expanded page description metadata enrichment. |
entities.urls.unwound.description |
url_title: | PowerTrack |
Available alias: within_url_title: Performs a keyword/phrase match on the (new) expanded URL title metadata enrichment. |
entities.urls.title |