Service
공개 SEC EDGAR 프로바이더로, SEC의 공식 무인증 JSON API(data.sec.gov, www.sec.gov)를 통해 회사명/티커 검색, 공시 이력, XBRL 재무 데이터를 제공합니다. SEC의 공정 이용 정책에 따라 식별 가능한 User-Agent가 필요하며, API 키는 필요하지 않습니다.
99.74%30일 가동률평균 응답409ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/sec-edgar-filings/company-facts | Retrieves one company's reported XBRL facts for a single required us-gaap concept (e.g. 'Assets') and returns a caller-selected fact page (default 20, maximum 100). Use when you need one company's reported history for one line item; obtain central_index_key from sec-edgar-filings:search-companies first. Do NOT use to compare many companies for one period — use sec-edgar-filings:xbrl-frame instead. concept is required so that a single call never returns a company's entire fact catalog; an unknown concept or CIK returns NOT_FOUND. Returns central_index_key, facts (concept, unit, value, fiscal_year, fiscal_period, period_ended_on, form_type), total_count, page, limit, and has_more. | |
| POST | /v1/sec-edgar-filings/company-filings | Lists a company's SEC filings from data.sec.gov/submissions/CIK{10-digit-cik}.json, sorted by filed_on descending, optionally filtered to one exact form_type ('10-K' and '10-K/A' are distinct codes — no partial matching). Use when you need a company's filing history or a direct link to a filing document; obtain central_index_key from sec-edgar-filings:search-companies first. Do NOT use for reported financial values — use sec-edgar-filings:company-facts instead. Covers only SEC's 'recent' window (the most recent up to 1000 filings per company — in practice the full multi-year history of any active large filer); total_count counts filings in that window, not the company's complete history. primary_document_url is built from the accession number and primary document filename and is null on the rare pre-2001 filing where SEC recorded no primary document. Unknown CIK returns NOT_FOUND. Returns central_index_key, filings (accession_number, form_type, filed_on, period_of_report, primary_document_url), total_count, page, and has_more. | |
| POST | /v1/sec-edgar-filings/search-companies | Searches SEC's registered company and ticker list by company name or ticker and returns a ranked, deterministic page of matches. Use when you need a company's Central Index Key (CIK), ticker, or listing exchange — for example to resolve a company name to the central_index_key that company-filings and company-facts require. Do NOT use for a company's filings or financial data — use sec-edgar-filings:company-filings or sec-edgar-filings:company-facts instead. Page size defaults to 20 and is capped at 50; the same query and page always return the same rows. Returns companies (central_index_key, company_name, ticker, exchange), total_count, page, and has_more. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/sec-edgar-filings/xbrl-frame | Retrieves one official SEC XBRL frame — one fact per reporting entity for a single concept, unit, and calendar period (e.g. us-gaap / Revenues / USD / CY2024) — and returns a deterministic caller-selected entity page (default 20, maximum 100). Use when you need to compare one concept across companies for a single period. Do NOT use for one company's history of a concept — use sec-edgar-filings:company-facts instead. Entity names are not included; each fact carries the entity's central_index_key. An unknown taxonomy, concept, unit, or period combination returns NOT_FOUND. Returns taxonomy, concept, unit, period, label, description, total_count, facts (central_index_key, location, period_ended_on, value, accession_number), page, limit, and has_more. |
