igorbrigadir/twitter-advanced-searchComprehensive reference guide to Twitter advanced search operators for precise social media data gathering, including filters for content, users, geo, time, engagement, and media.
These operators work on Web, Mobile, Tweetdeck.
There is some overlap, but largely these will not work for v1.1 Search, Premium Search, or v2 Search APIs.
Adapted from TweetDeck Help, @lucahammer Guide, @eevee Twitter Manual, @pushshift and Twitter / Tweetdeck itself. Contributions / tests, examples welcome!
| Class | Operator | Finds Tweets… | Eg: |
|---|---|---|---|
| Tweet content | nasa esa (nasa esa) | Containing both "nasa" and "esa". Spaces are implicit AND. Brackets can be used to group individual words if using other operators. | 🔗 |
nasa OR esa | Either "nasa" or "esa". OR must be in uppercase. | 🔗 | |
"state of the art" | The complete phrase "state of the art". Will also match "state-of-the-art". Also use quotes to prevent spelling correction. | 🔗 | |
"this is the * time this week" | A complete phrase with a wildcard. * does not work outside of a quoted phrase or without spaces. | 🔗 | |
+radiooooo | Force a term to be included as-is. Useful to prevent spelling correction. | 🔗 | |
-love -"live laugh love" | - is used for excluding "love". Also applies to quoted phrases and other operators. | 🔗 | |
#tgif | A hashtag | 🔗 | |
$TWTR | A cashtag, like hashtags but for stock symbols | 🔗 | |
What ? | Question marks are matched | 🔗 | |
:) OR :( | Some emoticons are matched, positive :) :-) :P :D or negative :-( :( | 🔗 | |
| 👀 | Emoji searches are also matched. Usually needs another operator to work. | 🔗 | |
url:google.com | urls are tokenized and matched, works very well for subdomains and domains, not so well for long urls, depends on url. Youtube ids work well. Works for both shortened and canonical urls, eg: gu.com shortener for theguardian.com. When searching for Domains with hyphens in it, you have to replace the hyphen by an underscore (like url:t_mobile.com) but underscores _ are also tokenized out, and may not match | 🔗 | |
lang:en | Search for tweets in specified language, not always accurate, see the full list and special lang codes below. | 🔗 | |
| Users | from:user | Sent by a particular @username e.g. "dogs from:NASA" | 🔗 |
to:user | Replying to a particular @username | 🔗 | |
@user | Mentioning a particular @username. Combine with -from:username to get only mentions | 🔗 | |
list:715919216927322112 list:esa/astronauts | Tweets from members of this public list. Use the list ID from the API or with urls like twitter.com/i/lists/715919216927322112. List slug is for old list urls like twitter.com/esa/lists/astronauts. Cannot be negated, so you can't search for "not on list". | 🔗 | |
filter:verified | From verified users | 🔗 | |
filter:blue_verified | From "verified" users that paid $8 for Twitter Blue | 🔗 | |
filter:follows | Only from accounts you follow. Cannot be negated. | 🔗 | |
filter:social filter:trusted | Only from algorithmically expanded network of accounts based your own follows and activities. Works on "Top" results not "Latest" | 🔗 | |
| Geo | near:city | Geotagged in this place. Also supports Phrases, eg: near:"The Hague" | 🔗 |
near:me | Near where twitter thinks you are | 🔗 | |
within:radius | Within specific radius of the "near" operator, to apply a limit. Can use km or mi. e.g. fire near:san-francisco within:10km | 🔗 | |
geocode:lat,long,radius | E.g., to get tweets 10km around twitters hq, use geocode:37.7764685,-122.4172004,10km | 🔗 | |
place:96683cc9126741d1 | Search tweets by Place Object ID eg: USA Place ID is 96683cc9126741d1 | 🔗 | |
| Time | since:2021-12-31 | On or after (inclusive) a specified date. 4 digit year, 2 digit month, 2 digit day separated by - a dash. | 🔗 |
