Getting started

Authentication

Every request to the EarningsCall API must include an API key. You can send it as a query parameter or as the x-api-key header.

API keys#

Your account dashboard has a single API key tied to your subscription plan. The plan determines which endpoints, transcript levels, and request rate you can access — see Plans for the full feature matrix.

Warning
Treat the API key like a password. Never commit it to source control or expose it in client-side JavaScript that runs in untrusted browsers.

Sending the key#

Both forms are equivalent:

# As a query parameter
curl 'https://alpha.earningscall.dev/events?apikey=YOUR_KEY&exchange=NASDAQ&symbol=AAPL'

# As a header
curl -H 'x-api-key: YOUR_KEY' \
  'https://alpha.earningscall.dev/events?exchange=NASDAQ&symbol=AAPL'

Demo key#

The reserved key demo is available without sign-up. It works on every endpoint, but the data set is intentionally small:

  • Tickers: NASDAQ:AAPL and NASDAQ:MSFT only
  • Calendar dates: only 2025-01-10
  • Search results: capped at 10 per request

Use the demo key to evaluate the API, then pick a plan when you're ready for full data.