Twitter releases new version of the Gnip PowerTrack rules and documentation


Unfortunately, our access to Premium real time and historical Twitter data ended 9/29/2018. Please contact Twitter for approval of future academic or commercial use cases. If you can get an approved premium or historical Twitter use case, we can still help you work with the data inside DiscoverText. DiscoverText remains open and is still the top-ranked text analysis platform on the Internet. You can use your own Twitter credentials to sample Twitter data via DiscoverText using the Twitter Search API.

Twitter has announced a new version of their PowerTrack rules that are used by researchers to search for tweets matching specific criteria. These new rules supersede the old Gnip rules.

The old Gnip rules documentation at is now obsolete, and this webpage will soon redirect you to the new Twitter-supported webpage. As a DiscoverText user, you should review and begin using the new documentation immediately for premium operators that are available via DiscoverText. The new documentation is available at:

PowerTrack Rules

Rules can have many parts and be up to 2048 characters in length. The rules are very specific, some of which are described in the following sections.

Frequently Used Operators

The most frequently used operators are:

Boolean OR

The Boolean OR operator in PowerTrack is the word OR in uppercase letters.

Example rule:

planet OR satellite


All tweets that contain the word planet or the word satellite. It also returns all tweets that contain both the word planet and the word satellite because the Boolean OR is evaluated as TRUE.


Boolean AND

The Boolean AND operator in PowerTrack is a space character between the two words that are being searched.

Example rule:

planet satellite


All tweets that contain both the word planet and the word satellite. Both words must exist in the tweet.


Boolean NOT

The Boolean NOT operator in PowerTrack is the minus sign.

Example rule:

planet -pluto


All tweets that contain the word planet but do not contain the word pluto.


Other Useful Documentation Links

Standard operators

Premium operators

Guide to using premium operators

Filter realtime tweets



Have more questions? Submit a request


Powered by Zendesk