Go APIdisclosure2.edinet-fsa.go.jp ↗
Retrieve Japan FSA EDINET disclosure document metadata and regulatory announcements via 2 endpoints. Get company names, EDINET codes, JCNs, and FSA notices.
What is the Go API?
The EDINET disclosure API provides 2 endpoints for accessing Japan's Financial Services Agency EDINET portal data. Use get_document_metadata to retrieve structured header data for any filing by its document management number — including company name, 6-character EDINET code, 13-digit corporate number (JCN), and document title. Use get_announcements to pull current regulatory notices and advisories published on the EDINET top page.
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
The get_document_metadata endpoint accepts a single required parameter, doc_id, which is the document management number (SHORUI_KANRI_NO) — an alphanumeric string beginning with S followed by digits and letters. It returns six fields: company_name (the submitting entity), edinet_code (the 6-character EDINET identifier), jcn (Japan Corporate Number, 13 digits), title (document title including fiscal period information), doc_id (the management number echoed back), and raw_head (the full parsed header text from the document detail page for cases where structured fields are insufficient).
Announcements
The get_announcements endpoint requires no input parameters and returns an array of announcement objects from the EDINET top page. Each object includes a title string, an optional summary excerpt, and an optional url linking to an FSA resource. This covers regulatory notices, system advisories, and important updates as they appear on the portal.
Coverage and Identifiers
EDINET codes and Japan Corporate Numbers (JCNs) are the standard identifiers for Japanese listed and reporting companies under FSA jurisdiction. The edinet_code field maps to the same codes used across EDINET's filing system, making it straightforward to cross-reference documents with other EDINET-based data sources. The title field typically includes the report type (e.g., annual securities report, quarterly report) along with the covered fiscal period.
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?+
- Look up the EDINET code and Japan Corporate Number for a Japanese listed company by its disclosure document ID.
- Monitor FSA regulatory announcements and system notices from EDINET without manually checking the portal.
- Build a database mapping EDINET codes to corporate numbers and company names from filing metadata.
- Validate that a document management number corresponds to the expected company before processing a filing.
- Aggregate document titles to track what report types (annual, quarterly, amendment) a company has submitted.
- Alert compliance teams when new FSA advisories appear on the EDINET top page via the announcements endpoint.
- Cross-reference JCNs from EDINET metadata with Japan's corporate registry data for entity resolution.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.