Returns up to 3,200 statuses posted to the timelines of each of one or more specified Twitter users.

get_timeline(user, n = 100, max_id = NULL, home = FALSE, parse = TRUE,
  check = TRUE, token = NULL, ...)

get_timelines(user, n = 100, max_id = NULL, home = FALSE, parse = TRUE,
  check = TRUE, token = NULL, ...)

Arguments

user

Vector of user names, user IDs, or a mixture of both.

n

Number of tweets to return per timeline. Defaults to 100. Must be of length 1 or equal to length of user.

max_id

Character, status_id from which returned tweets should be older than.

home

Logical, indicating whether to return a user-timeline or home-timeline. By default, home is set to FALSE, which means get_timeline returns tweets posted by the given user. To return a user's home timeline feed, that is, the tweets posted by accounts followed by a user, set the home to false.

parse

Logical, indicating whether to return parsed (data.frames) or nested list object. By default, parse = TRUE saves users from the time [and frustrations] associated with disentangling the Twitter API return objects.

check

Logical indicating whether to remove check available rate limit. Ensures the request does not exceed the maximum remaining number of calls. Defaults to TRUE.

token

OAuth token. By default token = NULL fetches a non-exhausted token from an environment variable. Find instructions on how to create tokens and setup an environment variable in the tokens vignette (in r, send ?tokens to console).

...

Further arguments passed on as parameters in API query.

Value

A tbl data frame of tweets data with users data attribute.

See also

https://developer.twitter.com/en/docs/tweets/timelines/api-reference/get-statuses-user_timeline

Other tweets: get_favorites, get_mentions, lists_statuses, lookup_statuses, search_tweets, tweets_data, tweets_with_users

Examples

# NOT RUN { ## get most recent 3200 tweets posted by Donald Trump's account djt <- get_timeline("realDonaldTrump", n = 3200) ## data frame where each observation (row) is a different tweet djt ## users data for realDonaldTrump is also retrieved users_data(djt) ## retrieve timelines of mulitple users tmls <- get_timeline(c("KFC", "ConanOBrien", "NateSilver538"), n = 1000) ## it's returned as one data frame tmls ## count observations for each timeline table(tmls$screen_name) # }