Powerstream Operators

This page provides a complete list of operators available when building rules for. Reference for the X API v2 standard tier covering powerstream.

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

---

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

---

Next steps

Powerstream introduction

Get started with Powerstream

Handling disconnections

Handle streaming disconnections

Recovery and redundancy

Recover missed data