SEC Company Financials (XBRL): EDGAR Fundamentals avatar

SEC Company Financials (XBRL): EDGAR Fundamentals

Pricing

Pay per event

Go to Apify Store
SEC Company Financials (XBRL): EDGAR Fundamentals

SEC Company Financials (XBRL): EDGAR Fundamentals

Revenue, net income, EPS, assets, debt and cash flow for any US public company, per year or quarter, from the SEC's official XBRL API. Source-linked.

Pricing

Pay per event

Rating

0.0

(0)

Developer

FedFacts

FedFacts

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

7 days ago

Last modified

Categories

Features

Limited permissions

Share

SEC Company Financials (XBRL): EDGAR fundamentals as clean rows

Get income-statement, balance-sheet and cash-flow numbers for US public companies straight from the SEC's official XBRL APIs (data.sec.gov). Enter tickers or CIKs and get one tidy row per company per fiscal year or quarter, with revenue, net income, EPS, assets, liabilities, equity, cash, operating cash flow, shares and more. Every row links back to the SEC filing it came from.

Two more modes for power users:

  • Raw facts: every XBRL fact a company reported (any concept, any unit), with form, filing date and accession number.
  • Frame (screen): one concept for all filers in one calendar period, such as "Net income for every company, CY2024" (about 6,000 rows).

No API key needed. No scraping: it uses only the SEC's public JSON APIs.

What you get (normalized mode)

One row per company and period. Annual rows come from 10-K (and 20-F/40-F for US GAAP filers); quarterly rows come from 10-Q.

FieldMeaning
recordTypecompany-period
cik, ticker, entityNameCompany identifiers (CIK is 10 digits, zero-padded)
periodTypeannual or quarterly
fiscalYear, fiscalPeriodCompany's fiscal year and period (FY, Q1-Q3)
periodStart, periodEndPeriod the income-statement values cover
cashFlowPeriodStartStart of the window for cash-flow values. In 10-Qs companies report cash flow year-to-date, so for Q2/Q3 this is the fiscal-year start
form, accessionNumber, filedDateThe filing the row is based on (the first filing that reported this period)
reportedAsComparativeOnlytrue when the period only appears as a prior-year comparison in a later filing (common for the oldest years)
revenue, costOfRevenue, grossProfit, researchAndDevelopment, operatingIncome, pretaxIncome, incomeTax, netIncomeIncome statement, USD
epsBasic, epsDilutedUSD per share
weightedAvgSharesBasic, weightedAvgSharesDilutedShares
totalAssets, currentAssets, cashAndEquivalents, totalLiabilities, currentLiabilities, longTermDebt, stockholdersEquity, sharesOutstandingBalance sheet at periodEnd
operatingCashFlow, investingCashFlow, financingCashFlow, capitalExpenditures, dividendsPaidCash-flow statement, USD
freeCashFlowDerived: operatingCashFlow - capitalExpenditures
sharesOutstandingCoverPage, sharesOutstandingCoverPageDateShares outstanding from the filing's cover page (all classes summed) and the date it was measured
conceptsUsedWhich XBRL tag filled each metric (for example revenue: RevenueFromContractWithCustomerExcludingAssessedTax)
valuesFromOtherFilingsMetrics that came from a different filing than accessionNumber (restatements or values missing in the original filing)
extraConceptsValues of any extra XBRL concepts you asked for
currencyUSD
sourceUrls.companyFacts, sourceUrls.filingIndexSEC API URL used, and the EDGAR filing index page

A metric is null when the company didn't report it under any of the tags we map for that period (banks, for example, don't report gross profit).

Example row (abridged)

{
"recordType": "company-period", "cik": "0000320193", "ticker": "AAPL", "entityName": "Apple Inc.",
"periodType": "annual", "fiscalYear": 2025, "fiscalPeriod": "FY",
"periodStart": "2024-09-29", "periodEnd": "2025-09-27",
"form": "10-K", "accessionNumber": "0000320193-25-000079", "filedDate": "2025-10-31",
"revenue": 416161000000, "netIncome": 112010000000, "epsDiluted": 7.46,
"totalAssets": 359241000000, "operatingCashFlow": 111482000000,
"conceptsUsed": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "...": "..." },
"sourceUrls": { "companyFacts": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json", "filingIndex": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm" }
}

Raw mode rows

