disclosure2.edinet-fsa.go.jp APIdisclosure2.edinet-fsa.go.jp ↗
Retrieve Japanese FSA EDINET disclosure metadata, search filings by keyword or securities code, and fetch temporary PDF links via 4 structured endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/c249f34c-f3c6-4f34-b359-699038bb5992/get_announcements' \ -H 'X-API-Key: $PARSE_API_KEY'
Get site announcements and notices from the EDINET top page. Returns links to regulatory notices, disclosure hotline, and other important announcements.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of announcement objects, each with title (string) and url (string)"
},
"sample": {
"data": {
"items": [
{
"url": "https://disclosure2.edinet-fsa.go.jp/javascript:LBLCOMPANYLIST_MPAGE_Click();",
"title": "金融商品取引法等に基づき有価証券報告書等の提出期限の延長が承認されている会社一覧"
},
{
"url": "https://www.fsa.go.jp/receipt/d_hotline/index.html",
"title": "開示義務違反等に係る情報をお持ちの方はこちらへ（ディスクロジャー・ホットライン）"
}
]
},
"status": "success"
}
}About the disclosure2.edinet-fsa.go.jp API
The EDINET API provides access to Japan's FSA disclosure portal through 4 endpoints, returning structured data on company filings, document metadata, and regulatory announcements. The get_document_metadata endpoint resolves a document management number (SHORUI_KANRI_NO) into fields like EDINET code, corporate number (JCN), company name, and document title. Combined with search_documents and get_pdf_link, it covers the full workflow from discovery to document retrieval.
Document Metadata and Search
The get_document_metadata endpoint accepts a doc_id — an alphanumeric management number such as S100XLSD — and returns six fields: company_name, edinet_code (6-character submitter code), jcn (corporate number / 法人番号), title, doc_id, and raw_head (the full header text from the document detail page). This is the core lookup for resolving a known document ID into structured company and filing information.
The search_documents endpoint accepts an optional query string (keyword or securities code), an optional page integer for pagination, and a period parameter where 1 means today, 6 means the past year, and 7 returns all available filings. It returns a total count and an items array of document objects. Note that this endpoint is highly sensitive to session state and may return a 440 Session Expired error; callers should treat that status code explicitly.
PDF Access and Announcements
The get_pdf_link endpoint takes a doc_id_encrypt value — the encrypted document ID (SHORUI_KANRI_NO_ENCRYPT) surfaced in search_documents results — and returns a pdf_sas_url: a temporary Azure SAS URL pointing directly to the filing PDF. These URLs are time-limited and not suitable for long-term storage. Plan to fetch them on-demand close to the time of use.
The get_announcements endpoint requires no input and returns an items array of objects, each with a title and url, representing notices from the EDINET top page — including regulatory notices and disclosure hotline links. This is useful for monitoring portal-level changes that may affect filing availability or system behavior.
- Resolve EDINET document IDs to company names and corporate numbers for filing databases
- Search for all disclosures submitted by a specific securities code within the past year
- Retrieve temporary PDF links for annual reports and securities registration statements
- Monitor EDINET site announcements to detect portal maintenance or regulatory notices
- Build a Japanese corporate filing tracker using EDINET codes and JCN identifiers
- Paginate through recent disclosures to ingest today's filings into a downstream pipeline
- Cross-reference JCN (法人番号) from filing metadata with other Japanese company databases
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does EDINET have an official developer API?+
What does `search_documents` return, and how does the `period` parameter work?+
total integer and an items array of document objects matching the query. The period parameter controls the submission date range: 1 limits results to today, 6 covers the past year, and 7 retrieves all available filings regardless of date. The query field accepts either a free-text keyword or a securities code.Why does `search_documents` sometimes return a 440 error?+
Are the PDF URLs from `get_pdf_link` permanent?+
pdf_sas_url field is a temporary Azure SAS URL. These URLs expire after a short window, so they are not suitable for storing as permanent references. Fetch them immediately before accessing the PDF rather than caching them.Does the API return the full text content of filings or attachment files beyond the main PDF?+
company_name, edinet_code, jcn, title) and a temporary PDF link for the primary document. Inline document body text, XBRL data files, and secondary attachments are not exposed. You can fork this API on Parse and revise it to add an endpoint that retrieves those additional file types using the encrypted document ID.