SDKs
JavaScript SDK
ESM-first JavaScript SDK with bundled TypeScript types. Source on GitHub.
Install#
npm install earningscall
# or
yarn add earningscallConfigure#
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.