EarningsCall API Usage Guide

Mastering financial insights with the EarningsCall API Usage Guide

You can use our Application Programming Interface (API) to programmatically access earnings call data. Through this API, you can list an individual company’s earnings call dates, access the raw audio files, and even download the transcript text.

Get Full Company List

URL Endpoint :https://v1.api.earningscall.biz/symbols
HTTP Verb :GET
Header Parameter :x-api-key
Header Value :We will give you a unique API Key to use. Please do not share this key with anyone. Use “demo” to try it out.
Result :JSON Array

HTTP Response Status Codes

200Success
401Missing API Key
403Wrong API Key
404Not found

Example Usage

curl -H "x-api-key: demo" https://v1.api.earningscall.biz/symbols

NOTE: API Key “demo” enables access for ticker symbol AAPL only. Contact sales@earningscall.biz for more information to get your own API Key with full access.

Example Output

[
  {
    "exchange": "NASDAQ",
    "name": "Apple Inc.",
    "symbol": "AAPL"
  },
  {
    "exchange": "NASDAQ",
    "name": "Microsoft Corporation",
    "symbol": "MSFT"
  }
]

List Earnings Calls by Company

URL Endpoint :https://v1.api.earningscall.biz/symbols
HTTP Verb :GET
Header Parameter :x-api-key
Header Value :We will give you a unique API Key to use. Please do not share this key with anyone. Use “demo” to try it out.
Result :JSON Array

Details:

EXCHANGE and SYMBOL are variables you must pass as a part of the URL Path (not query parameters)

Valid values for EXCHANGE:

  • NYSE
  • NASDAQ
  • AMEX
  • TSX
  • TSXV
  • OTC

Example Usage

curl -H "x-api-key: demo" https://v1.api.earningscall.biz/company/exchange/NASDAQ/symbol/AAPL

NOTE: API Key “demo” enables access for ticker symbol AAPL only. Contact sales@earningscall.biz for more information to get your own API Key with full access.

Example Output

{
  "company_name": "Apple Inc.",
  "events": [
    {
      "year": "2023",
      "quarter": "q1",
      "audio_file": null,
      "conference_date": "2023-01-27T08:00:00.000-05:00"
    },
    {
      "year": "2022",
      "quarter": "q4",
      "audio_file": "41fb3be4-64f4-4bdf-ab1d-b500f9509acc.mp3",
      "conference_date": "2022-10-27T14:00:00.000-07:00"
    }
  ]
}

Example Output

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "company_name": {
      "type": "string"
    },
    "events": {
      "type": "array",
      "items": [
        {
          "type": "object",
          "properties": {
            "year": {
              "type": "string"
            }
          },
          "quarter": {
            "type": "string"
          }
        }
      ]
    }
  }
}

Download audio file

URL Endpoint :https://v1.api.earningscall.biz/symbols
HTTP Verb :GET
Header Parameter :x-api-key
Header Value :We will give you a unique API Key to use. Please do not share this key with anyone. Use “demo” to try it out.
Result :JSON Array

Example Usage

wget https://earningscall.biz/f/faafcb3c-6fbe-4187-8e38-12e428ec6583.mp3

NOTE: API Key “demo” enables access for ticker symbol AAPL only. Contact sales@earningscall.biz for more information to get your own API Key with full access.

Get Audio Transcript

Audio Transcript API details available upon further inquiry. Please reach out to us and describe your use case. Contact sales@earningscall.biz for more information.

Looks good!