Skip to main content

​
Stream Monitors

Stream Monitors watch specific Twitter accounts and notify you when they tweet, reply, retweet, or quote tweet. Monitors poll at a global interval (100ms default) with volume-based pricing.

​
Quick start

​
Features

  • Up to 100 accounts per monitor
  • Tweet type filtering: original, reply, retweet, quote
  • Webhook delivery with HMAC-SHA256 signing
  • WebSocket delivery for real-time streaming
  • Auto-pause when credits run low
  • Volume pricing — the more accounts you monitor, the lower the per-account cost

​
Volume pricing tiers

Pricing tiers are applied per-monitor based on the number of usernames. Pricing can be fetched dynamically via the dashboard stream pricing endpoint.

​
Monitor lifecycle

  1. Active — Monitor is polling and delivering tweets
  2. Paused — Manually paused via API or dashboard
  3. Suspended — Auto-paused due to insufficient credits (status_reason: "insufficient_credits")

​
Shadow account warning

Newly registered or long-dormant Twitter accounts may be shadow-banned, causing searches to return no results. Before adding a username to a monitor, verify it is not shadow-banned: Visit https://x.com/search?q=from:USERNAME&src=typed_query&f=live — if it returns no results for an active poster, the account is likely shadow-banned.

​
API endpoints

Create Monitor

POST /v1/twitter/stream/monitors

List Monitors

GET /v1/twitter/stream/monitors

Get Monitor

GET /v1/twitter/stream/monitors/

Update Monitor

PATCH /v1/twitter/stream/monitors/

Delete Monitor

DELETE /v1/twitter/stream/monitors/