Skip to main content

Connection

Connect to the WebSocket endpoint with your API key as a query parameter:
WebSocket streaming is available on the Pro (50/mo)andMax(50/mo) and **Max** (100/mo) plans. Starter plan users will receive a connection rejection.

Firehose

The WebSocket is a firehose — once connected, all articles are pushed to you automatically as they arrive. There is no subscription step and no filtering. You receive everything.

Connection Limit

Each user is limited to 1 concurrent WebSocket connection. If you attempt to open a second connection, it will be rejected with close code 1008. Close your existing connection before opening a new one.

Message Format

Each message is a JSON object matching the article schema:

Reconnection

The server may close connections periodically. Implement automatic reconnection with exponential backoff:

Disconnection

The connection closes when:
  • Your plan does not include streaming — Starter (close code 1008)
  • You already have an active connection (close code 1008)
  • Invalid API key (close code 1008)
  • Server maintenance (implement auto-reconnect)