POST statuses/filter

Updated on Mon, 2013-04-01 11:04

Returns public statuses 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 elevated access to the Streaming API, you should explore our partner providers of Twitter data here.

Resource URL

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

Parameters

*Note: At least one predicate parameter (follow, locations, or track) must be specified.

follow see note*

A comma separated list of user IDs, indicating the users to return statuses for in the stream. See the follow parameter documentation for more information.

track see note*

Keywords to track. Phrases of keywords are specified by a comma-separated list. See the track parameter documentation for more information.

locations see note*

Specifies a set of bounding boxes to track. See the locations parameter documentation for more information.

delimited optional

Specifies whether messages should be length-delimited. See the delimited parameter documentation for more information.

stall_warnings optional

Specifies whether stall warnings should be delivered. See the stall_warnings parameter documentation for more information.

Example Request

POST

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

POST Data

track=twitter