# SEC Financials API - EDGAR Income, Balance & Cash Flow (`webdata_labs/sec-financials-api`) Actor \[💵 $5.00 / 1K] Clean, normalized financial statements for any US public company from SEC EDGAR: income statement, balance sheet, cash flow, EPS, and ratios per fiscal period. Not a raw filing dump. - **URL**: https://apify.com/webdata\_labs/sec-financials-api.md - **Developed by:** [WebData Labs](https://apify.com/webdata_labs) (community) - **Categories:** Developer tools, Automation, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 financial periods This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SEC Financials API - EDGAR Income, Balance & Cash Flow **Clean, normalized financial statements for any US public company, straight from SEC EDGAR.** Give it a ticker, CIK, or company name and get the income statement, balance sheet, cash flow statement, EPS, and key ratios for each fiscal period - in one tidy schema. SEC's raw XBRL is a swamp: ~500 tagged concepts per company, the same line item tagged under different names, overlapping and restated periods, and a fiscal-year field that does not match the calendar. Most "SEC scrapers" hand you that raw mess. This Actor does the hard part - it maps concepts to canonical line items, picks the right value per period (latest restatement, correct duration), derives the fiscal year from the period end, and computes margins and returns - so you get analysis-ready financials, not a filing dump. ### ✅ What you get / ❌ what this isn't | This Actor gives you | This Actor is not | |---|---| | Normalized income statement, balance sheet, and cash flow per period | Not a raw XBRL or HTML filing dump | | Canonical line items mapped across companies (revenue, net income, assets, equity...) | Not investment advice or price targets | | Derived ratios: gross/operating/net margin, ROE, current ratio, debt/equity, free cash flow | Not affiliated with or endorsed by the SEC | | Annual (10-K) and quarterly (10-Q) periods, newest first | Not real-time intraday market or stock-price data | | Ticker, CIK, or company-name input; clean per-company summary | Not a guarantee every private/foreign filer has XBRL data | | Reliable official-API reads (no anti-bot, no proxy needed) | Not a substitute for reading the full filing for footnotes | ### 🔎 Why use this Actor - Pull a company's last several years of financials in seconds, already normalized. - Build screeners and comps across many tickers with one consistent schema. - Power dashboards, newsletters, models, or LLM pipelines with clean fundamentals. - Skip the XBRL plumbing - concept mapping, period dedup, restatement handling are done. - Compare margins, growth, and balance-sheet strength across companies and years. ### 🗂️ What data you get One row per company per reporting period: | Field | Type | Description | |---|---|---| | `ticker`, `cik`, `company` | string | Identifiers resolved from your query | | `fiscalYear` | number | Fiscal year, derived from the period-end date (not the unreliable raw `fy` tag) | | `periodType`, `periodStart`, `periodEnd` | string | annual/quarterly and the exact reporting window | | `form`, `filed` | string | Source form (10-K, 10-Q, 20-F...) and filing date | | `currency` | string | Reporting currency (usually USD) | | `revenue`, `costOfRevenue`, `grossProfit` | number | Top of the income statement | | `researchAndDevelopment`, `sellingGeneralAdministrative`, `operatingIncome` | number | Operating section | | `interestExpense`, `incomeTaxExpense`, `netIncome` | number | Below the line | | `epsBasic`, `epsDiluted`, `sharesDiluted` | number | Per-share figures | | `totalAssets`, `currentAssets`, `cashAndEquivalents` | number | Balance sheet - assets | | `totalLiabilities`, `currentLiabilities`, `longTermDebt` | number | Balance sheet - liabilities | | `totalEquity`, `retainedEarnings` | number | Balance sheet - equity | | `operatingCashFlow`, `investingCashFlow`, `financingCashFlow` | number | Cash flow statement | | `capitalExpenditures`, `freeCashFlow`, `dividendsPaid` | number | Capital allocation | | `grossMargin`, `operatingMargin`, `netMargin` | number | Profitability ratios | | `currentRatio`, `debtToEquity`, `returnOnEquity` | number | Liquidity / leverage / return ratios | Plus a per-company summary row: name, CIK, ticker, industry (SIC), exchange, fiscal-year end, periods returned, and an EDGAR link. ### 👥 Who it's for - Quant and retail investors building screeners and valuation models. - Fintech and analytics teams that need clean fundamentals without an XBRL pipeline. - Journalists and researchers comparing company financials over time. - Dashboard, newsletter, and bot builders. - Data teams feeding normalized financials into a warehouse or an LLM. ### Example tasks - [Get Apple annual financial statements](https://apify.com/webdata_labs/sec-financials-api/examples/get-apple-annual-financial-statements) - [Compare Big Tech financials](https://apify.com/webdata_labs/sec-financials-api/examples/compare-big-tech-financials) - [Export quarterly income statements](https://apify.com/webdata_labs/sec-financials-api/examples/export-quarterly-income-statements) ### ⚙️ How to get SEC financial statements 1. Open the Actor on Apify. 2. Enter one or more companies as tickers (`AAPL`), 10-digit CIKs (`0000320193`), or names (`Apple Inc.`). 3. Choose annual (10-K) or quarterly (10-Q) periods. 4. Choose how many recent periods to return per company. 5. Run the Actor. 6. Open the `Financial statements` or `Company summaries` dataset view. 7. Export JSON, CSV, Excel, HTML, or XML, or call the Actor through the Apify API. ### 📥 Input ```json { "companies": ["AAPL", "MSFT", "NVDA"], "periodType": "annual", "maxPeriods": 8 } ```` ### 📤 Output ```json { "recordType": "financials", "ticker": "AAPL", "cik": "0000320193", "company": "Apple Inc.", "fiscalYear": 2025, "periodType": "annual", "periodStart": "2024-09-29", "periodEnd": "2025-09-27", "form": "10-K", "filed": "2025-10-31", "currency": "USD", "revenue": 416161000000, "grossProfit": 195201000000, "operatingIncome": 133050000000, "netIncome": 112010000000, "epsDiluted": 7.46, "totalAssets": 359241000000, "totalEquity": 73733000000, "operatingCashFlow": 111482000000, "freeCashFlow": 98767000000, "netMargin": 0.2692, "returnOnEquity": 1.5191 } ``` ### 💵 How much does it cost? The launch price is about `$5.00 / 1,000 financial periods`, tier-discounted for higher Apify plans. One company-period row is one charged result; per-company summary rows are part of the same output. Pulling eight years for one company is eight results. ### 🔁 Run it on the Apify platform Schedule recurring refreshes after earnings season, call it from the Apify API, export to CSV/JSON/Excel, or connect the dataset to Make, Zapier, webhooks, a warehouse, or an LLM pipeline. ### ⚠️ Limits and caveats - This Actor reads SEC EDGAR's public XBRL data. It is not affiliated with the SEC and provides no investment advice. - **Coverage depends on XBRL.** Companies that report structured XBRL (essentially all domestic filers since ~2009) are covered; some foreign private issuers and very old filings may have gaps. - **Quarterly Q4 is not separately filed.** Companies report Q1-Q3 on 10-Q and the full year on 10-K, so a standalone Q4 does not exist in EDGAR; use annual for the full year. - Line items that a company does not report are returned as `null` rather than guessed - for example banks do not report gross profit, operating income, or a current ratio. - Figures reflect the latest filed value for each period, so restatements supersede originals. - Always confirm material decisions against the original filing for footnotes and context. ### 🧩 Related Actors - Prediction Markets Scraper - odds, prices, and volume across Polymarket, Kalshi, and Manifold. - Website Tech Stack Detector - find the tools a company's site runs. - Greenhouse, Lever & Ashby Jobs Scraper - open roles across the top startup ATS. - Trustpilot Review Scraper - company reviews with themes and sentiment. ### ❓ FAQ #### How do I look up a company? Use a stock ticker (`AAPL`), the 10-digit SEC CIK (`0000320193`), or an exact company name (`Apple Inc.`). You can mix all three in one run. #### Where does the data come from? SEC EDGAR's official company facts (XBRL) and submissions APIs - the same structured data the SEC publishes from each 10-K and 10-Q. It is free, public, and authoritative. #### Why are some fields null? Because the company does not tag that concept for that period. Banks, insurers, and REITs report different statements than a manufacturer - this Actor returns `null` instead of inventing a number. #### How is fiscal year determined? From the period-end date, not SEC's raw `fy` field, which reflects the filing context and is frequently wrong (it can label a 2022 period as "FY2024"). A period ending September 2025 is reported as fiscal year 2025. #### Does it need a proxy? No. EDGAR is a public data source served from a CDN and works without a proxy. Enable Apify Proxy only on very large batches if you hit SEC's fair-access rate limit. ### 🛠️ Support For bugs or missing fields, open an Actor issue with the run URL, the company, and the field or behavior you expected. ### ⭐ Rate this Actor If this Actor saved you time, please take 30 seconds to leave a review on the **Reviews** tab of [SEC Financials API - EDGAR Income, Balance & Cash Flow](https://apify.com/webdata_labs/sec-financials-api) - reviews are the main trust signal other users see, and they directly decide which features get built next. If something is broken or a field is missing, please [open an issue](https://apify.com/webdata_labs/sec-financials-api/issues) first - we typically respond within a day and would love the chance to fix it before you rate. # Actor input Schema ## `companies` (type: `array`): Companies to pull financials for. Accepts stock tickers (AAPL), 10-digit SEC CIK numbers (0000320193), or exact company names (Apple Inc.). One run can mix all three. ## `periodType` (type: `string`): Annual = audited 10-K / 20-F full-year statements. Quarterly = 10-Q periods (note: Q4 is not separately filed, so it appears only inside the annual report). ## `maxPeriods` (type: `integer`): How many recent reporting periods to return per company, newest first. ## `proxyConfiguration` (type: `object`): Optional. SEC EDGAR is a public data source and works without a proxy; enable Apify Proxy only if you run very large batches and hit SEC's fair-access rate limit. ## Actor input object example ```json { "companies": [ "AAPL", "TSLA", "0000019617" ], "periodType": "annual", "maxPeriods": 8, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `OUTPUT` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "companies": [ "AAPL", "MSFT", "NVDA" ] }; // Run the Actor and wait for it to finish const run = await client.actor("webdata_labs/sec-financials-api").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "companies": [ "AAPL", "MSFT", "NVDA", ] } # Run the Actor and wait for it to finish run = client.actor("webdata_labs/sec-financials-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "companies": [ "AAPL", "MSFT", "NVDA" ] }' | apify call webdata_labs/sec-financials-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=webdata_labs/sec-financials-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC Financials API - EDGAR Income, Balance & Cash Flow", "description": "[💵 $5.00 / 1K] Clean, normalized financial statements for any US public company from SEC EDGAR: income statement, balance sheet, cash flow, EPS, and ratios per fiscal period. Not a raw filing dump.", "version": "0.1", "x-build-id": "pYambXR2L7kh2Ygix" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~sec-financials-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-sec-financials-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/webdata_labs~sec-financials-api/runs": { "post": { "operationId": "runs-sync-webdata_labs-sec-financials-api", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/webdata_labs~sec-financials-api/run-sync": { "post": { "operationId": "run-sync-webdata_labs-sec-financials-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "companies" ], "properties": { "companies": { "title": "Companies", "type": "array", "description": "Companies to pull financials for. Accepts stock tickers (AAPL), 10-digit SEC CIK numbers (0000320193), or exact company names (Apple Inc.). One run can mix all three.", "items": { "type": "string" } }, "periodType": { "title": "Period type", "enum": [ "annual", "quarterly" ], "type": "string", "description": "Annual = audited 10-K / 20-F full-year statements. Quarterly = 10-Q periods (note: Q4 is not separately filed, so it appears only inside the annual report).", "default": "annual" }, "maxPeriods": { "title": "Max periods per company", "minimum": 1, "maximum": 40, "type": "integer", "description": "How many recent reporting periods to return per company, newest first.", "default": 8 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. SEC EDGAR is a public data source and works without a proxy; enable Apify Proxy only if you run very large batches and hit SEC's fair-access rate limit.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```