Skip to content
Related Articles

Related Articles

Python – API.user_timeline() in Tweepy

View Discussion
Improve Article
Save Article
Like Article
  • Last Updated : 05 Jun, 2020

Twitter is a popular social network where users share messages called tweets. Twitter allows us to mine the data of any user using Twitter API or Tweepy. The data will be tweets extracted from the user. The first thing to do is get the consumer key, consumer secret, access key and access secret from twitter developer available easily for each user. These keys will help the API for authentication.


The user_timeline() method of the API class in Tweepy module is used to get the 20 most recent statuses posted from the authenticating user or the user specified.

Syntax : API.user_timeline(parameters)

Parameters :

  • id : specifies the ID or the screen name of the user.
  • user_id : specifies the ID of the user, useful to differentiate accounts when a valid user ID is also a valid screen name.
  • screen_name : specifies the screen name of the user, useful to differentiate accounts when a valid screen name is also a user ID.
  • since_ids : Fetch only the statuses newer than the specified ID.
  • max_ids : Fetch only the statuses older than or equal to the specified ID.
  • count : The number of statuses to be fetched, the default value is 20.

Returns : a list of objects of the class Status

Example 1 :

# import the module
import tweepy
# assign the values accordingly
consumer_key = ""
consumer_secret = ""
access_token = ""
access_token_secret = ""
# authorization of consumer key and consumer secret
auth = tweepy.OAuthHandler(consumer_key, consumer_secret)
# set access to user's access key and access secret 
auth.set_access_token(access_token, access_token_secret)
# calling the api 
api = tweepy.API(auth)
# screen name of the account to be fetched
screen_name = "geeksforgeeks"
# fetching the statuses
statuses = api.user_timeline(screen_name)
print(str(len(statuses)) + " number of statuses have been fetched.")

Output :

20 number of statuses have been fetched.

Example 2: Using the user_timeline() method with the count parameter to fetch only a specified number of statuses.

# screen name of the account to be fetched
screen_name = "geeksforgeeks"
# number of statuses to be fetched
count = 3
# fetching the statuses
statuses = api.user_timeline(screen_name, count = count)
# printing the statuses
for status in statuses:
    print(status.text, end = "\n\n")

Output :

Hola Geeks!
Tell us what did you learned during this lockdown?
#MondayMotivation #mondaythoughts #codinglife…

@ZomatoIN Avoid Errors, not Client calls
#sundayvibes #programmingmemes

Avoid errors, not client calls
Geeks, Keep this going...
#sundayvibes #programming #programmingmemes #coding

My Personal Notes arrow_drop_up
Recommended Articles
Page :

Start Your Coding Journey Now!