Docs

🔌 WebSocket Real-Time Monitoring

get

Real-Time Tweet Monitoring

Receive instant notifications when new tweets are detected from your monitored profiles.

🚀 Quick Start

JavaScript

// 1. Include SignalR library
<script src="https://cdnjs.cloudflare.com/ajax/libs/microsoft-signalr/8.0.0/signalr.min.js"></script>

// 2. Connect to WebSocket
const connection = new signalR.HubConnectionBuilder()
  .withUrl('https://api.twtmonitor.com/hub/monitoring')
  .withAutomaticReconnect()
  .build();

// 3. Listen for new tweets
connection.on('NewTweet', (tweet) => {
  console.log('🐦 New Tweet:', tweet);
});

// 4. Connect and subscribe
connection.start()
  .then(() => connection.invoke('SubscribeToMonitoring', 'YOUR_API_KEY'))
  .then(() => console.log('✅ Connected!'));

C#

using Microsoft.AspNetCore.SignalR.Client;

var connection = new HubConnectionBuilder()
    .WithUrl("https://api.twtmonitor.com/hub/monitoring")
    .WithAutomaticReconnect()
    .Build();

connection.On<object>("NewTweet", tweet => 
    Console.WriteLine($"🐦 New Tweet: {tweet}"));

await connection.StartAsync();
await connection.InvokeAsync("SubscribeToMonitoring", "YOUR_API_KEY");

Python

from signalrcore.hub_connection_builder import HubConnectionBuilder

connection = HubConnectionBuilder()\
    .with_url("https://api.twtmonitor.com/hub/monitoring")\
    .with_automatic_reconnect()\
    .build()

connection.on("NewTweet", lambda tweet: print(f"🐦 New Tweet: {tweet}"))
connection.on_open(lambda: connection.invoke("SubscribeToMonitoring", "YOUR_API_KEY"))

connection.start()

📡 Endpoint

URL: wss://api.twtmonitor.com/hub/monitoring

📨 Events

`NewTweet`

Fired when a new tweet is detected.

Payload:

{
  "id": 123,
  "tweetId": "1234567890",
  "profileId": 5,
  "handle": "elonmusk",
  "content": "Tweet content...",
  "imageUrls": ["https://..."],
  "detectedAt": "2025-11-08T06:30:00Z",
  "createdAt": "2025-11-08T06:29:55Z"
}

`Connected`

Confirmation that you're subscribed.

Payload:

{
  "message": "Conectado al monitoreo de 5 perfiles",
  "status": "active",
  "profilesCount": 5
}

🔄 Handling Disconnections

connection.onreconnecting(() => console.log('⚠️ Reconnecting...'));
connection.onreconnected(() => console.log('✅ Reconnected!'));
connection.onclose(() => console.log('❌ Disconnected'));

📦 Full Example (HTML)

<!DOCTYPE html>
<html>
<head>
  <title>Tweet Monitor</title>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/microsoft-signalr/8.0.0/signalr.min.js"></script>
</head>
<body>
  <h1>Real-Time Tweets</h1>
  <div id="tweets"></div>

  <script>
    const connection = new signalR.HubConnectionBuilder()
      .withUrl('https://api.twtmonitor.com/hub/monitoring')
      .withAutomaticReconnect()
      .build();

    connection.on('NewTweet', (tweet) => {
      const div = document.createElement('div');
      div.textContent = `@${tweet.handle}: ${tweet.content}`;
      document.getElementById('tweets').prepend(div);
    });

    connection.start()
      .then(() => connection.invoke('SubscribeToMonitoring', 'YOUR_API_KEY'))
      .then(() => console.log('✅ Connected!'));
  </script>
</body>
</html>

⚡ Performance

Latency: ~5-15ms
Auto-reconnect: Enabled
Multiple profiles: All monitored profiles included

Need help? Check our full documentation or contact support.

Authorizations

X-API-KeystringRequired

Your unique API Key for authentication

Responses

200

No content

get

/websocket

GET /websocket HTTP/1.1
Host: api.twtmonitor.com
X-API-Key: YOUR_API_KEY
Accept: */*

200