SEC EDGAR XBRL Frames API — Cross-Company Financial Facts

Query standardised XBRL frames (Revenues, Assets, NetIncomeLoss, StockholdersEquity, …) for ~6 000 US public companies. Period presets, derived fields, and post-filters return one record per (tag, entity, period). Built for financial analysts, portfolio managers, and AI agents that need comparable numbers across issuers.

Free trial

A free Apify account gives you about 5 USD of monthly credits, enough to pull a year's worth of frame data for hundreds of issuers before paying.

Use cases

1. Cross-company comparable — pull Revenues and NetIncomeLoss for the full S&P 500 in CY2024 and rank by margin.
2. Asset composition — fetch Assets per industry (SIC code) and track entity_state-level concentration shifts.
3. Anomaly detection — load Revenues and Assets for one issuer over 5 years; surface YoY changes above 25 % for a human review.

Input

{
  "tag": "Revenues",
  "period": "CY2024",
  "balance_type": "duration",
  "unit": "USD",
  "max_results": 50
}

Field	Type	Default	Description
tag	string	Revenues	XBRL USGAAP/IFRS tag (Revenues, Assets, NetIncomeLoss, StockholdersEquity, …).
period	string	CY2024	Period key: CY2024, CY2023Q4, CY2024Q2, last_year, etc.
balance_type	string	duration	duration (flow) or instant (stock).
unit	string	USD	XBRL unit (USD, USD/shares, …).
cik	string	""	Restrict to one CIK (10-digit).
sic	string	""	Comma-separated SIC codes.
entity_state	string	""	2-letter state code.
entity_country	string	US	ISO 3166-1 alpha-3.
min_value	number	0	Post-filter: minimum value in USD.
max_results	integer	50	Cap on returned records (1–200).

Output (real run)

[
  {
    "tag": "Revenues",
    "taxonomy": "us-gaap",
    "unit": "USD",
    "period": "CY2024",
    "balance_type": "duration",
    "period_label": "FY2024 (duration)",
    "fiscal_year": 2024,
    "fiscal_period": "FY",
    "cik": "104169",
    "cik_padded": "0000104169",
    "entity_name": "Walmart Inc.",
    "entity_state": "AR",
    "entity_country": "US",
    "is_domestic": true,
    "period_start": "2024-02-01",
    "period_end": "2025-01-31",
    "days_in_period": 365,
    "value": 681000000000,
    "value_label": "$681.0B",
    "value_usd_millions": 681000.0,
    "value_usd_billions": 681.0,
    "accession_number": "0000104169-26-000055",
    "filing_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=104169&type=&dateb=&owner=include&count=40"
  },
  {
    "tag": "Revenues",
    "taxonomy": "us-gaap",
    "unit": "USD",
    "period": "CY2024",
    "balance_type": "duration",
    "period_label": "FY2024 (duration)",
    "fiscal_year": 2024,
    "fiscal_period": "FY",
    "cik": "789019",
    "cik_padded": "0000789019",
    "entity_name": "Microsoft Corp.",
    "entity_state": "WA",
    "entity_country": "US",
    "is_domestic": true,
    "period_start": "2024-07-01",
    "period_end": "2025-06-30",
    "days_in_period": 365,
    "value": 245000000000,
    "value_label": "$245.0B",
    "value_usd_millions": 245000.0,
    "value_usd_billions": 245.0,
    "accession_number": "0000789019-26-000090",
    "filing_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=789019&type=&dateb=&owner=include&count=40"
  }
]

Field	Type	Description
tag	string	XBRL tag (Revenues, Assets, …).
taxonomy	string	us-gaap, ifrs-full, …
unit	string	Reporting unit (USD, USD/shares).
period / period_label	string	Canonical period key + readable label.
balance_type	string	duration (flow) or instant (stock).
fiscal_year / fiscal_period	integer / string	Fiscal year (2024) and period (FY, Q1, …).
cik / cik_padded	string	SEC CIK.
entity_name	string	Issuer name as filed.
entity_state / entity_country	string	Issuer state and country.
is_domestic	boolean	US vs foreign issuer.
period_start / period_end	string	Period coverage dates.
days_in_period	integer	Day length (sanity check).
value	integer	Raw XBRL value.
value_label	string	Human-readable value (e.g. $681.0B).
value_usd_millions / value_usd_billions	number	Same value, scaled.
accession_number	string	SEC accession number.
filing_url	string	URL of the filing that carries the fact.

Pricing (pay-per-event)

• No subscription. Free monthly credits apply first.
• 1 result = $0.001 USD (about $1 per 1 000 results).
• Charged per item returned in the dataset; failed runs are not charged.

Source, licence, limits

• Source: SEC EDGAR XBRL Frames API at https://data.sec.gov/api/xbrl/frames/.
• Licence: US Government work, public domain (17 U.S.C. § 105).
• Update frequency: XBRL frames are derived from the most recent EDGAR filings; this Actor reflects the upstream API at the moment of the run.
• Limits: 10 results per page in the SEC frames endpoint; we paginate up to max_results. Foreign issuers use ifrs-full taxonomy and may not be returned for us-gaap tags.

FAQ

What's a "frame"? A frame is XBRL's cross-company view: all entities that reported a given tag in a given period. Frames are 1 of the 3 XBRL query primitives (facts, frames, components).

Why is value in cents sometimes? Some facts are reported in USD/shares or per-entity units — the raw unit is preserved in unit. Use value_label for display.

Why are some companies missing? Foreign issuers filing under ifrs-full aren't returned for us-gaap tags. Switch taxonomy if you need them.

How do I get quarterly instead of annual? Use period = CY2024Q2 or CY2024Q4. The Actor returns all matching records.

How do I get the smallest companies? Filter min_value to drop the long tail; or scope by cik from the SEC company tickers Actor.

Can I get per-share values? Yes — unit = USD/shares returns EarningsPerShareDiluted etc.

Other Actors from DevOne-Studio

• ted-tenders-api — TED (Tenders Electronic Daily) EU public procurement search.
• pdf-to-text-api — PDF to text + tables extraction via pdfplumber, no external calls.
• pubmed-articles-api — NCBI PubMed biomedical literature with MeSH/DOI/year filters.
• federal-register-api — US federal agency rules, proposed rules, notices, presidential docs.
• sec-company-tickers — Resolve SEC CIK from ticker or company name (10,400+ issuers).
• sec-edgar-fulltext-search-api — Full-text search across 35M+ SEC EDGAR filings and exhibits.
• cfpb-consumer-complaints-api — 18M+ US CFPB consumer complaints since 2011.
• nhtsa-safety-ratings-api — NHTSA NCAP 5-star vehicle safety ratings.
• openfda-udi-api — FDA Unique Device Identifier database by device/manufacturer.
• eia-state-electricity-api — US state-level electricity generation and consumption, 1990-2025.

Changelog

• 2026-10-12 — SEO metadata (seoTitle, seoDescription); README rewritten with real output sample, FAQ, cross-links.
• 2026-10-05 — Pricing switched to Apify pay-per-event ($0.001 per dataset item).
• 2026-09-30 — Initial public release on the Apify Store.