SEC Company Financials Scraper - XBRL Facts

Get SEC Company Financials Scraper - XBRL Facts results as clean JSON, CSV or Excel, from the Apify API or on a schedule. No login, about $1.40 for 1,000 results.

What does SEC Company Financials Scraper - XBRL Facts do?

SEC Company Financials Scraper - XBRL Facts extracts structured data from data.sec.gov. Collect the financial facts US companies report to the SEC in XBRL (revenue, net income, EPS, assets, cash and any other us-gaap, ifrs-full or dei concept), from the SEC's public company-facts API: one clean record per company, metric and period with the latest reported value, its filing, fiscal year and quarter, and restatements flagged, watched for new periods and restated values. It works as an API for data.sec.gov data: run it from Apify Console, on a schedule, or from your own code, and get clean, typed JSON with numbers as numbers and dates in ISO 8601.

What you get

Data	22 fields per item: factId, cik, company, taxonomy, concept, label, ...
Formats	JSON, CSV, Excel, HTML, or the Apify API
Price	$1.40 per 1,000 results, pay per result
Access	Public data.sec.gov data only: no login, no cookies, robots.txt respected
Licence	SEC public information: 'free to access and reuse' and 'may be copied or further distributed ... without the SEC's permission' (please cite the SEC as the source). Not affiliated with or approved by the SEC.

Why use SEC Company Financials Scraper - XBRL Facts?

• Analysts and researchers: export the data to a spreadsheet or database.
• Developers: call it from your own code through the Apify API.
• Monitoring: run it on a schedule and compare results over time.
• AI agents and RAG: give an LLM live structured data.

Main features:

• Gets each source's results in as few requests as possible and stops at maxItems results.
• Filters: companies (companies), concepts (metrics), allConcepts (all metrics), forms (forms), fiscalYearFrom (from fiscal year), onlyChanges (only changes since the last run), so you only get (and pay for) the results you need.
• Polite by default: respects robots.txt, at most maxConcurrency parallel requests and a delay between requests.
• Checks every result against field validators, so layout changes show up as clear data-quality warnings.
• Runs on the Apify platform: scheduling, API access, integrations, monitoring and datasets you can export.

What data can SEC Company Financials Scraper - XBRL Facts extract?

