SDKs

Python SDK

Idiomatic Python wrapper around the EarningsCall REST API. Source on GitHub.

Install#

pip install earningscall

Configure#

Set your API key once. Without configuration, the library uses the public demo key.

import earningscall

earningscall.api_key = "YOUR_API_KEY"

Common usage#

import earningscall

# List every tracked company
for company in earningscall.get_all_companies():
    print(company.symbol, company.name)

# Pull events for a single ticker
company = earningscall.get_company("AAPL")
for event in company.events():
    print(event.year, event.quarter, event.conference_date)

# Fetch a transcript (level 1, default)
transcript = company.get_basic_transcript(year=2024, quarter=1)
print(transcript.text[:200])

# Speaker-level segmentation (requires Enhanced Transcript plan)
groups = company.get_speaker_groups(year=2024, quarter=1)
for g in groups.speaker_groups:
    print(g.speaker_info.name, "-", g.text[:80])

# Earnings calendar for a single date
events = earningscall.get_calendar(year=2025, month=1, day=10)
for ev in events:
    print(ev["symbol"], ev["company_name"])

# Save the audio file (requires Audio Access plan)
company.download_audio_file(year=2024, quarter=1, file_name="aapl_q1.mp3")
Note
See Plans for which methods require which plan tiers — for example get_speaker_groups needs an Enhanced Transcript plan, and download_audio_file needs Audio Access.