Endpoints

Audio

Download the raw MP3 audio for an earnings call.

GEThttps://v2.api.alpha.earningscall.biz/audio

Streams the original earnings call audio as audio/mpeg. Supports HTTP Range requests for partial downloads — handy for resumable downloads or seekable players.

Audio access is plan-gated. Upgrade to Ultimate, Ultimate Plus, Enterprise, or Enterprise Plus to fetch audio.

Parameters#

ParameterTypeDescription
apikeystringRequiredYour API key.
exchangestringRequiredStock exchange, e.g. NASDAQ.
symbolstringRequiredTicker symbol.
yearintegerRequired4-digit year of the earnings call.
quarterintegerRequiredFiscal quarter, 1–4.

Headers#

ParameterTypeDescription
RangestringOptionalStandard HTTP Range header, e.g. bytes=0-1023. Single-range only; the response status is 206 Partial Content.

Examples#

Save the audio to a file#

curl --output msft_q1_2022.mp3 \
  'https://v2.api.alpha.earningscall.biz/audio?apikey=demo&exchange=NASDAQ&symbol=MSFT&year=2022&quarter=1'

Response

Binary audio/mpeg stream — saved to disk by the caller.

Error responses#

See the Errors page for the full error format. This endpoint can return:

400missing_parameter — Missing exchange, symbol, year, or quarter.400invalid_parameter — Non-integer or out-of-range value.401invalid_api_key — Auth failure.403demo_restriction — Demo account requesting a ticker other than AAPL or MSFT on NASDAQ.403plan_restriction — Plan does not include audio access.404resource_not_found — Audio not available for the requested call.416Requested byte range is not satisfiable.429rate_limit_exceeded — Plan rate limit exceeded.

Plan access#

Audio downloads require Ultimate, Ultimate Plus, Enterprise, or Enterprise Plus.