GET statuses/mentions_timeline

Important notice: On June 19, 2019, we will begin limiting access to the /statuses/mentions_timeline endpoint to 100,000 requests per day as a default, in addition to existing user-level rate limits (75 requests / 15-minutes). This limit will be on a per-application basis, meaning that a single developer app can make up to 100,000 calls during any single 24-hour period.

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.

Resource URL

https://api.twitter.com/1.1/statuses/mentions_timeline.json

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes
Requests / 15-min window (user auth) 75

Parameters

Name Required Description Default Value Example
count 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 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. 12345
max_id optional Returns results with an ID less than (that is, older than) or equal to the specified ID. 54321
trim_user 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. true
include_entities optional The entities node will not be included when set to false. false

Example Request

GET https://api.twitter.com/1.1/statuses/mentions_timeline.json?count=1&since_id=14927799

Example Response

[
{
  "created_at": "Mon May 06 20:01:29 +0000 2019",
  "id": 1125490788736032770,
  "id_str": "1125490788736032770",
  "text": "Today's new update means that you can finally add Pizza Cat to your Retweet with comments! Learn more about this ne… https://t.co/Rbc9TF2s5X",
  "display_text_range": [
    0,
    140
  ],
  "source": "<a href="https://mobile.twitter.com" rel="nofollow">Twitter Web App</a>",
  "truncated": true,
  "in_reply_to_status_id": null,
  "in_reply_to_status_id_str": null,
  "in_reply_to_user_id": null,
  "in_reply_to_user_id_str": null,
  "in_reply_to_screen_name": null,
  "user": {
    "id": 2244994945,
    "id_str": "2244994945",
    "name": "Twitter Dev",
    "screen_name": "TwitterDev",
    "location": "Internet",
    "url": "https://developer.twitter.com/",
    "description": "Your official source for Twitter Platform news, updates & events. Need technical help? Visit https://twittercommunity.com/ ⌨️ #TapIntoTwitter",
    "translator_type": "null",
    "protected": false,
    "verified": true,
    "followers_count": 501945,
    "friends_count": 1473,
    "listed_count": 1503,
    "favourites_count": 2188,
    "statuses_count": 3389,
    "created_at": "Sat Dec 14 04:35:55 +0000 2013",
    "utc_offset": null,
    "time_zone": null,
    "geo_enabled": true,
    "lang": "en",
    "contributors_enabled": false,
    "is_translator": false,
    "profile_background_color": "null",
    "profile_background_image_url": "null",
    "profile_background_image_url_https": "null",
    "profile_background_tile": null,
    "profile_link_color": "null",
    "profile_sidebar_border_color": "null",
    "profile_sidebar_fill_color": "null",
    "profile_text_color": "null",
    "profile_use_background_image": null,
    "profile_image_url": "null",
    "profile_image_url_https": "https://pbs.twimg.com/profile_images/880136122604507136/xHrnqf1T_normal.jpg",
    "profile_banner_url": "https://pbs.twimg.com/profile_banners/2244994945/1498675817",
    "default_profile": false,
    "default_profile_image": false,
    "following": null,
    "follow_request_sent": null,
    "notifications": null
  },
  "geo": null,
  "coordinates": null,
  "place": null,
  "contributors": null,
  "quoted_status_id": 1125479034513645600,
  "quoted_status_id_str": "1125479034513645569",
  "quoted_status": {
    "created_at": "Mon May 06 19:14:46 +0000 2019",
    "id": 1125479034513645600,
    "id_str": "1125479034513645569",
    "text": "It's easy to express yourself by Retweeting with a comment. What if you could take it a step further and include me… https://t.co/YTqpNZZ8M9",
    "display_text_range": [
      0,
      140
    ],
    "source": "<a href="http://twitter.com" rel="nofollow">Twitter Web Client</a>",
    "truncated": true,
    "in_reply_to_status_id": null,
    "in_reply_to_status_id_str": null,
    "in_reply_to_user_id": null,
    "in_reply_to_user_id_str": null,
    "in_reply_to_screen_name": null,
    "user": {
      "id": 17874544,
      "id_str": "17874544",
      "name": "Twitter Support",
      "screen_name": "TwitterSupport",
      "location": "Twitter HQ",
      "url": "https://help.twitter.com",
      "description": "Your official source for Twitter Support. We're available 24/7 via Direct Message to answer account questions. Follow us for tips, tricks, and announcements.",
      "translator_type": "null",
      "protected": false,
      "verified": true,
      "followers_count": 5859620,
      "friends_count": 17,
      "listed_count": 15161,
      "favourites_count": 300,
      "statuses_count": 27951,
      "created_at": "Thu Dec 04 18:51:57 +0000 2008",
      "utc_offset": null,
      "time_zone": null,
      "geo_enabled": true,
      "lang": "en",
      "contributors_enabled": false,
      "is_translator": false,
      "profile_background_color": "null",
      "profile_background_image_url": "null",
      "profile_background_image_url_https": "null",
      "profile_background_tile": null,
      "profile_link_color": "null",
      "profile_sidebar_border_color": "null",
      "profile_sidebar_fill_color": "null",
      "profile_text_color": "null",
      "profile_use_background_image": null,
      "profile_image_url": "null",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/941807338171777025/PRP6vwDq_normal.jpg",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/17874544/1499274456",
      "default_profile": false,
      "default_profile_image": false,
      "following": null,
      "follow_request_sent": null,
      "notifications": null
    },
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "is_quote_status": false,
    "extended_tweet": {
      "full_text": "It's easy to express yourself by Retweeting with a comment. What if you could take it a step further and include media? Starting today, you can! Retweet with photos, a GIF, or a video to really make your reaction pop. Available on iOS, Android, and https://t.co/AzMLIfU3jB. https://t.co/Oir5Hpkb2F",
      "display_text_range": [
        0,
        273
      ],
      "entities": {
        "hashtags": [],
        "urls": [
          {
            "url": "https://t.co/AzMLIfU3jB",
            "expanded_url": "https://mobile.twitter.com",
            "display_url": "mobile.twitter.com",
            "unwound": {
              "url": "https://mobile.twitter.com",
              "status": 200,
              "title": "Welcome to Twitter",
              "description": null
            },
            "indices": [
              249,
              272
            ]
          }
        ],
        "user_mentions": [],
        "symbols": [],
        "media": [
          {
            "id": 1125478846289985500,
            "id_str": "1125478846289985536",
            "indices": [
              274,
              297
            ],
            "media_url": "http://pbs.twimg.com/tweet_video_thumb/D56BDDNUwAAxsUD.jpg",
            "media_url_https": "https://pbs.twimg.com/tweet_video_thumb/D56BDDNUwAAxsUD.jpg",
            "url": "https://t.co/Oir5Hpkb2F",
            "display_url": "pic.twitter.com/Oir5Hpkb2F",
            "expanded_url": "https://twitter.com/TwitterSupport/status/1125479034513645569/photo/1",
            "type": "animated_gif",
            "video_info": {
              "aspect_ratio": [
                1,
                1
              ],
              "variants": [
                {
                  "bitrate": 0,
                  "content_type": "video/mp4",
                  "url": "https://video.twimg.com/tweet_video/D56BDDNUwAAxsUD.mp4"
                }
              ]
            },
            "sizes": {
              "thumb": {
                "w": 150,
                "h": 150,
                "resize": "crop"
              },
              "small": {
                "w": 680,
                "h": 680,
                "resize": "fit"
              },
              "medium": {
                "w": 1080,
                "h": 1080,
                "resize": "fit"
              },
              "large": {
                "w": 1080,
                "h": 1080,
                "resize": "fit"
              }
            }
          }
        ]
      },
      "extended_entities": {
        "media": [
          {
            "id": 1125478846289985500,
            "id_str": "1125478846289985536",
            "indices": [
              274,
              297
            ],
            "media_url": "http://pbs.twimg.com/tweet_video_thumb/D56BDDNUwAAxsUD.jpg",
            "media_url_https": "https://pbs.twimg.com/tweet_video_thumb/D56BDDNUwAAxsUD.jpg",
            "url": "https://t.co/Oir5Hpkb2F",
            "display_url": "pic.twitter.com/Oir5Hpkb2F",
            "expanded_url": "https://twitter.com/TwitterSupport/status/1125479034513645569/photo/1",
            "type": "animated_gif",
            "video_info": {
              "aspect_ratio": [
                1,
                1
              ],
              "variants": [
                {
                  "bitrate": 0,
                  "content_type": "video/mp4",
                  "url": "https://video.twimg.com/tweet_video/D56BDDNUwAAxsUD.mp4"
                }
              ]
            },
            "sizes": {
              "thumb": {
                "w": 150,
                "h": 150,
                "resize": "crop"
              },
              "small": {
                "w": 680,
                "h": 680,
                "resize": "fit"
              },
              "medium": {
                "w": 1080,
                "h": 1080,
                "resize": "fit"
              },
              "large": {
                "w": 1080,
                "h": 1080,
                "resize": "fit"
              }
            }
          }
        ]
      }
    },
    "quote_count": 1495,
    "reply_count": 140,
    "retweet_count": 438,
    "favorite_count": 995,
    "entities": {
      "hashtags": [],
      "urls": [
        {
          "url": "https://t.co/YTqpNZZ8M9",
          "expanded_url": "https://twitter.com/i/web/status/1125479034513645569",
          "display_url": "twitter.com/i/web/status/1…",
          "indices": [
            117,
            140
          ]
        }
      ],
      "user_mentions": [],
      "symbols": []
    },
    "favorited": false,
    "retweeted": false,
    "possibly_sensitive": false,
    "filter_level": "low",
    "lang": "en"
  },
  "quoted_status_permalink": {
    "url": "https://t.co/lXs26mCkIl",
    "expanded": "https://twitter.com/TwitterSupport/status/1125479034513645569",
    "display": "twitter.com/TwitterSupport…"
  },
  "is_quote_status": true,
  "extended_tweet": {
    "full_text": "Today's new update means that you can finally add Pizza Cat to your Retweet with comments! Learn more about this news from our Twitter Developer Forum post here: https://t.co/W1FqVrsjQk https://t.co/T9MBCHZWcD",
    "display_text_range": [
      0,
      185
    ],
    "entities": {
      "hashtags": [],
      "urls": [
        {
          "url": "https://t.co/W1FqVrsjQk",
          "expanded_url": "https://twittercommunity.com/t/rt-with-comment-aka-quote-tweets-now-may-have-media-attached-across-twitter-apis/125539",
          "display_url": "twittercommunity.com/t/rt-with-comm…",
          "unwound": {
            "url": "https://twittercommunity.com/t/rt-with-comment-aka-quote-tweets-now-may-have-media-attached-across-twitter-apis/125539",
            "status": 200,
            "title": "RT with comment, aka Quote Tweets, now may have media attached across Twitter APIs",
            "description": "Today we’re announcing a new feature that allows userspeople on Twitter to add a GIF, video, or photo to their Retweet with comments, aka Quote Tweets. Developers will start to see additional media metadata included in the payload for Quote Tweets. Quote Tweets with media will be rendered very similarly to Tweets with media across our APIs. This rendering is an addition to the existing media field, so this should not be a breaking change for application owners, if they are already ingesting med..."
          },
          "indices": [
            162,
            185
          ]
        }
      ],
      "user_mentions": [],
      "symbols": [],
      "media": [
        {
          "id": 1125490782532657200,
          "id_str": "1125490782532657153",
          "indices": [
            186,
            209
          ],
          "media_url": "http://pbs.twimg.com/tweet_video_thumb/D56L51LV4AEEC8-.jpg",
          "media_url_https": "https://pbs.twimg.com/tweet_video_thumb/D56L51LV4AEEC8-.jpg",
          "url": "https://t.co/T9MBCHZWcD",
          "display_url": "pic.twitter.com/T9MBCHZWcD",
          "expanded_url": "https://twitter.com/TwitterDev/status/1125490788736032770/photo/1",
          "type": "animated_gif",
          "video_info": {
            "aspect_ratio": [
              101,
              165
            ],
            "variants": [
              {
                "bitrate": 0,
                "content_type": "video/mp4",
                "url": "https://video.twimg.com/tweet_video/D56L51LV4AEEC8-.mp4"
              }
            ]
          },
          "sizes": {
            "thumb": {
              "w": 150,
              "h": 150,
              "resize": "crop"
            },
            "small": {
              "w": 202,
              "h": 330,
              "resize": "fit"
            },
            "large": {
              "w": 202,
              "h": 330,
              "resize": "fit"
            },
            "medium": {
              "w": 202,
              "h": 330,
              "resize": "fit"
            }
          }
        }
      ]
    },
    "extended_entities": {
      "media": [
        {
          "id": 1125490782532657200,
          "id_str": "1125490782532657153",
          "indices": [
            186,
            209
          ],
          "media_url": "http://pbs.twimg.com/tweet_video_thumb/D56L51LV4AEEC8-.jpg",
          "media_url_https": "https://pbs.twimg.com/tweet_video_thumb/D56L51LV4AEEC8-.jpg",
          "url": "https://t.co/T9MBCHZWcD",
          "display_url": "pic.twitter.com/T9MBCHZWcD",
          "expanded_url": "https://twitter.com/TwitterDev/status/1125490788736032770/photo/1",
          "type": "animated_gif",
          "video_info": {
            "aspect_ratio": [
              101,
              165
            ],
            "variants": [
              {
                "bitrate": 0,
                "content_type": "video/mp4",
                "url": "https://video.twimg.com/tweet_video/D56L51LV4AEEC8-.mp4"
              }
            ]
          },
          "sizes": {
            "thumb": {
              "w": 150,
              "h": 150,
              "resize": "crop"
            },
            "small": {
              "w": 202,
              "h": 330,
              "resize": "fit"
            },
            "large": {
              "w": 202,
              "h": 330,
              "resize": "fit"
            },
            "medium": {
              "w": 202,
              "h": 330,
              "resize": "fit"
            }
          }
        }
      ]
    }
  },
  "quote_count": 0,
  "reply_count": 0,
  "retweet_count": 0,
  "favorite_count": 0,
  "entities": {
    "hashtags": [],
    "urls": [
      {
        "url": "https://t.co/Rbc9TF2s5X",
        "expanded_url": "https://twitter.com/i/web/status/1125490788736032770",
        "display_url": "twitter.com/i/web/status/1…",
        "indices": [
          117,
          140
        ]
      }
    ],
    "user_mentions": [],
    "symbols": []
  },
  "favorited": false,
  "retweeted": false,
  "possibly_sensitive": false,
  "filter_level": "low",
  "lang": "en",
}
]