Transcripts Stream

​

Overview

​

Key Features

• Live Transcription: Get real-time sentence updates as speakers talk during earnings calls
• Word-Level Timing: Each sentence includes individual word timestamps and confidence scores
• Speaker Identification: Track who is speaking (executives, analysts, etc.)
• Status Tracking: Monitor whether transcripts are in progress or complete
• Flexible Subscription: Subscribe to specific tickers or all transcripts with *
• Mock Testing: Test your integration with mock data when no live calls are active

​

Use Cases

• Build real-time earnings call transcript viewers
• Create live captioning and accessibility tools
• Perform real-time sentiment analysis on earnings calls
• Extract key phrases and metrics as they’re mentioned
• Alert on specific keywords or topics during live calls
• Archive complete transcripts with precise timing data

​

Quick Start

​

Connection URL

wss://api.benzinga.com/api/v1/transcripts/stream?token=YOUR_TOKEN

​

Query Parameters

​

Subscription Commands

​

Subscribe to a Ticker

{
  "action": "subscribe",
  "ticker": "AAPL"
}

​

Subscribe to All Transcripts

{
  "action": "subscribe",
  "ticker": "*"
}

​

Unsubscribe from a Ticker

{
  "action": "unsubscribe",
  "ticker": "AAPL"
}

​

List Active Transcripts

{
  "action": "list"
}

​

Keep Connection Alive

{
  "action": "ping"
}

​

Test with Mock Data

{
  "action": "subscribe",
  "ticker": "AAPL",
  "mock": true
}

​

Message Example

{
  "call_id": "call_123456",
  "transcript_id": "550e8400-e29b-41d4-a716-446655440000",
  "call_title": "Apple Inc. Q4 2024 Earnings Call",
  "sentence": "Revenue for the quarter was 89.5 billion dollars.",
  "start_time": "2024-01-15T16:30:15Z",
  "end_time": "2024-01-15T16:30:19Z",
  "symbol": "AAPL",
  "exchange": "NASDAQ",
  "name": "Apple Inc.",
  "sequence": 42,
  "status": "IN_PROGRESS",
  "speaker": "Tim Cook, CEO",
  "type": "LIVE",
  "language": "en",
  "confidence": 0.98,
  "words": [
    {
      "text": "Revenue",
      "confidence": 0.99,
      "start": 0,
      "end": 450
    },
    {
      "text": "for",
      "confidence": 0.98,
      "start": 450,
      "end": 600
    }
  ],
  "created_time": "2024-01-15T16:30:19Z"
}

​

Key Fields

​

Transcript Status

​

Word-Level Data

{
  "text": "Revenue",
  "confidence": 0.99,
  "start": 0,
  "end": 450
}

• text: The word itself
• confidence: Recognition confidence (0.0 - 1.0)
• start/end: Timing offsets in milliseconds from sentence start

​

Interactive Commands

​

Best Practices

​

Real-Time Display

• Buffer Management: Display sentences in sequence order using the sequence field
• Speaker Formatting: Format differently based on speaker (executives vs analysts)
• Status Indicators: Show visual indicators for IN_PROGRESS vs COMPLETE status

​

Performance

• Wildcard Caution: Using ticker: "*" subscribes to ALL transcripts, which can be high volume
• Targeted Subscriptions: Subscribe only to tickers you need to reduce bandwidth
• Heartbeat: Send ping every 30-60 seconds to maintain connection

​

Data Quality

• Confidence Filtering: Consider ignoring or flagging sentences with low confidence scores
• Word Accuracy: Use word-level confidence to identify uncertain transcriptions
• Language Handling: Check language field for proper text rendering

​

Testing

• Mock Mode: Use mock: true for development when no live calls are active
• Echo Testing: Use echo action to verify connection and message handling
• List Command: Check list to see what’s currently available

​

Example Integration

const ws = new WebSocket(
  'wss://api.benzinga.com/api/v1/transcripts/stream?token=YOUR_TOKEN'
);

ws.onopen = () => {
  // Subscribe to Apple transcripts
  ws.send(JSON.stringify({
    action: 'subscribe',
    ticker: 'AAPL'
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);

  // Display the sentence with speaker
  console.log(`[${data.sequence}] ${data.speaker}: ${data.sentence}`);

  // Check if transcript is complete
  if (data.status === 'COMPLETE') {
    console.log('Transcript finished');
  }
};

// Keep connection alive
setInterval(() => {
  ws.send(JSON.stringify({ action: 'ping' }));
}, 30000);

​

Related Documentation

• WebSocket Introduction - General WebSocket concepts and connection basics
• Authentication - How to obtain and use API tokens