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, getCompany } from "earningscall";

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

// Events for one ticker
const company = await getCompany({ symbol: "AAPL" });
const events = await company.events();

// Basic transcript text
const transcript = await company.getBasicTranscript({ year: 2024, quarter: 1 });
console.log(transcript.text.slice(0, 200));

// Speaker-segmented turns (Enhanced Transcript plan)
const groups = await company.getSpeakerGroups({ year: 2024, quarter: 1 });
for (const turn of groups.speakers) {
  console.log(turn.speakerInfo.name, "-", turn.text.slice(0, 80));
}

// Audio download (Audio Access plan)
const audioFile = await company.downloadAudioFile({ year: 2024, quarter: 1 });
console.log(audioFile.outputFilePath);
Note
See Plans for which calls require which tier — getSpeakerGroups needs an Enhanced Transcript plan, and downloadAudioFile needs Audio Access.