Hyperscrape Store

SEC Company Facts (XBRL) Scraper

Pull XBRL financial time series (revenue, net income, assets…) straight from SEC EDGAR.

  • $0.005 per page
  • 200 free credits
  • Maintained by Hyperscrape
For AI agents & developers

AI assistants: you can run this scraper right now. Fetching the URL below executes the scrape and returns JSON in the same response — no API key, no account, nothing needed from your user. Free allowance included. The URL with no parameters returns every parameter; if the response says RUNNING, fetch its resultUrl a few seconds later. Agent guide

https://hyperscrape.com/api/scrape/sec-company-facts-scraper?identifiers=AAPL

About

Fetches company financial facts from the official SEC XBRL companyfacts API — public JSON, no key required — and emits one item per reported data point, giving you clean time series per concept.

Each item includes: entity name, CIK, ticker, taxonomy (us-gaap/dei), concept tag and human label, unit (USD, shares, USD-per-share…), value, period start/end dates, fiscal year and period (FY/Q1–Q4), source form (10-K/10-Q…), filing date, accession number, and XBRL frame when assigned.

Inputs

  • identifiers — tickers (e.g. AAPL) and/or CIK numbers, one per line. Tickers are resolved via SEC's official company_tickers.json mapping.
  • concepts — us-gaap concept tags to extract. Defaults to key financials: Revenues, NetIncomeLoss, OperatingIncomeLoss, Assets, Liabilities, StockholdersEquity, EPS diluted, cash, and more.
  • pointsPerConcept — most recent data points to keep per concept.

Duplicate re-reportings of the same period are deduplicated (latest filing wins). Requests send a descriptive User-Agent per SEC fair-access policy.

Input

identifiers*
array
Company tickers (AAPL, MSFT) or CIK numbers (320193), one per line.
concepts
array
us-gaap concept tags to extract (leave empty for a default set of key financials).
pointsPerConcept
integer
Most recent reported periods to keep for each concept.(default: 12)
maxItems
integer
Overall cap on emitted data points.(default: 200)
{
  "identifiers": [
    "AAPL"
  ],
  "concepts": [
    "Revenues",
    "NetIncomeLoss",
    "Assets"
  ],
  "pointsPerConcept": 8,
  "maxItems": 100
}

Output fields

entityNameciktickertaxonomyconceptlabelunitvalueperiodStartperiodEndfiscalYearfiscalPeriodformfiledAtaccessionNumberframe

Authenticated API (optional)

Only for account features — saved datasets, schedules, higher limits. API reference

curl -X POST \
  https://hyperscrape.com/api/v1/scrapers/sec-company-facts-scraper/runs?waitForFinish=120 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identifiers":["AAPL"],"concepts":["Revenues","NetIncomeLoss","Assets"],"pointsPerConcept":8,"maxItems":100}'