v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB

Stream Monitors

Get stream monitor

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

get/v1/twitter/stream/monitors/{monitor_id}

monitor_idstring required

The unique ID of the stream monitor.

Successfully retrieved stream monitor.

idstring required

Unique stream monitor identifier.

namestring required

Human-readable name of the monitor.

usernamesstring[] required

List of monitored Twitter usernames.

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

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

status_reasonstring nullable

Reason for the current status, if applicable (e.g., "insufficient_credits").

webhook_urlstring nullable

HTTPS URL receiving webhook deliveries.

webhook_secret_setboolean

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

filter_typesstring[] nullable

Tweet types being delivered. Null means all types.

credits_per_account_per_daynumber

Credit cost per monitored account per day.

estimated_credits_per_daynumber

Estimated total credit cost per day based on current account count.

pricing_tierstring

Current pricing tier label.

created_atstring date-time required

Timestamp when the monitor was created.

updated_atstring date-time required

Timestamp when the monitor was last updated.

{
  "name": "Tech Leaders Monitor",
  "usernames": [
    "elonmusk",
    "sama"
  ],
  "pricing_tier": "Standard"
}