Skip to content
Related Articles

Related Articles

Python – API.mentions_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 mentions_timeline() method of the API class in Tweepy module is used to get the 20 most recent tweets of the authenticated user that have been retweeted by others.

Syntax : API.mentions_timeline(parameters)

Parameters :

  • 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 : Using the mentions_timeline() method without any parameters.

# 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)
# fetching the retweets
statuses = api.mentions_timeline()
print(str(len(statuses)) + " number of statuses have been mentioned.")

Output :

20 number of statuses have been mentioned.

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

# screen name of the account to be fetched
screen_name = "geeksforgeeks"
# number of statuses to be fetched
count = 3
# fetching the retweets
statuses = api.mentions_timeline(count = count)
print(str(len(statuses)) + " number of statuses have been mentioned.")

Output :

3 number of statuses have been mentioned.

My Personal Notes arrow_drop_up
Recommended Articles
Page :

Start Your Coding Journey Now!