Sample realtime Tweets

API Reference contents

GET statuses/sample

Returns a small random sample of all public statuses via a stream. The Tweets returned by the default access level are the same, so if two different clients connect to this endpoint, they will see the same Tweets.

Resource URL

https://stream.twitter.com/1.1/statuses/sample.json

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes

Parameters

Name Required Description Default Value Example
delimited optional Specifies whether messages should be length-delimited. See delimited or more information.
stall_warnings optional Specifies whether stall warnings should be delivered. See stall_warnings for more information.

Example Request

curl --request GET --url
https://stream.twitter.com/1.1/statuses/sample.json --header
'authorization: OAuth oauth_consumer_key="CONSUMER_KEY",
oauth_nonce="CONSUMER_SECRET",
oauth_signature="GENERATED_SIGNATURE",
oauth_signature_method="HMAC-SHA1",
oauth_timestamp="GENERATED_TIMESTAMP", oauth_token="ACCESS_TOKEN",
oauth_version="1.0"'

Example Response

{
  "created_at": "Mon May 06 20:01:29 +0000 2019",
  "id": 1125490788736032800,
  "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",
  "timestamp_ms": "1557172889299",
}
}


{
  "delete": {
    "status": {
      "id": 1128077144855384064,
      "id_str": "1128077144855384064",
      "user_id": 1119439300041506823,
      "user_id_str": "1119439300041506823"
    },
    "timestamp_ms": "1557172889299"
  }
}