recordType: raw-fact, cik, ticker, entityName, taxonomy (us-gaap, ifrs-full, dei, srt...), concept, label, unit, value, periodStart (null for point-in-time values), periodEnd, durationDays, filingFiscalYear, filingFiscalPeriod (of the filing, not the fact), form, filedDate, accessionNumber, frame (SEC's calendar frame, when assigned), sourceUrl, filingIndexUrl.

Frame mode rows

recordType: frame-row, cik, entityName, location, taxonomy, concept, label, unit, calendarPeriod, value, periodStart, periodEnd, accessionNumber, sourceUrl, filingIndexUrl.

Input

FieldDefaultNotes
companies["AAPL","MSFT"]Tickers (BRK.B works) or CIKs. Duplicates are skipped. Ignored in frame mode
modenormalizednormalized, raw or frame
forms["10-K","10-Q"]Also 20-F, 40-F, 10-KT, 10-QT
includeAmendmentstrueInclude 10-K/A and 10-Q/A
dateFrom, dateTo2021-01-01, emptyFilter by period end date (YYYY-MM-DD). Clear dateFrom for full history (XBRL starts ~2009)
metricsallSubset of the normalized metrics listed above
conceptsnoneExtra XBRL tags (InventoryNet, dei:EntityPublicFloat). Raw mode: returns only these
valueModeasReportedasReported = value from the original filing; latest = most recent (restated) value
frameConcept, frameTaxonomy, frameUnit, framePeriodRevenues, us-gaap, USD, CY2024Frame mode. Period formats: CY2024, CY2024Q1, CY2024Q4I (instant, for balance-sheet items)
maxItems, maxItemsPerCompany0 (no limit)Hard caps on output rows
requestsPerSecond5Capped at 8, below the SEC's 10/s limit

Examples

  • Last 5 years of annual + quarterly fundamentals: {"companies": ["AAPL","MSFT","NVDA"]}
  • Annual only, full history: {"companies": ["KO"], "forms": ["10-K"], "dateFrom": ""}
  • Just revenue and net income, restated values: {"companies": ["AMZN"], "metrics": ["revenue","netIncome"], "valueMode": "latest"}
  • One concept, raw: {"companies": ["MSFT"], "mode": "raw", "concepts": ["Revenues"]}
  • Screen all companies: {"mode": "frame", "frameConcept": "NetIncomeLoss", "framePeriod": "CY2024"}

Errors and warnings

Bad inputs don't fail the run. Unknown tickers, companies with no XBRL data (for example funds or trusts), and IFRS-only filers in normalized mode are listed in the RUN_SUMMARY record in the run's key-value store and in the log. You are not charged for them, since no rows are produced. Invalid settings (bad date format, unknown metric name) fail the run immediately before any data is fetched.

Limits (read before relying on it)

  • US GAAP only in normalized mode. IFRS filers (many 20-F companies such as TSM) return nothing there; use raw mode with ifrs-full: concepts.
  • No Q4 rows. Companies file a 10-K, not a 10-Q, for the fourth quarter. Q4 = annual minus Q1-Q3 is not derived for you.
  • Quarterly cash flow is year-to-date as filed; see cashFlowPeriodStart.
  • Tag mapping is a best effort. Companies choose different XBRL tags. We check several common tags per metric in order and tell you which one was used (conceptsUsed). Industry-specific lines (bank net interest income, insurance premiums) may need concepts.
  • Only what the SEC publishes as XBRL "company facts": no segment/dimension breakdowns, no text, no non-XBRL filings before ~2009.
  • Raw pulls can be big. A large bank's full history is ~48,000 rows. Use dateFrom, concepts or maxItems to control cost.
  • Not investment advice. Data is as filed with the SEC; verify important numbers against the filing (linked in every row).

Data source and terms

  • Data comes only from the SEC's official public APIs: data.sec.gov/api/xbrl/companyfacts, data.sec.gov/api/xbrl/frames, and www.sec.gov/files/company_tickers.json for ticker lookup. EDGAR data is public information from a US government agency.
  • The Actor follows the SEC's Fair Access policy: it declares a User-Agent (FedFacts <contact email>), throttles to 5 requests/second by default (the SEC limit is 10), and retries with exponential backoff on 429/403/5xx responses.
  • No personal data. Output is company-level financial data only; this Actor does not collect insider (Form 3/4/5) or Form D person names.
  • Not affiliated with or endorsed by the SEC.

Pricing

Pay per event, no subscription:

EventPriceWhen charged
company-period-record$0.002 per row ($2 per 1,000)Each normalized company-period row
raw-fact-row$0.0005 per row ($0.50 per 1,000)Each raw fact row or frame row
No start fee. Nothing is charged for inputs that return no data. The Actor respects your run's maximum-charge limit and stops cleanly when it's reached.

Typical costs: the default run (AAPL + MSFT, since 2021, annual + quarterly) = 44 rows = $0.09. Ten companies, 5 years of annual data = ~50 rows = $0.10. One frame screen (~6,000 companies) = ~$3.00.