What it returns
One financial number for every company that reported it to the SEC, from the SEC's XBRL frames on data.sec.gov. Use it to rank, screen or compare companies on revenue, earnings, assets, debt, shares or any other tagged concept.
Common uses
Stock screening, peer comparison, industry totals, quant factor research and data enrichment. Pay per fact returned.
Request
POST https://api.pushbuild.com/sec-xbrl-frames/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
concepts | string | Comma separated XBRL tags, e.g. Revenues, NetIncomeLoss, Assets, EarningsPerShareDiluted |
periods | string | Comma separated: CY2025 (annual), CY2025Q2 (quarter), CY2025Q2I (instant, for balance sheet items). |
taxonomy | string: us-gaap, ifrs-full, dei, srt | XBRL taxonomy. Default: "us-gaap". |
unit | string | USD (default), USD/shares for EPS, shares, pure |
ciks | string | Only these companies (comma separated CIK numbers). |
locations | string | State codes, e.g. CA,NY (from the filer's business address). |
minValue | number | Only values at or above this. |
sort | string: value, none | Largest first by default. Default: "value". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/sec-xbrl-frames/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.02 per 1,000 facts. No charge for errors or empty searches.
Related APIs
Argentina Central Bank API
Banco Central de la Republica Argentina data: catalog of 1,600+ monetary series with latest values, daily history for any series (reserves, policy rate, base money, inflation, peso exchange rates) and official FX quotes for every currency..
Australian Bureau of Statistics API: CPI, Jobs, GDP, Any Data API
Australian Bureau of Statistics data from the official ABS Data API: monthly CPI and trimmed mean, unemployment by state, GDP, wage price index and household spending presets, any ABS dataflow by SDMX key, and dataflow search.
Banco de Portugal API: Portugal Rates, Yields, HICP & GDP API
Banco de Portugal BPstat data from the official API: coincident indicators, HICP, GDP, house prices, confidence, Portuguese government bond yields, money-market, loan and deposit rates, banking ratios, or any BPstat dataset or series id..
Bank of Canada API: Policy Rate, CORRA, Bonds, CPI & CAD FX API
Bank of Canada statistics from its official Valet API: policy rate, CORRA, prime, T-bills, benchmark bond yields, mortgage and GIC rates, CPI and core CPI, commodity prices and daily CAD exchange rates.
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
Bank of Israel API: BOI Rate, SHIR & Shekel Exchange Rates API
Bank of Israel statistics from its official SDMX API: the BOI interest rate, SHIR overnight rate and standing facility rates, daily representative shekel exchange rates (USD, EUR, GBP, JPY, CHF, CAD, AUD), or any series of any BOI dataflow..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com