Add Twitter content to your Apps.
Twitter Curate allows you to pull content from Twitter, and add it to a Collection, which may be displayed in any Livefyre App on your site. Curated Tweets appear in the stream with a small Twitter icon.
Note: Livefyre adheres to Twitter display guidelines, and customers are responsible for adhering to these guidelines as well. For more information, please see Twitter’s documentation on their Display Requirements.
Use Twitter Curate to create Rules by which Twitter content will be pulled into your stream. Livefyre offers several options to filter by:
- Enter hashtags, keywords, or @mentions to be included in, or excluded from your Twitter stream. Specifying values for both the Contains and Does not contain fields will return Tweets which contain the first, and do not contain the second. Multiple values for a single field may be entered, and will return results which contain any of the values.
- For example: Entering Contains keywords Giants, Posey, and Does not contain keyword Dodger, will return all Tweets which include the word Giants or Posey, and do not include the word Dodger.
Note: To add multiple keywords linked by and rather than or, use the format “Giants && Posey”. This feature is supported only for Twitter Curate, and works for both hashtags and keywords.
- Enter authors to pull into the stream, or exclude from the stream. Use the checkboxes to define whether Retweets or replies from these authors should also be included.
- Note: You may either include or exclude authors; you cannot combine these two fields into a single Curate Rule.
- Enter the location (global city, zipcode, address, or geocode in the common latitude/longitude format (+/- 90, +/- 180) ) and use the pulldown menu to select the distance from this location within which, or outside of which, content should be pulled. Combining the Is within and Is not within fields will pull content that is geotagged from within the first, but either geotagged beyond the second Location, or not geotagged at all.
- Note: For both fields, distance will be calculated from the center of the input location.
- For example: Entering Is within 10000 miles of San Francisco, and Is not within 10 miles of Palo Alto will return content geotagged within a 10000 mile radius of San Francisco, and not within a 10 mile radius of Palo Alto.
- Additional Filters
- Use Additional Filters to further refine your Curate Rule. Define whether you will:
- include Replies to the curated Tweets (If the stream becomes high velocity, this feature will automatically be disabled.);
- include Tweets from Verified Twitter accounts only;
- include All Content, or Vines Only, or Images Only; and
- include only Tweets which originate from accounts with the selected Minimum number of followers (any, 100, 500, 1000, 10,000, or 100,000).
Use Twitter Curate Rules to power Social Counter Collections, which contain only the number of Twitter content pieces matching the Rule(s) within a specific time period. Social Counter Collections contain no actual Tweets or other pieces of content; only the count of Tweets associated with the Curate Rule(s). (This provides a more accurate count, not subject to throttling.)
Note: Use the Create Collection API to create a Social Counter Collection, and set the CollectionMeta object’s type parameter to counting.
Once created, the Admin Console’s Collections List page will include the count(s) of the items for the Social Counter Collection. You may also use the Social Counter API to create visualizations which plot the relative popularity of different topics, based on the different Curate rules in your Social Counter Collection.
Be aware that not every Tweet that matches a rule may appear in a stream. Both Twitter Curate throttling, and Twitter feed interruptions may limit the number of Tweets visible in the stream.
Note: To guarantee that specific Tweets are included in your stream, use Curate Search.
- Twitter Curate throttles content, pulling 1 Tweet per rule every 5 seconds. This allows content appearing in Livefyre Apps to be more balanced, and not become overwhelmed with Tweets. Limiting incoming Tweets in this manner also helps to prevent the stream from becoming flooded or unreadable during high traffic periods.
Note: To ensure that your high-value authors’ content appears in your Collections, even in high-velocity streams, Rules for specific authors are never throttled.
- Twitter feed interruptions may occur for several reasons. In some cases, Twitter does not push out Tweets, therefore Livefyre does not receive notification of the new content, and it cannot be displayed. Service interruptions of Twitter’s APIs, or traffic on high volume hashtags/keywords, may also result in missed Tweets.