Lists Statuses

Returns the tweet timeline for the specified list.

Example

Allison made an apple pie because she's fancy and America. instagram.com/p/BBxpBlVxrRq/

Note: These docs are static, so relative dates may be inaccurate.

Note: You have complete control over the code, variables, and style of your Tweets. If you plan on utilizing the reply, favorite, and/or retweet actions, make sure to add the Twitter Web Intents script (see the Intents Script Tag for more details):

{exp:ce_tweet:intents_script}
<div class="ce_tweet_holder group">
{exp:ce_tweet:lists_statuses count="5" slug="Temp" owner_screen_name="causingeffect"}
    <div class="ce_tweet">
        <div class="ce_tweet_left">
            <a class="ce_tweet_username" href="http://twitter.com/{user_screen_name}" target="_blank"><img src="{user_profile_image_url}" alt="" /></a>
        </div><!-- .ce_tweet_left -->
        <div class="ce_tweet_right">
            <div class="ce_tweet_row">
                <a class="ce_tweet_username" href="http://twitter.com/{user_screen_name}" target="_blank">{user_name}</a>
                <a class="ce_tweet_name" href="http://twitter.com/{user_screen_name}" target="_blank">{user_screen_name}</a>
            </div><!-- .ce_tweet_row -->
            <div class="ce_tweet_row ce_tweet_text">{text}</div>
            <div class="ce_tweet_row ce_tweet_actions">
                <a class="ce_tweet_time" href="https://twitter.com/{user_screen_name}/statuses/{id_str}" title="{created_at format="%g:%i %A, %M %j%S (%T)"}" target="_blank"><span class="icon-twitter"></span> {created_at_relative}</a>
                <a class="ce_tweet_reply" href="https://twitter.com/intent/tweet?in_reply_to={id_str}" target="_blank"><span>Reply</span></a>
                <a class="ce_tweet_retweet{if retweeted} ce_tweet_retweeted{/if}" href="https://twitter.com/intent/retweet?tweet_id={id_str}" target="_blank"><span>Retweet</span></a>
                <a class="ce_tweet_favorite{if favorited} ce_tweet_favorited{/if}" href="https://twitter.com/intent/favorite?tweet_id={id_str}" target="_blank"><span>Favorite</span></a>
            </div><!-- .ce_tweet_row -->
        </div><!-- .ce_tweet_right -->
    </div><!-- .ce_tweet -->
{/exp:ce_tweet:lists_statuses}
</div><!-- .ce_tweet_holder -->

Parameters

Note: Either a list_id= or a slug= is required. If providing a list_slug, an owner_screen_name= or owner_id= is also required. All other parameters are optional.

list_id=

The numerical id of the list.

slug=

You can identify a list by its slug instead of its numerical id. If you decide to do so, note that you'll also have to specify the list owner using the owner_id= or owner_screen_name= parameters.

owner_screen_name=

The screen name of the user who owns the list being requested by a slug=.

owner_id=

The user id of the user who owns the list being requested by a slug=.

since_id=

Returns results with an id greater than (that is, more recent than) the specified id. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occurred since the since_id, the since_id will be forced to the oldest id available.

max_id=

Returns results with an id less than (that is, older than) or equal to the specified id.

include_entities=

When set to "yes", each tweet will include a variety of metadata about the tweet, including: user_mentions, urls, and hashtags. The default is "yes".

include_rts=

When set to "yes",the timeline will contain native retweets (if they exist) in addition to the standard stream of tweets. The output format of retweeted tweets is identical to the representation you see in home_timeline. The default is "no".

count=

Specifies the number of records to retrieve. Must be less than or equal to 100. Defaults to "20".

link=

Should the text be hyperlinked? Can be one or more of the following:

  • h Link hashtags like #example
  • m Link mention like @causingeffect
  • u Link URLs like http://www.causingeffect.com

Multiple values should be pipe delimited. Defaults to "h|m|u".

seconds=

The amount of seconds to cache this tag’s output. Defaults to "300" (5 minutes).

Variables

{id_str}
{in_reply_to_screen_name}
{in_reply_to_status_id_str}
{in_reply_to_user_id_str}
{is_retweet}
{place}
{retweet_count}
{retweeted}
{source}
{text}
{text_raw}
{truncated}
{user_contributors_enabled}
{user_created_at}
{user_created_at_relative}
{user_default_profile}
{user_default_profile_image}
{user_description}
{user_favourites_count}
{user_follow_request_sent}
{user_followers_count}
{user_following}
{user_friends_count}
{user_geo_enabled}
{user_id_str}
{user_is_translator}
{user_lang}
{user_listed_count}
{user_location}
{user_name}
{user_notifications}
{user_profile_background_color}
{user_profile_background_image_url}
{user_profile_background_image_url_https}
{user_profile_background_tile}
{user_profile_image_url}
{user_profile_image_url_https}
{user_profile_link_color}
{user_profile_sidebar_border_color}
{user_profile_sidebar_fill_color}
{user_profile_text_color}
{user_profile_use_background_image}
{user_protected}
{user_screen_name}
{user_show_all_inline_media}
{user_statuses_count}
{user_time_zone}
{user_url}
{user_utc_offset}
{user_verified}
{contributors}
    {id_str}
    {screen_name}
{/contributors}
{created_at}
{created_at_relative}
{entities_urls}
    {url}
    {expanded_url}
    {display_url}
{/entities_urls}
{entities_hashtags}
    {text}
{/entities_hashtags}
{entities_user_mentions}
    {screen_name}
    {name}
    {id_str}
{/entities_user_mentions}
{favorited}
{geo}

Note: Take a look at the Twitter Tweets documentation for more details about the variables.

Twitter Resources

This method is an implementation of the Twitter lists/statuses REST API.