live-earnings

Python client for the Live Earnings API: live earnings-call transcripts, each turn's text as it is spoken and then who said it. Python 3.9+.

Install

pip install live-earnings

Quickstart

Your API key (ek_…) covers one call; copy it from the call's API Access tab on https://live-earnings.com/live. Run with LE_KEY=ek_… SLUG=<call-slug>:

import os

from live_earnings import LiveEarningsClient, Transcript

client = LiveEarningsClient(token=os.environ["LE_KEY"])
slug = os.environ["SLUG"]
transcript = Transcript()


def show(turn):
    if turn:
        print(f"{turn.name or '…'}: {turn.text or ''}")


# Everything so far, then live until the call ends.
last = None  # the last seq seen; None = start the stream from now
ended = False
for env in client.events(slug):
    show(transcript.apply(env))
    last = env.seq
    ended = ended or env.event.type == "done"
if not ended:
    for env in client.stream(slug, last_event_id=last):
        if env.event.type == "done":
            break
        show(transcript.apply(env))

A turn prints once when its text arrives (…: text) and again when its speaker is named. Transcript applies the rules: a person's correction beats the model's name, new_name == "unknown" leaves a turn unnamed, basis == "early" marks a provisional name, and a repeated envelope is ignored. apply() returns the turn itself, updated in place as later events arrive.

The client

Hosts default to https://live-earnings.com (REST) and https://stream.live-earnings.com (streams); override with base_url and stream_url. Both must be https:// unless you pass allow_insecure=True for local development. Errors raise LiveEarningsError (status, body).

Full reference: https://live-earnings.com/live/docs

Changes

0.4.0 — Default hosts (base_url is optional; streams go to the stream host). Transcript folds events into turns. session_token(). events() takes an optional range. Streams deliver each message as it arrives (they were buffered in 512-byte reads). AiInsightEvent is deprecated — the API does not currently send it.

0.3.0 — UnknownEvent.naming == "pending" (the name follows as a TurnSpeakerAmendEvent); amends carry by and may carry basis == "early".

0.2.0 — stt_speaker_change on AttributionEvent and UnknownEvent; ai_insight and turn_speaker_amend decode to their own classes.