How to hit the SEC EDGAR API

SEC EDGAR's APIs at https://data.sec.gov serve every public company's filing history and XBRL financial data by CIK number. 320193 is Apple.

Authentication

None, but the SEC requires a User-Agent naming you and a contact email, and allows at most 10 requests a second.

Full reference: https://www.sec.gov/search-filings/edgar-application-programming-interfaces

A company's reported revenue

XBRL facts for one concept, by filing.

curl https://data.sec.gov/api/xbrl/companyconcept/CIK0000320193/us-gaap/AccountsPayableCurrent.json
Run in PostTaco
Example response (trimmed)
{
  "cik": 320193,
  "taxonomy": "us-gaap",
  "tag": "AccountsPayableCurrent",
  "label": "Accounts Payable, Current",
  "entityName": "Apple Inc.",
  "units": {
    "USD": [
      {
        "end": "2008-09-27",
        "val": 5520000000,
        "accn": "0001193125-09-214859",
        "fy": 2009,
        "fp": "FY",
        "form": "10-K",
        "filed": "2009-10-27"
      },
      {
        "end": "2008-09-27",
        "val": 5520000000,
        "accn": "0001193125-10-012091",
        "fy": 2009,
        "fp": "FY",
        "form": "10-K/A",
        "filed": "2010-01-25",
        "frame": "CY2008Q3I"
      }
    ]
  }
}

Company filings

Company info plus recent filings.

curl https://data.sec.gov/submissions/CIK0000320193.json
Run in PostTaco
Example response (trimmed)
{
  "cik": "0000320193",
  "entityType": "operating",
  "sic": "3571",
  "sicDescription": "Electronic Computers",
  "ownerOrg": "06 Technology",
  "insiderTransactionForOwnerExists": 0,
  "insiderTransactionForIssuerExists": 1,
  "name": "Apple Inc.",
  "tickers": [
    "AAPL"
  ],
  "exchanges": [
    "Nasdaq"
  ],
  "ein": "942404110",
  "lei": null,
  "description": "",
  "website": "",
  "investorWebsite": ""
}