Interested in exploring Labs?
The endpoints we release in Labs are previews of tools that may be released more broadly in the future, but will likely undergo changes before then. We encourage you to take that into consideration as you explore. Before getting started, please read more about Twitter Developer Labs.

GET /labs/1/tweets/stream/filter/rules

Return a list of filter rules currently active on the streaming endpoint, either as a list or individually.

Authentication and rate limits

Authentication methods
supported by this endpoint

OAuth 2.0 Bearer token

Rate limit 450 requests per 15-minute window

Learn more about rate limits.

Query parameters

Name Type Description
string Comma-separated list of rule IDs. If omitted, all rules are returned.


  • cURL
curl -X GET -H "Authorization: Bearer $BEARER_TOKEN" ",1165037377523306497"


  • Response
  "data": [
      "id": "1165037377523306497",
      "value": "dog has:images",
      "tag": "dog pictures"
      "id": "1165037377523306498",
      "value": "cat has:images -grumpy"
  "meta": {
    "sent": "2019-08-29T01:12:10.729Z"

Response fields

idstringUnique identifier of this rule. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
valuestringThe rule text as submitted when creating the filter.
tagstringThe tag label as defined when creating the filter.
meta.sentdate (ISO 8601)The time when the request body was returned.
errorsobjectContains details about errors that affected any of the requested Tweets. See Status codes and error messages for more details.