Source reference
Twitter WebSocket API for Real-Time X Alerts
The 1322 Twitter WebSocket API is a real-time monitoring service that streams new tweets, profile changes, and account activity for a custom list of X (formerly Twitter) handles, typically delivering events within 150-250ms of publication. It is a practical alternative to the retired Twitter Streaming API and to expensive enterprise firehose access: posts arrive as structured JSON events containing the tweet text, media, engagement metrics, author profile, and the full reply or quote chain, while a REST API handles tracked-account management. No Twitter developer account is required, and plans start from $250 per month.
- Source
- X (Twitter)
- Delivery
- X plans include a source-specific WebSocket stream and REST account management. Discord, Telegram, and signed-webhook routes depend on account configuration and enabled features.
- Manage
- REST, dashboard, or Discord
What 1322 monitors on Twitter WebSocket API for Real-Time X Alerts
- New tweets, delivered progressively (mini → update → expanded → full) so you get the earliest signal then the enriched version
- Replies, quote tweets, and retweets with the referenced/nested post
- Profile updates (name, bio, avatar, banner, verification)
- Follow / unfollow events
- Tweet deletions and pin / unpin changes
- Two delivery lanes: Normal and Ultimate (lower-latency)
How the event moves
Real-time delivery: X plans include a source-specific WebSocket stream and REST account management. Discord, Telegram, and signed-webhook routes depend on account configuration and enabled features. Base URL https://api.1322.io. The feed is filtered to the accounts on your tracked list; manage that list through REST, Discord, or the dashboard.
Example tweet event (trimmed)
{
"platform": "x",
"eventType": "tweet.full",
"handle": "example",
"content": "gm",
"media": [{ "kind": "image", "url": "https://…" }],
"metrics": { "likes": 12, "retweets": 3, "replies": 1 },
"timestamp": "2026-06-07T12:00:00Z"
}Cybertruck production ramping hard.
The same normalized event is rendered in the hosted live feed.
X-Ultimate (lower-latency lane) is provisioned manually, contact sales. It is intentionally not a self-serve checkout option.
Common questions
How fast are events?
Typically 150-250ms from when the tweet appears to when you receive it.
WebSocket or REST?
Both. Use the WebSocket for push delivery and the REST API to manage tracked accounts and fetch state.
How do I choose which accounts to track?
Manage your tracked-account list via the REST API, the Discord bot, or the dashboard. The stream auto-updates to match.
Can I get historical tweets / backfill?
No. 1322 is a real-time stream, events are not queued while your client is disconnected. Reconnect with backoff and respond to pings to stay connected.
What's the difference between Normal and Ultimate?
Ultimate is a lower-latency lane. It is set up manually, contact sales; it is not a self-serve checkout option.
How many accounts can I track?
Up to your plan's account limit. See pricing.
How is it authenticated?
An API key via the X-API-Key header (or Bearer token) per request / WebSocket connection.
How are events delivered?
X plans include a source-specific WebSocket stream and REST account management. Discord, Telegram, and signed-webhook routes depend on account configuration and enabled features.
Is this an X Filtered Stream alternative?
It can be. X currently offers the official API v2 Filtered Stream under pay-per-use pricing. 1322 is a managed, flat-plan option for a selected account list, with its own WebSocket and REST management contract.
Does it work with the Twitter API v2?
1322 is independent of the official Twitter API, you don't need a Twitter developer account, elevated access, or per-request quotas. One API key, one WebSocket.