Skip to main content

News Data Response

Receive real-time news articles through the news:data event.
Response Structure:
Response Fields:
  • type - Event type (“news”)
  • data - News data object containing news array, hasMore, nextCursor, total
  • timestamp - Server transmission time
  • isRealTimeUpdate - Whether this is a real-time update

Connection Status Response

Monitor connection health and usage statistics.
Response Structure:
Status Fields:
  • status - Connection state (connected, disconnected, limited)
  • connectionsUsed - Current active connections
  • maxConnections - Plan connection limit
  • plan - Subscription plan type
  • rateLimit - Rate limiting information

Subscription Confirmation

Receive confirmation when subscriptions are activated.
Response Structure:
Confirmation Fields:
  • type - Subscription type
  • params - Applied filter settings
  • message - Confirmation message

Batch News Response

Large news updates may be delivered as batches.
Batch Structure:
Batch Fields:
  • batchId - Unique batch identifier
  • totalArticles - Total articles in batch
  • reason - Batching reason (high_volume, scheduled)

Ping Response

Server may send ping messages to check connection health.
Ping Structure:

Response Handling Best Practices

Type Checking

Always validate response structure:

Error Handling

Handle malformed responses gracefully:

Response Logging

Log responses for debugging: