Powerstream Operators

This page provides a complete list of operators available when building rules for Powerstream.

Overview

Powerstream uses Boolean queries with operators to filter Posts based on keywords and metadata. Rules can be up to 2,048 characters and you can have up to 1,000 rules.

User operators

Operator	Summary	Example
`from:`	Matches posts from a specific user	`from:xdevelopers` or `from:123456`
`to:`	Matches posts directed to a specific user	`to:jvaleski`
`retweets_of:`	Matches reposts of a specific user	`retweets_of:xdevelopers`

Content operators

Operator	Summary	Example
`contains:`	Matches posts containing specific text/keywords	`contains:hello` or `contains:-2345.432`
`url_contains:`	Matches posts with URLs containing specific text	`url_contains:"com/willplayforfood"`
`lang:`	Matches posts in specific languages	`lang:en`

Entity operators

Operator	Summary	Example
`has:`	Matches posts containing specific entities	`has:images`, `has:geo`, `has:mentions`
`is:`	Matches posts of specific types or properties	`is:retweet`, `is:reply`

Available `has:` options

has:mentions — Posts that mention another user
has:geo — Posts with geolocation data
has:links — Posts containing links
has:media — Posts containing media
has:lang — Posts with detected language
has:symbols — Posts containing cashtags
has:images — Posts containing images
has:videos — Posts containing videos

Available `is:` options

is:retweet — Retweets
is:reply — Replies to other posts
is:edit — Edited versions of a post (any version after the first)

Filtering out edited posts

Each edit creates a new post with a new ID, and Powerstream delivers every version that matches your rules. Add -is:edit to a rule to receive only the first version of each post.

is:edit matches the later versions in an edit chain. The original post is never is:edit, so -is:edit still delivers it when it’s posted.
A negated operator applies only to the term next to it. cat OR dog -is:edit means cat OR (dog -is:edit). To exclude edits for every term, group them: (cat OR dog) -is:edit.
If a keyword appears only in the edited text, -is:edit delivers nothing for that post: the original doesn’t match, and the edit is excluded.
Reposts, quotes, and replies of an edited post aren’t edits themselves, so -is:edit doesn’t exclude them.

To identify edits in the posts you receive instead of filtering them out, see Edited posts.

Location operators

Operator	Summary	Example
`place:`	Matches posts from specific places/locations	`place:"Belmont Central"` or `place:02763fa2a7611cf3`
`bounding_box:`	Matches posts within a geographic bounding box	`bounding_box:[-112.424083 42.355283 -112.409111 42.792311]`
`point_radius:`	Matches posts within a radius of a point	`point_radius:[-111.464973 46.371179 25mi]` or `point_radius:[-111.464973 46.371179 15km]`

User profile operators

Operator	Summary	Example
`bio:`	Matches posts from users with specific bio content	`bio:"data scientist"`
`bio_name:`	Matches posts from users with specific name in bio	`bio_name:PhD`

Post reference operators

Operator	Summary	Example
`retweets_of_status_id:`	Matches reposts of specific posts	`retweets_of_status_id:1234567890123456789`
`in_reply_to_status_id:`	Matches replies to specific posts	`in_reply_to_status_id:1234567890123456789`

Special syntax operators

Operator	Summary	Example
`@`	Mention operator	`@username`
`"phrase"`	Matches exact phrases	`"exact phrase"`

Logical operators

Operator	Summary	Example
`OR`	Logical OR between expressions	`x OR facebook`
Space/AND	Logical AND between expressions	`x facebook` (both terms must be present)
`()`	Grouping for complex expressions	`(x OR facebook) iphone`
`-`	Negation/exclusion	`x -facebook` (x but not facebook)

Building rules

Basic examples

# Match posts from a specific user

from:xdevelopers

# Match posts containing keywords

contains:API contains:developer

# Match posts with images in English

has:images lang:en

Combining operators

# Posts from @xdevelopers OR @api that aren't retweets

(from:xdevelopers OR from:api) -is:retweet

# Posts mentioning AI with images, excluding retweets

contains:AI has:images -is:retweet lang:en

# Posts within 25 miles of a location

point_radius:[-73.935242 40.730610 25mi] lang:en

# Posts about cats or dogs, first versions only (no edits)

(cat OR dog) lang:en -is:edit

Next steps

Powerstream introduction

Get started with Powerstream

Handling disconnections

Handle streaming disconnections

Recovery and redundancy

Recover missed data

Analytics

Blocks

Volume Streams

Likes Streams

Powerstream

Account Activity

Filtered Stream Webhooks

Powerstream Operators

Overview

User operators

Content operators

Entity operators

Available `has:` options

Available `is:` options

Filtering out edited posts

Location operators

User profile operators

Post reference operators

Special syntax operators

Logical operators

Building rules

Basic examples

Combining operators

Next steps

Powerstream introduction

Handling disconnections

Recovery and redundancy

​Overview

​User operators

​Content operators

​Entity operators

​Available has: options

​Available is: options

​Filtering out edited posts

​Location operators

​User profile operators

​Post reference operators

​Special syntax operators

​Logical operators

​Building rules

​Basic examples

​Combining operators

​Next steps

Powerstream introduction

Handling disconnections

Recovery and redundancy

Overview

User operators

Content operators

Entity operators

Available `has:` options

Available `is:` options

Filtering out edited posts

Location operators

User profile operators

Post reference operators

Special syntax operators

Logical operators

Building rules

Basic examples

Combining operators

Next steps