v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB

Filter Rules

Get filter rule

Retrieve details of a specific filter rule by its ID. Returns full rule configuration, status, and pricing information.

get/v1/twitter/stream/filter-rules/{rule_id}

Path parameters

rule_idstring required

The unique ID of the filter rule.

Response

Successfully retrieved filter rule.

idstring required

Unique filter rule identifier.

tagstring required

Human-readable label for the rule.

querystring required

Twitter Advanced Search query.

interval_secondsnumber required

Polling interval in seconds.

max_results_per_pollinteger required

Maximum number of tweets returned per poll cycle.

status'active' | 'paused' | 'suspended' required

Current status of the rule. Suspended indicates the rule was auto-paused due to insufficient credits.

status_reasonstring nullable

Reason for the current status, if applicable.

webhook_urlstring nullable

HTTPS URL receiving webhook deliveries.

webhook_secret_setboolean

Whether a webhook secret is configured. The actual secret is never returned.

credits_per_rule_per_daynumber

Credit cost per day for this rule at the current interval.

pricing_tierstring

Current pricing tier label based on interval.

created_atstring date-time required

Timestamp when the rule was created.

updated_atstring date-time required

Timestamp when the rule was last updated.

Example response

{
  "tag": "AI news tracker",
  "query": "(\"artificial intelligence\" OR \"machine learning\") min_faves:100 lang:en",
  "interval_seconds": 60,
  "max_results_per_poll": 20,
  "pricing_tier": "1-minute"
}