POST statuses/filter
Returns public Tweets that match one or more filter predicates. Multiple parameters may be specified which allows most clients to use a single connection to the Streaming API. Both GET and POST requests are supported, but GET requests with too many parameters may cause the request to be rejected for excessive URL length. Use a POST request to avoid long URLs.
The track, follow, and locations fields should be considered to be
combined with an OR operator. track=foo&follow=1234
returns Tweets matching "foo" OR created by user 1234.
The default access level allows up to 400 track keywords, 5,000 follow userids and 25 0.1-360 degree location boxes. If you need access to more rules and filtering tools, please apply for enterprise access.
Resource URL¶
https://stream.twitter.com/1.1/statuses/filter.json
Resource Information¶
| Response formats | JSON |
| Requires authentication? | Yes (user context only) |
| Rate limited? | Yes |
| Supports Edit Tweets feature? | No |
Parameters¶
| Name | Required | Description |
| follow | optional | A comma separated list of user IDs, indicating the users to return statuses for in the stream. See follow for more information. |
| track | optional | Keywords to track. Phrases of keywords are specified by a comma-separated list. See track for more information. |
| locations | optional | Specifies a set of bounding boxes to track. See locations for more information. |
| delimited | optional | Specifies whether messages should be length-delimited. See delimited for more information. |
| stall_warnings | optional | Specifies whether stall warnings should be delivered. See stall_warnings for more information. |
| include_ext_edit_control | optional | Must be set to true in order to return edited Tweet metadata as part of the Tweet object. |
Example Request¶
GET https://stream.twitter.com/1.1/statuses/filter.json?track=twitter
TMZ Celebrity News – Breaking Stories, Videos & Gossip
Looking for the latest TMZ celebrity news? You've come to the right place. From shocking Hollywood scandals to exclusive videos, TMZ delivers it all in real time.
Whether it’s a red carpet slip-up, a viral paparazzi moment, or a legal drama involving your favorite stars, TMZ news is always first to break the story. Stay in the loop with daily updates, insider tips, and jaw-dropping photos.
🎥 Watch TMZ Live
TMZ Live brings you daily celebrity news and interviews straight from the TMZ newsroom. Don’t miss a beat—watch now and see what’s trending in Hollywood.
- Exclusive TMZ interviews and court updates
- Viral celebrity videos and candid photos
- Trending gossip and entertainment news