關鍵字 / Keywords: SEC EDGAR XBRL concept time series us-gaap Revenues NetIncomeLoss Assets quarterly annual 季報 年報 financial ratio time series 財務比率 時間序列
Scope: US public companies filing with the SEC (EDGAR).
One XBRL concept across all reported periods for one filer — the efficient path when you already know which line item you want (e.g. quarterly revenue history).
Endpoint: https://data.sec.gov/api/xbrl/companyconcept/CIK{cik10}/{taxonomy}/{tag}.json
Args:
cik: CIK (zero-padded or not).
taxonomy: usually "us-gaap" (US filers). Others: "dei" (entity
registration), "ifrs-full" (foreign filers using
IFRS), "srt" (SEC Reporting Taxonomy).
tag: XBRL concept name. Common us-gaap tags:
- "Revenues" · "SalesRevenueNet" ·
"RevenueFromContractWithCustomerExcludingAssessedTax"
- "NetIncomeLoss" · "OperatingIncomeLoss"
- "Assets" · "AssetsCurrent" · "Liabilities" ·
"StockholdersEquity"
- "CashAndCashEquivalentsAtCarryingValue"
If the tag is not reported, response has
error="concept_not_reported" — call
us_get_sec_company_facts to enumerate available tags.
Returns dict with label, description, unit_summary
({USD: n_periods, shares: n, …}), and units (raw per-period
array). Each period row has end (period-end YYYY-MM-DD), val
(numeric), accn (accession that reported it), fy, fp
(Q1/Q2/Q3/FY), form (10-K / 10-Q), filed (filing date),
optional frame (SEC quarter frame). License: US Public Domain.