wss://scrapebadger.com/v1/twitter/stream?api_key=YOUR_API_KEY

npm install -g wscat
wscat -c "wss://scrapebadger.com/v1/twitter/stream?api_key=YOUR_API_KEY"

import asyncio
import json

import websockets

URI = "wss://scrapebadger.com/v1/twitter/stream?api_key=YOUR_API_KEY"

async def listen():
    backoff = 1
    while True:
        try:
            async with websockets.connect(URI) as ws:
                backoff = 1
                async for message in ws:
                    event = json.loads(message)
                    if event["type"] == "ping":
                        await ws.send(json.dumps({"type": "pong"}))
                    elif event["type"] == "connected":
                        pass  # backfill anything missed while disconnected (see below)
                    elif event["type"] == "tweet":
                        print(f"@{event['author_username']}: {event['tweet_id']}")
        except (websockets.ConnectionClosed, OSError):
            await asyncio.sleep(backoff)
            backoff = min(backoff * 2, 30)

asyncio.run(listen())

const WebSocket = require('ws');

function connect(backoff = 1000) {
  const ws = new WebSocket(
    'wss://scrapebadger.com/v1/twitter/stream?api_key=YOUR_API_KEY'
  );

  ws.on('open', () => { backoff = 1000; });

  ws.on('message', (data) => {
    const event = JSON.parse(data);
    if (event.type === 'ping') {
      ws.send(JSON.stringify({ type: 'pong' }));
    } else if (event.type === 'tweet') {
      console.log(`@${event.author_username}: ${event.tweet_id}`);
    }
  });

  ws.on('close', () => {
    setTimeout(() => connect(Math.min(backoff * 2, 30000)), backoff);
  });
  ws.on('error', console.error);
}

connect();

{
  "type": "tweet",
  "monitor_id": "abc-123",
  "tweet_id": "1234567890",
  "author_username": "elonmusk",
  "tweet_type": "original",
  "tweet_published_at": "2026-03-13T12:00:00+00:00",
  "detected_at": "2026-03-13T12:00:00.150000+00:00",
  "latency_ms": 150,
  "tweet": { "...": "full tweet object" }
}

curl "https://scrapebadger.com/v1/twitter/stream/logs?delivery_status=pending&page_size=100" \
  -H "X-API-Key: YOUR_API_KEY"