# The Complete Guide to Twitter (X) Search Operators > **Note**: This is a comprehensive reference of Twitter search operators. Some operators may not work exactly as documented due to Twitter's ever-changing backend. Use at your own risk. ## Table of contents ## 1. Tweet Content Operators | **Operator / Syntax** | **Meaning** | **Usage / Notes** | **Example** | |----------------------|-------------|-------------------|-------------| | `word1 word2` | All given words (implicit AND) | - All words must appear (any order)
- Spaces = AND
- Group with parentheses | [space nasa esa](https://twitter.com/search?q=space%20nasa%20esa) | | `word1 OR word2` | Either word1 or word2 | - "OR" must be uppercase
- Use parentheses for complex logic | [(puppy OR kitten) AND (cute OR sweet)](https://twitter.com/search?q=(puppy%20OR%20kitten)%20AND%20(cute%20OR%20sweet)) | | `"exact phrase"` | Match exact phrase | - Includes punctuation
- Prevents spelling correction | ["state of the art"](https://twitter.com/search?q=%22state%20of%20the%20art%22) | | `+word` | Force exact word match | - Disables spelling correction | [+radiooooo](https://twitter.com/search?q=%2Bradiooooo) | | `-word` / `-"exact phrase"` | Exclude words/phrases | - Use before word/phrase to exclude | [cats -dogs](https://twitter.com/search?q=cats%20-dogs) | | `#hashtag` | Match tweets with hashtag | - Treated as text token | [#tgif](https://twitter.com/search?q=%23tgif) | | `$cashtag` | Match stock symbol | - Like hashtags but with $ | [$AAPL](https://twitter.com/search?q=%24AAPL) | | `:) OR :(` | Match emoticons | - Some basic emoticons recognized | [flight :(](https://twitter.com/search?q=flight%20%3A() | | `👀` (emoji) | Match emoji | - Best combined with text | [👀 NASA](https://twitter.com/search?q=%F0%9F%91%80%20NASA) | | `url:keyword` | URLs containing keyword | - Works with expanded/shortened links
- Replace hyphens with underscores | [url:youtube.com](https://twitter.com/search?q=url%3Ayoutube.com) | | `lang:xx` | Tweets in language | - Uses 2-letter ISO code | [dogs lang:es](https://twitter.com/search?q=dogs%20lang%3Aes) | ## 2. User Operators | **Operator / Syntax** | **Meaning** | **Usage / Notes** | **Example** | |----------------------|-------------|-------------------|-------------| | `from:username` | Tweets by user | - No @ needed
- Combine with keywords | [from:NASA](https://twitter.com/search?q=from%3ANASA) | | `to:username` | Replies to user | - Direct replies only | [to:NASA](https://twitter.com/search?q=to%3ANASA) | | `@username` | Mentions of user | - Use -from:user to exclude their tweets | [@NASA -from:NASA](https://twitter.com/search?q=%40NASA%20-from%3ANASA) | | `list:user/list-slug` | Tweets from list members | - Use list ID or slug | [list:twitter/twitter-official](https://twitter.com/search?q=list%3Atwitter%2Ftwitter-official) | | `filter:verified` | Verified accounts only | - Definition varies by Twitter | [news filter:verified](https://twitter.com/search?q=news%20filter%3Averified) | | `filter:follows` | From followed accounts | - Only works for your account | [important filter:follows](https://twitter.com/search?q=important%20filter%3Afollows) | | `filter:social` / `filter:trusted` | From trusted network | - Based on engagement patterns | [breaking filter:trusted](https://twitter.com/search?q=breaking%20filter%3Atrusted) | ## 3. Geo Operators | **Operator / Syntax** | **Meaning** | **Usage / Notes** | **Example** | |----------------------|-------------|-------------------|-------------| | `near:"city or place"` | Near location | - Use quotes for multi-word places | [coffee near:"new york"](https://twitter.com/search?q=coffee%20near%3A%22new%20york%22) | | `near:me` | Near your location | - Based on Twitter's location guess | [restaurant near:me](https://twitter.com/search?q=restaurant%20near%3Ame) | | `within:radius` | Distance from location | - Use with near:
- Use km/mi | [fire near:"San Francisco" within:10km](https://twitter.com/search?q=fire%20near%3A%22San%20Francisco%22%20within%3A10km) | | `geocode:lat,long,radius` | Within radius of coords | - Precise location targeting | [geocode:37.7764685,-122.4172004,10km](https://twitter.com/search?q=geocode%3A37.7764685%2C-122.4172004%2C10km) | | `place:place_id` | Specific Place ID | - Use Twitter Place IDs | [place:96683cc9126741d1](https://twitter.com/search?q=place%3A96683cc9126741d1) | ## 4. Time Operators | **Operator / Syntax** | **Meaning** | **Usage / Notes** | **Example** | |----------------------|-------------|-------------------|-------------| | `since:YYYY-MM-DD` | After date (inclusive) | - Combine with until: | [space since:2024-01-01](https://twitter.com/search?q=space%20since%3A2024-01-01) | | `until:YYYY-MM-DD` | Before date | - Not inclusive | [news until:2024-06-01](https://twitter.com/search?q=news%20until%3A2024-06-01) | | `since_time:timestamp` | After Unix timestamp | - Seconds since epoch | [breaking since_time:1693861200](https://twitter.com/search?q=breaking%20since_time%3A1693861200) | | `until_time:timestamp` | Before Unix timestamp | - Seconds since epoch | [important until_time:1693947600](https://twitter.com/search?q=important%20until_time%3A1693947600) | | `since_id:tweet_id` | After tweet ID | - For pagination | [nasa since_id:1234567890123456789](https://twitter.com/search?q=nasa%20since_id%3A1234567890123456789) | | `max_id:tweet_id` | Before/at tweet ID | - For pagination | [breaking max_id:1234567890123456789](https://twitter.com/search?q=breaking%20max_id%3A1234567890123456789) | | `within_time:Xd/h/m/s` | Within time period | - d=days, h=hours, etc | [news within_time:7d](https://twitter.com/search?q=news%20within_time%3A7d) | ## 5. Tweet Type Operators | **Operator / Syntax** | **Meaning** | **Usage / Notes** | **Example** | |----------------------|-------------|-------------------|-------------| | `filter:nativeretweets` | Native RTs only | - Via RT button | [from:NASA filter:nativeretweets](https://twitter.com/search?q=from%3ANASA%20filter%3Anativeretweets) | | `include:nativeretweets` | Include native RTs | - Default excluded | [breaking include:nativeretweets](https://twitter.com/search?q=breaking%20include%3Anativeretweets) | | `filter:retweets` | All RT types | - Includes manual RTs | [news filter:retweets](https://twitter.com/search?q=news%20filter%3Aretweets) | | `filter:replies` | Reply tweets | - Direct replies | [filter:replies to:elonmusk](https://twitter.com/search?q=filter%3Areplies%20to%3Aelonmusk) | | `conversation_id:id` | Thread tweets | - Full conversation | [conversation_id:1234567890123456789](https://twitter.com/search?q=conversation_id%3A1234567890123456789) | | `filter:quote` | Quote tweets | - Tweet quotes only | [breaking filter:quote](https://twitter.com/search?q=breaking%20filter%3Aquote) | | `quoted_tweet_id:id` | Quotes of tweet | - By tweet ID | [quoted_tweet_id:1234567890123456789](https://twitter.com/search?q=quoted_tweet_id%3A1234567890123456789) | | `quoted_user_id:id` | Quotes of user | - By user ID | [quoted_user_id:9876543210987654321](https://twitter.com/search?q=quoted_user_id%3A9876543210987654321) | | `card_name:pollX` | Poll tweets | - Various poll types | [card_name:poll4choice_text_only](https://twitter.com/search?q=card_name%3Apoll4choice_text_only) | ## 6. Engagement Operators | **Operator / Syntax** | **Meaning** | **Usage / Notes** | **Example** | |----------------------|-------------|-------------------|-------------| | `filter:has_engagement` | Has any engagement | - Negate for zero engagement | [nasa filter:has_engagement](https://twitter.com/search?q=nasa%20filter%3Ahas_engagement) | | `min_retweets:X` | Min RT count | - Approximate for large numbers | [breaking min_retweets:500](https://twitter.com/search?q=breaking%20min_retweets%3A500) | | `min_faves:X` | Min likes | - Approximate for large numbers | [cats min_faves:1000](https://twitter.com/search?q=cats%20min_faves%3A1000) | | `min_replies:X` | Min replies | - Not always accurate | [news min_replies:100](https://twitter.com/search?q=news%20min_replies%3A100) | | `-min_retweets:X` | Max RT count | - For low engagement | [important -min_retweets:5](https://twitter.com/search?q=important%20-min_retweets%3A5) | | `-min_faves:X` | Max likes | - For low engagement | [update -min_faves:100](https://twitter.com/search?q=update%20-min_faves%3A100) | | `-min_replies:X` | Max replies | - For low engagement | [announcement -min_replies:3](https://twitter.com/search?q=announcement%20-min_replies%3A3) | ## 7. Media Operators | **Operator / Syntax** | **Meaning** | **Usage / Notes** | **Example** | |----------------------|-------------|-------------------|-------------| | `filter:media` | Any media | - Images/videos/GIFs | [space filter:media](https://twitter.com/search?q=space%20filter%3Amedia) | | `filter:twimg` | Twitter images | - pic.twitter.com only | [cats filter:twimg](https://twitter.com/search?q=cats%20filter%3Atwimg) | | `filter:images` | Any images | - Including external | [dogs filter:images](https://twitter.com/search?q=dogs%20filter%3Aimages) | | `filter:videos` | Any videos | - Including external | [nature filter:videos](https://twitter.com/search?q=nature%20filter%3Avideos) | | `filter:native_video` | Twitter videos | - Including Vine/Periscope | [news filter:native_video](https://twitter.com/search?q=news%20filter%3Anative_video) | | `filter:consumer_video` | User videos | - Non-pro content | [funny filter:consumer_video](https://twitter.com/search?q=funny%20filter%3Aconsumer_video) | | `filter:pro_video` | Pro videos | - Marketing/ads | [trailer filter:pro_video](https://twitter.com/search?q=trailer%20filter%3Apro_video) | ## 8. More Filters | **Operator / Syntax** | **Meaning** | **Usage / Notes** | **Example** | |----------------------|-------------|-------------------|-------------| | `filter:links` | Contains URL | - Including media | [news filter:links](https://twitter.com/search?q=news%20filter%3Alinks) | | `filter:mentions` | Has @mentions | - Any mention | [important filter:mentions](https://twitter.com/search?q=important%20filter%3Amentions) | | `filter:news` | News links | - From news domains | [breaking filter:news](https://twitter.com/search?q=breaking%20filter%3Anews) | | `filter:safe` | Safe content | - No sensitive content | [cats -filter:safe](https://twitter.com/search?q=cats%20-filter%3Asafe) | | `filter:hashtags` | Has hashtags | - Any hashtag | [trending filter:hashtags](https://twitter.com/search?q=trending%20filter%3Ahashtags) | ## 9. App-Specific Operators | **Operator / Syntax** | **Meaning** | **Usage / Notes** | **Example** | |----------------------|-------------|-------------------|-------------| | `source:client_name` | From specific app | - Replace spaces with _ | [from:NASA source:tweetdeck](https://twitter.com/search?q=from%3ANASA%20source%3Atweetdeck) | | `card_name:audio` | Audio cards | - Spotify, etc | [card_name:audio](https://twitter.com/search?q=card_name%3Aaudio) | | `card_name:player` | Media players | - Video/audio | [card_name:player](https://twitter.com/search?q=card_name%3Aplayer) | | `card_name:summary` | Small previews | - Link previews | [card_name:summary](https://twitter.com/search?q=card_name%3Asummary) | | `card_name:summary_large_image` | Large previews | - Big link previews | [card_name:summary_large_image](https://twitter.com/search?q=card_name%3Asummary_large_image) | ### Notes & Limitations - Replace hyphens/spaces with underscores in parameters - Maximum ~22 operators per query - Private/suspended accounts not searchable - Results may vary due to Twitter's indexing ### Example Complex Query ``` (puppy OR kitten) (sweet OR cute) -min_retweets:10 -filter:nativeretweets lang:en since:2024-01-01 until:2024-12-31 -filter:replies ``` [Try this complex query](https://twitter.com/search?q=(puppy%20OR%20kitten)%20(sweet%20OR%20cute)%20-min_retweets%3A10%20-filter%3Anativeretweets%20lang%3Aen%20since%3A2024-01-01%20until%3A2024-12-31%20-filter%3Areplies) This finds non-reply tweets about puppies/kittens that are sweet/cute, with under 10 retweets, in English, from 2024. > **Note**: Twitter's search functionality can be unpredictable. Some operators may work differently than documented or stop working entirely. When in doubt, test and verify results.
created with ❤️ by @gsusmad