SDKs

JavaScript SDK

ESM-first JavaScript SDK with bundled TypeScript types. Source on GitHub.

Install#

npm install earningscall
# or
yarn add earningscall

Configure#

Set your API key once. Without configuration the library uses the public demo key.

import { setApiKey } from "earningscall";

setApiKey("YOUR_API_KEY");

Common usage#

import {
  getAllCompanies,
  getEvents,
  getBasicTranscript,
  getSpeakerGroups,
  getCalendar,
  downloadAudioFile,
} from "earningscall";

// Every tracked company
const companies = await getAllCompanies();

// Events for one ticker
const { events } = await getEvents({ exchange: "NASDAQ", symbol: "AAPL" });

// Basic transcript text
const transcript = await getBasicTranscript({
  exchange: "NASDAQ",
  symbol: "AAPL",
  year: 2024,
  quarter: 1,
});

// Speaker-segmented turns (Enhanced Transcript plan)
const groups = await getSpeakerGroups({
  exchange: "NASDAQ",
  symbol: "AAPL",
  year: 2024,
  quarter: 1,
});

// Calendar for one date
const calendar = await getCalendar({ year: 2025, month: 1, day: 10 });

// Audio download (Audio Access plan)
await downloadAudioFile({
  exchange: "NASDAQ",
  symbol: "AAPL",
  year: 2024,
  quarter: 1,
});

Note

See Plans for which calls require which tier — getSpeakerGroups needs an Enhanced Transcript plan, and downloadAudioFile needs Audio Access.