Twitter has reported that on 9 February, free use of their API will be prohibited. If this happens, the Twitter Interface Asset will no longer be able to display tweets. See our User Community for the latest about our understanding and intentions.
Description
The Twitter Interface Asset (IA) retrieves the latest text and image-based tweets for a given search term.
NOTE: There is a five-minute delay between when a tweet appears on Twitter and when that tweet will appear in Intuiface after a refresh of the Twitter IA.
Video Example
Properties, Triggers & Actions
These properties are used to determine which tweets are returned by Twitter.
Properties
- Search query any string of text
- Result type the type of search results. Three options are available
- Mixed Include both popular and real-time results
- Recent return only the most recent results
- Popular return only the most popular results
- Result language filter return only results in the language specified
- Show replies toggle whether to show replies in the search results
- Tweet filter applies a filter to search results based on their content
- All tweets return both text and media tweets
- Only with media return only tweets containing images
- Only with text return only tweets containing pure text
These properties are associated with each individual tweet returned by the search query. They are read-only and can only be accessed through the use of binding.
- Author
- User name user name, preceded by the @ symbol
- Profile name full name
- Profile image URL image, if available
- Original Author [contains values if tweet is a retweet]
- User name user name for original tweet, preceded by the @ symbol
- Profile name full name
- Profile image URL image, if available
- Text the tweet
- Created at posting time and date of the tweet
- Elapsed time time since tweet was posted
- Media URL URL for the image embedded in the tweet
- is Reply identifies whether the tweet is a reply. Value is either True or False
- is Retweet identified whether the tweet is a retweet. Value is either True or False
- Tweet Count number of tweets currently displayed in the feed
Triggers
- No media returned: Raised when the Twitter search returns no results.
- Result found: Raised when the Twitter search returns one or more results.
- Search in progress: Raised when the Twitter search is still in progress.
Actions
Asset Properties
- Set Result language filter - returns only the result in the specified language
- Set Result type - returns the result type (mixed, recent, popular)
- Set Search query - sets the search query
- Set Show replies - toggle to show or not replies to a tweet
- Set Tweet filter - filters the result (only text, only images, mixed)
- Get more tweets: Get the next ten tweets for the current search
- New query: Enter new search term
- Search query: the new search query
- Update: Update the tweet list
Data Template for the Twitter Interface Asset
Any Intuiface user can modify the default visual representation of the Twitter IA. This visual representation - specified by a data template - can access and manipulate all of the tweet properties listed above.
Search query operators
The query can have operators that modify its behavior, the available operators are:
- 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:alexiskold - sent from Twitter account “alexiskold”.
- 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
Intuiface uses Twitter's Standard Search operators which has limitations, such as a seven day history for searches. For a comparison with Twitter's other search tiers, see the image below or the search tier-comparison page.
Known Limitations
- Tweets with image URLs are not supported. Tweets must have an uploaded image.
Comments
0 comments
Article is closed for comments.