SEC Company Facts Extractor

Extract normalized XBRL company facts from the official SEC EDGAR Company Facts API. This Actor turns large nested SEC JSON payloads into row-level Apify datasets that are easier to query, export, schedule, and feed into dashboards or data pipelines.

Use cases

• Pull financial facts for public companies by CIK.
• Extract common facts such as assets, liabilities, revenue, net income, and shares outstanding.
• Schedule recurring snapshots for watchlists of public companies.
• Export SEC Company Facts into CSV, JSON, Excel, webhooks, warehouses, or downstream automation.

Input

{
  "ciks": ["0000320193", "0000789019"],
  "taxonomies": ["us-gaap", "dei"],
  "concepts": ["Assets", "Liabilities", "Revenues", "NetIncomeLoss"],
  "forms": ["10-K", "10-Q"],
  "latestOnly": false,
  "maxFactsPerCompany": 250,
  "maxItems": 1000,
  "userAgent": "your-product-name/1.0 contact@example.com"
}

SEC asks API users to send a descriptive User-Agent with contact information. The Actor exposes this as an input field so users can identify their own usage.

Output

Each dataset row is one reported fact:

{
  "source": "sec-companyfacts",
  "cik": "0000320193",
  "entityName": "Apple Inc.",
  "taxonomy": "us-gaap",
  "concept": "Assets",
  "label": "Assets",
  "unit": "USD",
  "value": 352755000000,
  "fy": 2023,
  "fp": "FY",
  "form": "10-K",
  "filed": "2023-11-03",
  "end": "2023-09-30"
}

If a CIK request fails, the Actor writes a structured error row with the CIK, source URL, HTTP status, and error message, then continues with the next CIK.

Notes

This Actor uses public SEC EDGAR endpoints. It is a data extraction and normalization tool, not financial advice. Users are responsible for SEC API usage compliance and for validating any downstream interpretation of financial data.