GET /statuses/mentions_timeline

Returns the 20 most recent mentions (tweets containing a users’s @screen_name) for the authenticating user.

The timeline returned is the equivalent of the one seen when you view your mentions on twitter.com.

This method can only return up to 800 tweets.

See Working with Timelines for instructions on traversing timelines.

Parameters

count
integer
optional

Specifies the number of tweets to try and retrieve, up to a maximum of 200. The value of count is best thought of as a limit to the number of tweets to return because suspended or deleted content is removed after the count has been applied. We include retweets in the count, even if include_rts is not supplied. It is recommended you always send include_rts=1 when using this API method.

since_id
integer
optional

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 occured since the since_id, the since_id will be forced to the oldest ID available.

Example: 12345
max_id
integer
optional

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

Example: 54321
trim_user
boolean
optional

When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.

Example: true
contributor_details
boolean
optional

This parameter enhances the contributors element of the status response to include the screen_name of the contributor. By default only the user_id of the contributor is included.

Example: true
include_entities
boolean
optional

The entities node will be disincluded when set to false.

Response (Default)

200

title
string

The title

Example: The Title
coordinates
array

The coordinates

Example: [100.4, 45.1]
Example
[
  {
    "title": "The Title",
    "coordinates": [
      100.4,
      45.1
    ]
  }
]