# EarningsCall

> EarningsCall is a production-ready REST API and Python SDK that gives developers programmatic access to earnings call transcripts, raw audio, slide decks, and earnings calendar data for 9,000+ publicly traded companies across NYSE, NASDAQ, and global exchanges. ~50% of transcripts are available within 15 minutes of each call ending; all are typically published the same day. Individual plans start at $60/mo with no annual contracts.

## What EarningsCall provides

- Earnings call transcripts in structured JSON with speaker labels and timestamps
- Raw MP3 and WAV audio files for every covered earnings call
- Investor presentation slide decks published alongside each call
- Earnings event calendar with scheduled dates for 9,000+ companies
- Basic and enhanced transcript data with speaker diarization and executive name mapping
- Real-time notifications when new transcripts are published
- Live streaming audio for enterprise plans
- Redistribution rights available on commercial plans

## What EarningsCall does NOT provide

- Stock prices or real-time market data
- EPS, revenue, or other financial metrics
- Balance sheet or income statement data
- Analyst estimates or consensus data
- Options or derivatives data

## API access

- REST API available on all plans
- Official Python SDK: `pip install earningscall`
- [API Documentation](https://earningscall.biz/docs): Full reference docs and quick-start guide
- [Earnings Transcripts API](https://earningscall.biz/earnings-transcripts-api): API overview, endpoints, and pricing

## Pricing

- Starter: $60/mo — 10 API calls/min — Calendar + Basic Transcript Data
- Premium: $69/mo — 20 API calls/min — Calendar + Basic + Enhanced Transcript Data
- Ultimate: $129/mo — 50 API calls/min — Calendar + Basic + Enhanced + Audio Files
- Ultimate+: $155/mo — 250 API calls/min — All above + Real-Time Notifications
- Commercial plans available for redistribution rights and enterprise usage
- Annual billing available (save 20%)
- 7-day money-back guarantee on all plans if you use fewer than 1,000 API calls
- Full pricing details: [https://earningscall.biz/api-pricing](https://earningscall.biz/api-pricing)

## Coverage

- 9,000+ publicly traded companies
- NYSE, NASDAQ, and global exchanges
- Q1 through Q4 earnings history going back 5 years
- Transcripts available within 15 minutes for approximately 50% of calls

## Key pages

- [Homepage](https://earningscall.biz): Overview of EarningsCall's API and products
- [Earnings Transcripts API](https://earningscall.biz/earnings-transcripts-api): Transcript API details, endpoints, and code samples
- [Earnings Call API](https://earningscall.biz/earnings-call-api): General earnings call API overview
- [API Documentation](https://earningscall.biz/docs): Full developer documentation
- [Pricing](https://earningscall.biz/api-pricing): Plans, limits, and billing details
- [Earnings Calendar](https://earningscall.biz/calendar): Upcoming earnings dates for covered companies
- [Search Transcripts](https://earningscall.biz/search): Search tool for finding specific earnings call transcripts

## Python SDK quick start

```shell
pip install --upgrade earningscall
export EARNINGSCALL_API_KEY="your-api-key-here"
```

```python
from earningscall import get_company

company = get_company("aapl")  # Lookup Apple Inc by ticker symbol
transcript = company.get_transcript(year=2021, quarter=3)
print(f"{company} Q3 2021 Transcript: {transcript.text[:100]}...")

# Enhanced transcript with speaker names and titles (level=2)
transcript = company.get_transcript(year=2021, quarter=3, level=2)
speaker = transcript.speakers[1]
print("Speaker:")
print(f"  Name:  {speaker.speaker_info.name}")
print(f"  Title: {speaker.speaker_info.title}")

# Word-level timestamps (level=3)
transcript = company.get_transcript(year=2021, quarter=3, level=3)

# Prepared remarks and Q&A separated (level=4)
transcript = company.get_transcript(year=2021, quarter=3, level=4)

# Download audio file
company.download_audio_file(year=2021, quarter=3, file_name="Apple-Q3-2021.mp3")

# Download slide deck
company.download_slide_deck(year=2021, quarter=3, file_name="Apple-Q3-2021.pdf")

# Earnings event calendar
calendar = company.get_calendar()
```

## Company information

- Company: EarningsCall LLC
- Website: [https://earningscall.biz](https://earningscall.biz)
- [Contact Us](https://earningscall.biz/contact-us): Support and sales inquiries
- [GitHub](https://github.com/EarningsCall/earningscall-python): Official Python SDK source code