• No manual, error-prone scraping/crawling required
• Returns any new filing in real-time (10-Q, 10-K, 4, 8, 13-F, etc.)
• API uses websockets to access sec.gov EDGAR filings in real-time.
• Maximum of 30 seconds delay between publish time on EDGAR and event trigger of API.
• All responses are in JSON format.
• No XBRL (and XML parser) needed.
• Supports client-side (React, React Native, Angular, Vue, etc.), and server-side (Node.js, etc.) JavaScript.
• Python, R, Java, and C++ are supported if a websocket plugin is used.
• Data source: https://www.sec.gov/edgar/searchedgar/companysearch.html
• Free API key available on sec-api.io

1. Get your free API key here: sec-api.io
2. Install: npm install sec-api

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

api.on('filing', filing => console.log(filing));

Live Demo: https://codesandbox.io/s/01xqz2ml9l

import api from 'sec-api';

class Filings extends React.Component {
  componentDidMount() {
    const socket = api('your_api_key');
    socket.on('filing', filing => console.log(filing));
  }

  // ...
}

• companyName (string) - name of company, e.g. WALT DISNEY CO/ (0001001039) (Issuer)
• cik (string) - CIK of company, e.g. 0001001039
• type (string) - sec.gov form type, e.g 10-K
• description (string) - description of filing, e.g. OWNERSHIP DOCUMENT
• linkToFilingDetails (string) - link to all documents attached to the filing
• linkToHtmlAnnouncement (string) - link to filing in HTML format
• linkToXbrl (string) - link to XBRL file (in XML format) of filing. Is not set, if no XBRL file is attached to the original filing on EDGAR.
• announcedAt (string) - ISO 8601 conform filing date and time, e.g. 2018-12-21T20:02:07-05:00

{
  companyName: 'WALT DISNEY CO/ (0001001039) (Issuer)',
  cik: '0001001039',
  type: '4',
  description: 'FORM 4',
  linkToFilingDetails: 'https://www.sec.gov/Archives/edgar/data/1001039/000100103918000235/0001001039-18-000235-index.htm',
  linkToHtmlAnnouncement: 'https://www.sec.gov/Archives/edgar/data/1001039/000100103918000235/xslF345X03/wf-form4_154544051056009.xml',
  linkToXbrl: 'https://www.sec.gov/Archives/edgar/data/1001039/000100103918000235/wf-form4_154544051056009.xml',
  announcedAt: '2018-12-21T20:02:07-05:00'
}

Let me know how I can improve the library or if you have any feature suggestions. I'm happy to implement them.

Just open a new issue on github here: https://github.com/janlukasschroeder/sec-api/issues