Twitter Streams

Twitter Streams Reference

Monitor Twitter in real-time with two complementary approaches: account-based Stream Monitors and query-based Filter Rules. Receive new tweets via WebSocket or webhook delivery.

20+

Endpoints

Monitor Types

Real-Time

HMAC

Signed Webhooks

How It Works

1. Create a Stream Monitor (track accounts) or Filter Rule (track search queries)
2. Our system polls Twitter at sub-second intervals
3. New tweets are deduplicated and delivered via:
   - WebSocket (real-time push, <1s latency)
   - Webhook (HMAC-SHA256 signed HTTP POST)
4. You pay per-account-per-day (monitors) or per-rule-per-day (filter rules)

Documentation

Stream Monitors

11 endpoints

Monitor specific Twitter accounts in real-time. Get notified when they tweet, reply, retweet, or quote.

Filter Rules

9 endpoints

Monitor arbitrary Twitter search queries. Use Advanced Search syntax to match tweets in real-time.

WebSocket

Connect via WebSocket to receive real-time tweet events as they are detected.

Webhooks

Receive HMAC-SHA256 signed HTTP POST callbacks for each detected tweet.

Stream Monitors vs Filter Rules

Aspect	Stream Monitors	Filter Rules
Input	List of Twitter usernames	Twitter search query string
Use case	Track specific accounts	Track keywords, hashtags, topics
Polling	Global interval (platform-wide)	Per-rule configurable interval
Billing	Per-account-per-day (volume tiers)	Per-rule-per-day (interval tiers)
Delivery	WebSocket + Webhook	WebSocket + Webhook
Deduplication	Per-author (Redis sorted set)	Per-rule (Redis sorted set)