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.