SEC-API.io TypeScript and JavaScript Library

The library provides access to a wide range of SEC data through various specialized APIs, including:

• Search & Download: SEC EDGAR Filings Query, Full-Text Search, Real-Time Filing Stream, and Filing/Exhibit Download.
• Bulk Datasets: Complete EDGAR filing datasets.
• Converters & Extractors: XBRL-to-JSON and 10-K/10-Q/8-K section extraction.
• Ownership & Investment Data: Insider trading (Forms 3, 4, 5), Institutional holdings (13F, 13D/G), and Investment Adviser data (Form ADV).
• Security Offerings: Registration statements (S-1/424B4), Crowdfunding (Form C), and Private Offerings (Form D).
• Public Company Data: Directors, Executive Compensation, and Subsidiary information.
• Enforcement & Legal: SEC Enforcement Actions, Litigation Releases, and AAER database.

Install the SEC-API.io TypeScript and JavaScript library using npm:

npm install sec-api

The library supports both CommonJS and ESM imports. Use the appropriate syntax for your environment.

import { downloadApi } from 'sec-api'; // ESM
const { downloadApi } = require('sec-api'); // CommonJS

The sec-api-node library provides a unified entrypoint for accessing various SEC data APIs. You can import the default secApi object or use named exports to access specific API modules directly. To use the library, you must first set your API key using setApiKey.

import secApi, {
  setApiKey,
  queryApi,
  fullTextSearchApi
} from 'sec-api';

// Set your API key before making calls
setApiKey('YOUR_API_KEY');

Before making any API calls, you must authenticate by setting your API key. The library uses a global store for the key, which is updated via the setApiKey method. This method is available on all top-level API modules.

const secApi = require('sec-api');

// Set the API key globally for the library
secApi.queryApi.setApiKey('YOUR_API_KEY');

Use the datasetsApi object to download complete, bulk datasets of SEC filings (e.g., all 10-K filings or all 13-F holdings). You must authenticate using setApiKey('YOUR_API_KEY') before calling download(datasetName).

const { datasetsApi } = require('sec-api');

datasetsApi.setApiKey('YOUR_API_KEY');

// downloads all 10-K filings (1993-present) to ./sec-api-datasets/form-10k-content/YYYY/YYYY-MM.zip
await datasetsApi.download('form-10k-content');

// all 13-F institutional holdings
await datasetsApi.download('form-13f-holdings');

Use the downloadApi object to retrieve specific SEC filings or exhibits. You must first authenticate using setApiKey('YOUR_API_KEY'). The getFile method allows you to download a filing by providing its SEC URL. Note that accounts are typically limited to 200 downloads per second.

const { downloadApi } = require('sec-api');

downloadApi.setApiKey('YOUR_API_KEY');

// 200 downloads / second per account
const filing = await downloadApi.getFile(
  'https://www.sec.gov/Archives/edgar/data/1318605/000162828025045968/tsla-20250930.htm',
);

console.log(filing.slice(0, 1000));

The auditFeesApi allows you to access audit fee data disclosed in proxy statements (DEF 14A). This includes fees paid to auditors for audit services, audit-related services, tax services, and other services. Use getData to query the database.

const { auditFeesApi } = require('sec-api');

auditFeesApi.setApiKey('YOUR_API_KEY');

const data = await auditFeesApi.getData({
  query: 'cik:1318605',
  from: '0',
  size: '10',
  sort: [{ filedAt: { order: 'desc' } }],
});
// response: { total, data }

The secLitigationsApi provides access to SEC litigation releases that announce civil lawsuits filed by the SEC in federal courts. Use getData to query the database using a query string.

const { secLitigationsApi } = require('sec-api');

secLitigationsApi.setApiKey('YOUR_API_KEY');

const data = await secLitigationsApi.getData({
  query: 'releasedAt:[2024-01-01 TO 2024-12-31]',
  from: '0',
  size: '50',
  sort: [{ releasedAt: { order: 'desc' } }],
});
// response: { total, data }