Field	Type	Description
factId	string	Stable ID: CIK, concept, unit and period
cik	string	Company CIK
company	string	Company name
taxonomy	string	us-gaap, ifrs-full or dei
concept	string	XBRL concept, e.g. NetIncomeLoss
label	string	Human label of the concept
unit	string	Unit: USD, USD/shares, shares, ...
periodStart	ISO 8601 date	Period start (YYYY-MM-DD), empty for point-in-time values
periodEnd	ISO 8601 date	Period end or balance-sheet date (YYYY-MM-DD)
value	number	Latest reported value
fiscalYear	integer	Fiscal year of the filing
fiscalPeriod	string	FY, Q1, Q2, Q3
form	string	Form of the latest filing reporting it
filedDate	ISO 8601 date	Filing date of the latest report (YYYY-MM-DD)
accessionNumber	string	Accession number of that filing
frame	string	SEC calendar frame, e.g. CY2025Q3
restated	boolean	A later filing reported a different value for this period
firstReportedValue	number	The value as first reported
filingUrl	string	Filing index page on sec.gov
source	string	Always 'SEC' (data from the SEC's public APIs)
changeType	string	new, changed, unchanged since the last run with the same input
changes	object	What changed since the last run: {field: {from, to}}

How to scrape data.sec.gov

1. Open SEC Company Financials Scraper - XBRL Facts in Apify Console and go to the Input tab.
2. Enter what to scrape (see the Input section below), for example the start URLs.
3. Set Max items to the number of results you need.
4. Click Start and wait for the run to finish.
5. Download the results from the Output tab, or fetch them with the API.

How much will it cost to scrape data.sec.gov?

This Actor is priced per result: $1.40 per 1,000 results, with no extra charge for platform usage. That is about $1.40 for 1,000 results: 100 results cost $0.14 and 10,000 results cost $14.00. Set a maximum cost per run and the Actor stops when it is reached.

Input

See the Input tab for full configuration options.

Field	Type	Required	Description
companies	array	yes	Tickers (AAPL) or CIK numbers (320193).
concepts	array	no	XBRL concept names, e.g. Revenues, NetIncomeLoss, EarningsPerShareDiluted, Assets. Empty: a standard set of 12 headline metrics.
allConcepts	boolean	no	Return every reported concept (hundreds per company).
forms	array	no	Only facts from these forms, e.g. 10-K, 10-Q.
fiscalYearFrom	integer	no	Only periods of this fiscal year or later. Default: three years back.
onlyChanges	boolean	no	For scheduled runs: return (and pay for) only new and changed records, compared with the last run with the same input. The snapshot is kept in a named key-value store; delete it to start over.
maxItems	integer	no	Maximum number of items to return (0 = unlimited).
maxPages	integer	no	Maximum listing pages to follow per start URL (pagination).
maxConcurrency	integer	no	Maximum parallel requests (politeness; 1-10).
requestDelayMs	integer	no	Minimum delay between requests, in milliseconds (at least 250).
proxyType	string	no	none (direct connection), datacenter (Apify Proxy, cheapest) or residential (opt-in, billed per GB, fewer blocks). The actor never switches by itself.
proxyCountry	string	no	Two-letter country code for the proxy IP (optional).

Example input:

{
  "companies": [
    "AAPL",
    "MSFT"
  ],
  "fiscalYearFrom": 2023,
  "maxItems": 400,
  "maxConcurrency": 2,
  "requestDelayMs": 300,
  "proxyType": "none"
}

Output

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. Example results (illustrative values):

[
  {
    "factId": "Example factid",
    "cik": "Example cik",
    "company": "Example company",
    "taxonomy": "Example taxonomy",
    "concept": "Example concept",
    "label": "Example label",
    "unit": "Example unit",
    "periodStart": "2025-01-15",
    "periodEnd": "2025-01-15",
    "value": 19.99,
    "fiscalYear": 42,
    "fiscalPeriod": "Example fiscalperiod",
    "form": "Example form",
    "filedDate": "2025-01-15",
    "accessionNumber": "Example accessionnumber",
    "frame": "Example frame",
    "restated": false,
    "firstReportedValue": 19.99,
    "filingUrl": "https://www.example.com/item/12345",
    "source": "Example source",
    "changeType": "new",
    "changes": {}
  }
]

Integrations and API

• Apify API: start a run and get the results in one HTTP request:

curl -X POST "https://api.apify.com/v2/acts/compass_lab~sec-company-facts-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" -d '{"companies": ["AAPL", "MSFT"], "fiscalYearFrom": 2023, "maxItems": 400}'

• Python (pip install apify-client):

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("compass_lab/sec-company-facts-scraper").call(run_input={"companies": ["AAPL", "MSFT"], "fiscalYearFrom": 2023, "maxItems": 400})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

• JavaScript (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('compass_lab/sec-company-facts-scraper').call({"companies": ["AAPL", "MSFT"], "fiscalYearFrom": 2023, "maxItems": 400});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

• Make, Zapier, n8n, Google Sheets, webhooks: use the Apify integrations (Integrations tab) to send each run's results where you need them, or to start a run from your workflow.
• Schedules: run it hourly, daily or weekly from Apify Console (Schedules) and always have fresh results.

Tips and advanced options

• Keep Max items and Max pages as low as you need: fewer pages means a faster, cheaper run.
• Raise Delay between requests if the site responds slowly; keep Max concurrency low to stay polite.
• Missing values are null. Fields that often come back empty are listed in the run log as data-quality warnings.
• Watch for changes: every record has changeType (new, changed or unchanged compared with the last run with the same input) and changes ({"field": {"from": ..., "to": ...}}). Schedule the Actor with Only changes since the last run on to get, and pay for, only what moved. new means new to this input: not returned by an earlier run with the same filters. The last snapshot is kept in a named key-value store called <actor-name>-watch-<id> (the run log prints its name); delete it, or change the input, to start over.

FAQ, disclaimers and support

Is it legal to scrape data.sec.gov?

D91 (Mouad, 2026-10-04) confirmed the SEC line, covering the missing robots.txt on data.sec.gov; www.sec.gov robots.txt allows /files/. SEC: public filing content 'free to access and reuse'; limit 10 requests per second (we stay far below), declared User-Agent with contact email. D93: no 'EDGAR'.

The data is published under the SEC public information: 'free to access and reuse' and 'may be copied or further distributed ... without the SEC's permission' (please cite the SEC as the source). Not affiliated with or approved by the SEC.: you may reuse it, including commercially, provided you credit the source as the licence requires.

Our Actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our Actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

How many results can I get?

Up to maxItems per run (0 means no limit), as many as the source lists. Each result is one dataset item, and you are only charged for items that are saved.

Can I run it on a schedule or from my own code?

Yes. Schedule it in Apify Console (Schedules), or call it with the run-sync-get-dataset-items endpoint or the Python/JavaScript clients shown in Integrations and API above.

What are the limitations?

• None identified so far.

Where can I get help?

Report problems or ideas on the Issues tab. To call this Actor from your own code, see the API tab.

Related actors

the same clean, typed output across sources, so you can combine them in one dataset.

Actor	What it scrapes	Price
Breezy HR Jobs Scraper	Job listings from Breezy HR	$1.00 / 1,000
Open Canada Dataset Catalogue Scraper	Dataset records from Open Canada	$1.00 / 1,000
Canada Job Bank Jobs Scraper	Job listings from Canada Job Bank	$1.00 / 1,000
data.gouv.fr Dataset Catalogue Scraper	Dataset records from data.gouv.fr	$1.00 / 1,000
Django Weblog Scraper	Posts from Django Weblog	$1.00 / 1,000
Greenhouse Jobs Scraper	Job listings from Greenhouse	$1.60 / 1,000
Lever Jobs Scraper	Job listings from Lever	$1.60 / 1,000
Pinpoint Jobs Scraper	Job listings from Pinpoint	$1.00 / 1,000
Python Jobs Scraper (python.org)	Job listings from Python Jobs Scraper (python.org)	$2.00 / 1,000
Recruitee Jobs Scraper	Job listings from Recruitee	$1.00 / 1,000
We Work Remotely Jobs Scraper	Job listings from We Work Remotely	$2.50 / 1,000
Working Nomads Jobs Scraper	Job listings from Working Nomads	$2.50 / 1,000