Go 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.
What is the Go 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace disclosure2-edinet-fsa-go-jp-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.Japan_EDINET__FSA__API import Edinet, Document, Announcement, DocumentNotFound
edinet = Edinet()
# List current announcements from the EDINET top page
for announcement in edinet.announcements.list(limit=5):
print(announcement.title, announcement.summary)
# Fetch metadata for a specific disclosure document by management number
doc = edinet.documents.get(doc_id="S100XLSD")
print(doc.company_name, doc.edinet_code, doc.jcn, doc.title)
# Refresh a document to get latest metadata
refreshed = doc.refresh()
print(refreshed.raw_head, refreshed.doc_id)
# Handle a document that doesn't exist
try:
missing = edinet.documents.get(doc_id="S000ZZZZ")
print(missing.title)
except DocumentNotFound as exc:
print(f"Document not found: {exc.doc_id}")
print("exercised: announcements.list / documents.get / document.refresh / DocumentNotFound")
Get site announcements and notices from the EDINET top page. Returns regulatory notices, advisories, and important updates published by the FSA. Each announcement includes a title and a summary excerpt. Some items include external URLs to FSA resources.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of announcement objects with title (string), summary (string, optional), and url (string, optional)"
},
"sample": {
"data": {
"items": [
{
"title": "EDINETをご利用の方へ",
"summary": "2026年６月17日..."
},
{
"url": "https://www.fsa.go.jp/receipt/d_hotline/index.html",
"title": "開示義務違反等に係る情報をお持ちの方はこちらへ （ディスクロジャー・ホットライン）"
}
]
},
"status": "success"
}
}About the Go API
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.
The Go API is a managed, monitored endpoint for disclosure2.edinet-fsa.go.jp — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when disclosure2.edinet-fsa.go.jp changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official disclosure2.edinet-fsa.go.jp API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.