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#

from datetime import date

import earningscall

# List every tracked company
for company in earningscall.get_all_companies():
    print(company.company_info.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_transcript(year=2024, quarter=1)
print(transcript.text[:200])

# Speaker-level segmentation (requires Enhanced Transcript plan)
transcript = company.get_transcript(year=2024, quarter=1, level=2)
for turn in transcript.speakers:
    print(turn.speaker_info.name, "-", turn.text[:80])

# Earnings calendar for a single date
for event in earningscall.get_calendar(date(2025, 1, 10)):
    print(event.symbol, event.company_name)

# Save the audio file (requires Audio Access plan)
company.download_audio_file(year=2024, quarter=1, file_name="aapl_q1.mp3")

from datetime import date

import earningscall

# List every tracked company
for company in earningscall.get_all_companies():
    print(company.company_info.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_transcript(year=2024, quarter=1)
print(transcript.text[:200])

# Speaker-level segmentation (requires Enhanced Transcript plan)
transcript = company.get_transcript(year=2024, quarter=1, level=2)
for turn in transcript.speakers:
    print(turn.speaker_info.name, "-", turn.text[:80])

# Earnings calendar for a single date
for event in earningscall.get_calendar(date(2025, 1, 10)):
    print(event.symbol, event.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 calls require which plan tiers — for example get_transcript with level=2 or higher needs an Enhanced Transcript plan, and download_audio_file needs Audio Access.