Company Facts API

[dgunning]

I have been working for the last couple of days on a rewrite of the CompanyFacts API. This has been released in 4.5.1

The Company Facts API provides a rich source of information about a company and can be used as an alternative to XBRL.

It is documented here.

Company facts documentation

It is not yet complete and there will still be bugs. Even so, it is a lot better than the old API.

Try it and let me know what improvements to make

[amcamc92]

Hi all,

First-time contributor here, though I’ve been using the library for over two years now—thanks for all the great work.

To build a consistent database for company financials, it's crucial to extract facts in a standardized and reliable way. As far as I understand, the companyfacts API pulls data from data.sec.gov/api/xbrl/companyfacts/, which typically includes Q1, Q2, Q3, and annual results, from 10-Qs and 10-Ks, where Q4 is generally wrapped into the annual report.

In the screener I'm developing, I prioritize retrieving Q4 financials ahead of the full annual report, which is often not released until Q1 or Q2 of the following year.

To address this, I’ve been experimenting with extracting Q4 financial data from 8-K filings, specifically Item 2.02 and Exhibit 99.01, where Financial Exhibits are attached, usually published shortly after the fiscal year ends. However, results so far have been inconsistent and challenging to standardize.

Still, integrating a reliable method to extract preliminary Q4 financials from 8-K filings into edgartools would add significant value to the library and enable much more timely analysis.

Would love to collaborate or hear any thoughts on this!