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.