Twitter Search Stream

The Twitter Search Stream is an extremely powerful way of engaging the right audience on Twitter. Oktopost allows any user to connect their Twitter profile and create a stream that follows Tweets according to a custom search query.

Below are a few examples of how you can form search queries in order to find the tweets you're looking for:

Searching for Will find tweets...
watching now Containing both "watching" and "now". This is the default operator.
"happy hour" Containing the exact phrase "happy hour".
love OR hate Containing either "love" or "hate" (or both).
beer -root Containing "beer" but not "root".
#haiku Containing the hashtag "haiku".
from:oktopost Sent from person "oktopost".
to:techcrunch Sent to person "techcrunch".
@mashable Referencing person "mashable".
superhero since:2015-07-19 Containing "superhero" and sent since date "2015-07-19" (year-month-day).
ftw until:2015-07-19 Containing "ftw" and sent before the date "2015-07-19".
movie -scary :) Containing "movie", but not "scary", and with a positive attitude.
flight :( Containing "flight" and with a negative attitude.
traffic ? Containing "traffic" and asking a question.
hilarious filter:links Containing "hilarious" and linking to URL.
news source:twitterfeed Containing "news" and entered via TwitterFeed.
lang:en Restricts tweets to the given language (English with this example), given by an ISO 639-1 code

Best Practices

  • Limit your searches to 10 keywords and operators.
  • Queries can be limited due to complexity. If this happens the Search API will respond with an error.
  • The Search API is not complete index of all Tweets, but instead an index of recent Tweets. At the moment that index includes between 6-9 days of Tweets.

Feedback and Knowledge Base