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": "Tue Feb 27 21:11:40 +0000 2018",
  "id": 968594506663669800,
  "id_str": "968594506663669760",
  "text": "RT @honeydrop_506: 180222 ICN #백현 #BAEKHYUNnn나의 겨울과 너nn#iHeartAwards #BestFanArmy #EXOL @weareoneEXO https://t.co/hg7I3xAlBg",
  "source": "<a href='"http://twitter.com"' rel='"nofollow"'>Twitter Web Client</a>",
  "truncated": false,
  "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": 4448809940,
    "id_str": "4448809940",
    "name": "ayah",
    "screen_name": "lovbyun",
    "location": "bbh iu jjh pcy kjd dks",
    "url": "https://curiouscat.me/baekhyun-l",
    "description": "hi hello I love exo",
    "translator_type": "none",
    "protected": false,
    "verified": false,
    "followers_count": 1142,
    "friends_count": 125,
    "listed_count": 20,
    "favourites_count": 5712,
    "statuses_count": 4011,
    "created_at": "Fri Dec 04 03:44:59 +0000 2015",
    "utc_offset": -28800,
    "time_zone": "Pacific Time (US & Canada)",
    "geo_enabled": false,
    "lang": "en",
    "contributors_enabled": false,
    "is_translator": false,
    "profile_background_color": "000000",
    "profile_background_image_url": "http://abs.twimg.com/images/themes/theme1/bg.png",
    "profile_background_image_url_https": "https://abs.twimg.com/images/themes/theme1/bg.png",
    "profile_background_tile": false,
    "profile_link_color": "F58EA8",
    "profile_sidebar_border_color": "000000",
    "profile_sidebar_fill_color": "000000",
    "profile_text_color": "000000",
    "profile_use_background_image": false,
    "profile_image_url": "http://pbs.twimg.com/profile_images/967130320259526656/0xZ-wxXJ_normal.jpg",
    "profile_image_url_https": "https://pbs.twimg.com/profile_images/967130320259526656/0xZ-wxXJ_normal.jpg",
    "profile_banner_url": "https://pbs.twimg.com/profile_banners/4448809940/1519340670",
    "default_profile": false,
    "default_profile_image": false,
    "following": null,
    "follow_request_sent": null,
    "notifications": null
  },
  "geo": null,
  "coordinates": null,
  "place": null,
  "contributors": null,
  "retweeted_status": {
    "created_at": "Mon Feb 26 14:25:59 +0000 2018",
    "id": 968130023566684200,
    "id_str": "968130023566684160",
    "text": "180222 ICN #백현 #BAEKHYUNnn나의 겨울과 너nn#iHeartAwards #BestFanArmy #EXOL @weareoneEXO https://t.co/hg7I3xAlBg",
    "display_text_range": [
      0,
      81
    ],
    "source": "<a href='"http://twitter.com"' rel='"nofollow"'>Twitter Web Client</a>",
    "truncated": false,
    "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": 785503802761683000,
      "id_str": "785503802761682944",
      "name": "HONEY DROP 🍯",
      "screen_name": "honeydrop_506",
      "location": "백현 마음 속 ‘ㅅ’",
      "url": null,
      "description": "좋아해, 백현아 ❤️ / 로고크롭 2차가공 상업적이용 ❌ 고화질은 마음 / Do not QT / 사담 @BHoney___",
      "translator_type": "none",
      "protected": false,
      "verified": false,
      "followers_count": 32861,
      "friends_count": 10,
      "listed_count": 746,
      "favourites_count": 184,
      "statuses_count": 1220,
      "created_at": "Mon Oct 10 15:34:35 +0000 2016",
      "utc_offset": 32400,
      "time_zone": "Seoul",
      "geo_enabled": false,
      "lang": "ko",
      "contributors_enabled": false,
      "is_translator": false,
      "profile_background_color": "000000",
      "profile_background_image_url": "http://abs.twimg.com/images/themes/theme1/bg.png",
      "profile_background_image_url_https": "https://abs.twimg.com/images/themes/theme1/bg.png",
      "profile_background_tile": false,
      "profile_link_color": "F58EA8",
      "profile_sidebar_border_color": "000000",
      "profile_sidebar_fill_color": "000000",
      "profile_text_color": "000000",
      "profile_use_background_image": false,
      "profile_image_url": "http://pbs.twimg.com/profile_images/956172776506761217/TCBwtjU1_normal.jpg",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/956172776506761217/TCBwtjU1_normal.jpg",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/785503802761682944/1516948135",
      "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,
    "quote_count": 15,
    "reply_count": 1,
    "retweet_count": 4119,
    "favorite_count": 1610,
    "entities": {
      "hashtags": [
        {
          "text": "백현",
          "indices": [
            11,
            14
          ]
        },
        {
          "text": "BAEKHYUN",
          "indices": [
            15,
            24
          ]
        },
        {
          "text": "iHeartAwards",
          "indices": [
            36,
            49
          ]
        },
        {
          "text": "BestFanArmy",
          "indices": [
            50,
            62
          ]
        },
        {
          "text": "EXOL",
          "indices": [
            63,
            68
          ]
        }
      ],
      "urls": [],
      "user_mentions": [
        {
          "screen_name": "weareoneEXO",
          "name": "EXO",
          "id": 873115441303924700,
          "id_str": "873115441303924736",
          "indices": [
            69,
            81
          ]
        }
      ],
      "symbols": [],
      "media": [
        {
          "id": 968129121061490700,
          "id_str": "968129121061490690",
          "indices": [
            82,
            105
          ],
          "media_url": "http://pbs.twimg.com/media/DW98TmWU0AItmlv.jpg",
          "media_url_https": "https://pbs.twimg.com/media/DW98TmWU0AItmlv.jpg",
          "url": "https://t.co/hg7I3xAlBg",
          "display_url": "pic.twitter.com/hg7I3xAlBg",
          "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
          "type": "photo",
          "sizes": {
            "thumb": {
              "w": 150,
              "h": 150,
              "resize": "crop"
            },
            "medium": {
              "w": 800,
              "h": 1200,
              "resize": "fit"
            },
            "small": {
              "w": 453,
              "h": 680,
              "resize": "fit"
            },
            "large": {
              "w": 1000,
              "h": 1500,
              "resize": "fit"
            }
          }
        }
      ]
    },
    "extended_entities": {
      "media": [
        {
          "id": 968129121061490700,
          "id_str": "968129121061490690",
          "indices": [
            82,
            105
          ],
          "media_url": "http://pbs.twimg.com/media/DW98TmWU0AItmlv.jpg",
          "media_url_https": "https://pbs.twimg.com/media/DW98TmWU0AItmlv.jpg",
          "url": "https://t.co/hg7I3xAlBg",
          "display_url": "pic.twitter.com/hg7I3xAlBg",
          "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
          "type": "photo",
          "sizes": {
            "thumb": {
              "w": 150,
              "h": 150,
              "resize": "crop"
            },
            "medium": {
              "w": 800,
              "h": 1200,
              "resize": "fit"
            },
            "small": {
              "w": 453,
              "h": 680,
              "resize": "fit"
            },
            "large": {
              "w": 1000,
              "h": 1500,
              "resize": "fit"
            }
          }
        },
        {
          "id": 968129133724053500,
          "id_str": "968129133724053505",
          "indices": [
            82,
            105
          ],
          "media_url": "http://pbs.twimg.com/media/DW98UVhUMAE-81s.jpg",
          "media_url_https": "https://pbs.twimg.com/media/DW98UVhUMAE-81s.jpg",
          "url": "https://t.co/hg7I3xAlBg",
          "display_url": "pic.twitter.com/hg7I3xAlBg",
          "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
          "type": "photo",
          "sizes": {
            "medium": {
              "w": 800,
              "h": 1200,
              "resize": "fit"
            },
            "large": {
              "w": 1000,
              "h": 1500,
              "resize": "fit"
            },
            "thumb": {
              "w": 150,
              "h": 150,
              "resize": "crop"
            },
            "small": {
              "w": 453,
              "h": 680,
              "resize": "fit"
            }
          }
        },
        {
          "id": 968129145354952700,
          "id_str": "968129145354952704",
          "indices": [
            82,
            105
          ],
          "media_url": "http://pbs.twimg.com/media/DW98VA2VoAAdEU4.jpg",
          "media_url_https": "https://pbs.twimg.com/media/DW98VA2VoAAdEU4.jpg",
          "url": "https://t.co/hg7I3xAlBg",
          "display_url": "pic.twitter.com/hg7I3xAlBg",
          "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
          "type": "photo",
          "sizes": {
            "thumb": {
              "w": 150,
              "h": 150,
              "resize": "crop"
            },
            "small": {
              "w": 453,
              "h": 680,
              "resize": "fit"
            },
            "medium": {
              "w": 800,
              "h": 1200,
              "resize": "fit"
            },
            "large": {
              "w": 1000,
              "h": 1500,
              "resize": "fit"
            }
          }
        },
        {
          "id": 968129158457966600,
          "id_str": "968129158457966593",
          "indices": [
            82,
            105
          ],
          "media_url": "http://pbs.twimg.com/media/DW98VxqVwAE_IM3.jpg",
          "media_url_https": "https://pbs.twimg.com/media/DW98VxqVwAE_IM3.jpg",
          "url": "https://t.co/hg7I3xAlBg",
          "display_url": "pic.twitter.com/hg7I3xAlBg",
          "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
          "type": "photo",
          "sizes": {
            "medium": {
              "w": 800,
              "h": 1200,
              "resize": "fit"
            },
            "thumb": {
              "w": 150,
              "h": 150,
              "resize": "crop"
            },
            "large": {
              "w": 1000,
              "h": 1500,
              "resize": "fit"
            },
            "small": {
              "w": 453,
              "h": 680,
              "resize": "fit"
            }
          }
        }
      ]
    },
    "favorited": false,
    "retweeted": false,
    "possibly_sensitive": false,
    "filter_level": "low",
    "lang": "ko"
  },
  "is_quote_status": false,
  "quote_count": 0,
  "reply_count": 0,
  "retweet_count": 0,
  "favorite_count": 0,
  "entities": {
    "hashtags": [
      {
        "text": "백현",
        "indices": [
          30,
          33
        ]
      },
      {
        "text": "BAEKHYUN",
        "indices": [
          34,
          43
        ]
      },
      {
        "text": "iHeartAwards",
        "indices": [
          55,
          68
        ]
      },
      {
        "text": "BestFanArmy",
        "indices": [
          69,
          81
        ]
      },
      {
        "text": "EXOL",
        "indices": [
          82,
          87
        ]
      }
    ],
    "urls": [],
    "user_mentions": [
      {
        "screen_name": "honeydrop_506",
        "name": "HONEY DROP 🍯",
        "id": 785503802761683000,
        "id_str": "785503802761682944",
        "indices": [
          3,
          17
        ]
      },
      {
        "screen_name": "weareoneEXO",
        "name": "EXO",
        "id": 873115441303924700,
        "id_str": "873115441303924736",
        "indices": [
          88,
          100
        ]
      }
    ],
    "symbols": [],
    "media": [
      {
        "id": 968129121061490700,
        "id_str": "968129121061490690",
        "indices": [
          101,
          124
        ],
        "media_url": "http://pbs.twimg.com/media/DW98TmWU0AItmlv.jpg",
        "media_url_https": "https://pbs.twimg.com/media/DW98TmWU0AItmlv.jpg",
        "url": "https://t.co/hg7I3xAlBg",
        "display_url": "pic.twitter.com/hg7I3xAlBg",
        "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
        "type": "photo",
        "sizes": {
          "thumb": {
            "w": 150,
            "h": 150,
            "resize": "crop"
          },
          "medium": {
            "w": 800,
            "h": 1200,
            "resize": "fit"
          },
          "small": {
            "w": 453,
            "h": 680,
            "resize": "fit"
          },
          "large": {
            "w": 1000,
            "h": 1500,
            "resize": "fit"
          }
        },
        "source_status_id": 968130023566684200,
        "source_status_id_str": "968130023566684160",
        "source_user_id": 785503802761683000,
        "source_user_id_str": "785503802761682944"
      }
    ]
  },
  "extended_entities": {
    "media": [
      {
        "id": 968129121061490700,
        "id_str": "968129121061490690",
        "indices": [
          101,
          124
        ],
        "media_url": "http://pbs.twimg.com/media/DW98TmWU0AItmlv.jpg",
        "media_url_https": "https://pbs.twimg.com/media/DW98TmWU0AItmlv.jpg",
        "url": "https://t.co/hg7I3xAlBg",
        "display_url": "pic.twitter.com/hg7I3xAlBg",
        "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
        "type": "photo",
        "sizes": {
          "thumb": {
            "w": 150,
            "h": 150,
            "resize": "crop"
          },
          "medium": {
            "w": 800,
            "h": 1200,
            "resize": "fit"
          },
          "small": {
            "w": 453,
            "h": 680,
            "resize": "fit"
          },
          "large": {
            "w": 1000,
            "h": 1500,
            "resize": "fit"
          }
        },
        "source_status_id": 968130023566684200,
        "source_status_id_str": "968130023566684160",
        "source_user_id": 785503802761683000,
        "source_user_id_str": "785503802761682944"
      },
      {
        "id": 968129133724053500,
        "id_str": "968129133724053505",
        "indices": [
          101,
          124
        ],
        "media_url": "http://pbs.twimg.com/media/DW98UVhUMAE-81s.jpg",
        "media_url_https": "https://pbs.twimg.com/media/DW98UVhUMAE-81s.jpg",
        "url": "https://t.co/hg7I3xAlBg",
        "display_url": "pic.twitter.com/hg7I3xAlBg",
        "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
        "type": "photo",
        "sizes": {
          "medium": {
            "w": 800,
            "h": 1200,
            "resize": "fit"
          },
          "large": {
            "w": 1000,
            "h": 1500,
            "resize": "fit"
          },
          "thumb": {
            "w": 150,
            "h": 150,
            "resize": "crop"
          },
          "small": {
            "w": 453,
            "h": 680,
            "resize": "fit"
          }
        },
        "source_status_id": 968130023566684200,
        "source_status_id_str": "968130023566684160",
        "source_user_id": 785503802761683000,
        "source_user_id_str": "785503802761682944"
      },
      {
        "id": 968129145354952700,
        "id_str": "968129145354952704",
        "indices": [
          101,
          124
        ],
        "media_url": "http://pbs.twimg.com/media/DW98VA2VoAAdEU4.jpg",
        "media_url_https": "https://pbs.twimg.com/media/DW98VA2VoAAdEU4.jpg",
        "url": "https://t.co/hg7I3xAlBg",
        "display_url": "pic.twitter.com/hg7I3xAlBg",
        "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
        "type": "photo",
        "sizes": {
          "thumb": {
            "w": 150,
            "h": 150,
            "resize": "crop"
          },
          "small": {
            "w": 453,
            "h": 680,
            "resize": "fit"
          },
          "medium": {
            "w": 800,
            "h": 1200,
            "resize": "fit"
          },
          "large": {
            "w": 1000,
            "h": 1500,
            "resize": "fit"
          }
        },
        "source_status_id": 968130023566684200,
        "source_status_id_str": "968130023566684160",
        "source_user_id": 785503802761683000,
        "source_user_id_str": "785503802761682944"
      },
      {
        "id": 968129158457966600,
        "id_str": "968129158457966593",
        "indices": [
          101,
          124
        ],
        "media_url": "http://pbs.twimg.com/media/DW98VxqVwAE_IM3.jpg",
        "media_url_https": "https://pbs.twimg.com/media/DW98VxqVwAE_IM3.jpg",
        "url": "https://t.co/hg7I3xAlBg",
        "display_url": "pic.twitter.com/hg7I3xAlBg",
        "expanded_url": "https://twitter.com/honeydrop_506/status/968130023566684160/photo/1",
        "type": "photo",
        "sizes": {
          "medium": {
            "w": 800,
            "h": 1200,
            "resize": "fit"
          },
          "thumb": {
            "w": 150,
            "h": 150,
            "resize": "crop"
          },
          "large": {
            "w": 1000,
            "h": 1500,
            "resize": "fit"
          },
          "small": {
            "w": 453,
            "h": 680,
            "resize": "fit"
          }
        },
        "source_status_id": 968130023566684200,
        "source_status_id_str": "968130023566684160",
        "source_user_id": 785503802761683000,
        "source_user_id_str": "785503802761682944"
      }
    ]
  },
  "favorited": false,
  "retweeted": false,
  "possibly_sensitive": false,
  "filter_level": "low",
  "lang": "ko",
  "timestamp_ms": "1519765900661"
}

{
  "delete": {
    "status": {
      "id": 220753647653494800,
      "id_str": "220753647653494784",
      "user_id": 243513309,
      "user_id_str": "243513309"
    },
    "timestamp_ms": "1519765900931"
  }
}
```</https:>