Japan Financial Filings Scraper (EDINET)

Extract and download Japanese corporate financial filings from EDINET (Electronic Disclosure for Investors' NETwork), Japan's equivalent of the SEC's EDGAR system. This actor provides structured access to annual reports (有価証券報告書 / yuho), quarterly reports, large shareholding disclosures, and 35+ other filing types from 11,000+ Japanese listed and unlisted companies on the Tokyo Stock Exchange (TSE). Results include direct PDF and XBRL download links, English document type labels, and filing metadata -- all via the official EDINET API operated by Japan's Financial Services Agency (FSA).

What is EDINET and why use this scraper?

EDINET is Japan's mandatory electronic disclosure system for corporate filings, similar to the SEC's EDGAR in the United States. All publicly traded companies on the Tokyo Stock Exchange (TSE) must file their annual reports, quarterly reports, and other disclosures through EDINET.

The EDINET API is powerful but painful to use directly:

• No company search -- The API only supports date-based queries. Want Toyota's annual report? You have to scan every day and filter. This actor lets you search by company name or stock code.
• Cryptic output -- The API returns 29+ fields with internal codes like docTypeCode: "120". This actor translates everything into clean English labels like "Annual Securities Report".
• Slow without optimization -- Naive scanning wastes API calls on weekends (no filings). This actor automatically skips non-business days, saving ~30% of API calls.

EDINET vs SEC EDGAR comparison

Feature	EDINET (Japan)	EDGAR (United States)
Operated by	Financial Services Agency (FSA)	Securities and Exchange Commission (SEC)
Country	Japan	United States
Companies covered	11,000+ (TSE-listed and unlisted issuers)	21,000+ (NYSE/NASDAQ-listed and others)
Filing types	38 types (annual, quarterly, shareholding, etc.)	100+ form types (10-K, 10-Q, 13F, etc.)
API cost	Free (registration required)	Free (no registration)
Language	Japanese only	English
XBRL support	Yes	Yes
Data history	~10 years	25+ years

How to scrape Japanese financial filings from EDINET

1. Get a free EDINET API key at api.edinet-fsa.go.jp (requires email and phone number)
2. Enter your API key in the input form
3. Type a stock code (e.g., 7203 for Toyota) or company name (e.g., トヨタ)
4. Click Start -- the actor scans the last year and returns matching filings

The prefilled example searches for Toyota's annual reports. Just add your API key and run.

What data can you extract from EDINET?

• Search by company name (Japanese) or 4-digit stock code (e.g., 7203 for Toyota, 6758 for Sony, 9984 for SoftBank)
• Search by EDINET code (e.g., E02144)
• Browse by date range for all filings in a period
• Filter by document type (annual reports, quarterly reports, large shareholding reports, etc.)
• English document type labels for all 38 EDINET filing types
• Direct download URLs for PDF, XBRL, CSV, and English translation files
• Weekend skipping -- saves ~30% of API calls on long date ranges
• Incremental output -- results appear in the dataset as they are found
• Real-time progress -- status messages show scan progress in the Apify console
• Built-in rate limiting to respect EDINET's API constraints
• Covers 10 years of historical filings for 11,000+ companies

Input parameters

Parameter	Type	Required	Description
apiKey	string	Yes	EDINET API subscription key (free).
searchMode	string	No	"company" (default) or "dateRange".
companyQuery	string	When company	Company name, stock code, or EDINET code.
documentTypes	array	No	Filter by type code. Default: ["120"] (annual reports).
dateFrom	date	No	Start date. Default: 1 year ago for company search.
dateTo	date	No	End date. Default: today.
maxResults	integer	No	Max results (1-1000). Default: 50.

Example: Find Toyota's annual reports

{
    "apiKey": "your-key-here",
    "searchMode": "company",
    "companyQuery": "7203",
    "documentTypes": ["120"]
}

Example: All large shareholding reports this week

{
    "apiKey": "your-key-here",
    "searchMode": "dateRange",
    "dateFrom": "2026-02-23",
    "dateTo": "2026-02-27",
    "documentTypes": ["350"]
}

Sample output

The following is an illustrative example based on a typical Toyota filing. The document ID is for demonstration purposes.

{
    "docId": "S100TRDG",
    "companyName": "トヨタ自動車株式会社",
    "edinetCode": "E02144",
    "securityCode": "7203",
    "jcn": "1180301018771",
    "documentType": "Annual Securities Report",
    "documentTypeCode": "120",
    "submitDate": "2025-06-25",
    "submitDateTime": "2025-06-25 15:30",
    "documentDescription": "有価証券報告書－第121期",
    "fiscalPeriodStart": "2024-04-01",
    "fiscalPeriodEnd": "2025-03-31",
    "hasPdf": true,
    "hasXbrl": true,
    "hasCsv": true,
    "hasEnglish": true,
    "downloadUrls": {
        "pdf": "https://api.edinet-fsa.go.jp/api/v2/documents/S100TRDG?type=2",
        "xbrl": "https://api.edinet-fsa.go.jp/api/v2/documents/S100TRDG?type=1",
        "csv": "https://api.edinet-fsa.go.jp/api/v2/documents/S100TRDG?type=5",
        "english": "https://api.edinet-fsa.go.jp/api/v2/documents/S100TRDG?type=4"
    },
    "dataSource": "Source: Created by processing data from EDINET (Financial Services Agency of Japan) (https://disclosure.edinet-fsa.go.jp/) PDL1.0"
}

Output: Japanese financial filing data fields

Each filing in the dataset contains:

Field	Type	Description
docId	string	EDINET document ID (e.g., S100ABCD)
companyName	string	Company name (Japanese)
edinetCode	string	EDINET issuer code (e.g., E02144)
securityCode	string?	4-digit stock code (e.g., 7203). Null for unlisted companies.
jcn	string?	Japan Corporate Number (13-digit national ID for businesses)
documentType	string	English label (e.g., Annual Securities Report)
documentTypeCode	string	EDINET type code (e.g., 120)
submitDate	string	Filing date (YYYY-MM-DD)
submitDateTime	string	Filing timestamp
documentDescription	string	Japanese description of the filing
fiscalPeriodStart	string?	Start of the fiscal period covered
fiscalPeriodEnd	string?	End of the fiscal period covered
hasPdf	boolean	PDF version available
hasXbrl	boolean	XBRL data available
hasCsv	boolean	CSV data available
hasEnglish	boolean	English translation available
downloadUrls	object	Direct download URLs (authenticate with API key header to use)
dataSource	string	PDL1.0 attribution for EDINET data

Note on download URLs: For security, download URLs do not contain your API key. To download a file, add the header Ocp-Apim-Subscription-Key: YOUR_KEY to your HTTP request.

Python API usage example

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("rationalistic_counsel/edinet-japan-financial-reports").call(
    run_input={
        "apiKey": "YOUR_EDINET_KEY",
        "searchMode": "company",
        "companyQuery": "7203",
        "documentTypes": ["120"],
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['companyName']} - {item['documentType']} ({item['submitDate']})")
    if item.get("downloadUrls", {}).get("pdf"):
        print(f"  PDF: {item['downloadUrls']['pdf']}")

Supported EDINET document types (Japanese SEC filings)

Code	Japanese	English
120	有価証券報告書	Annual Securities Report
130	訂正有価証券報告書	Amendment to Annual Securities Report
140	四半期報告書	Quarterly Report
150	訂正四半期報告書	Amendment to Quarterly Report
160	半期報告書	Semi-Annual Report
180	臨時報告書	Extraordinary Report
235	内部統制報告書	Internal Control Report
240	公開買付届出書	Tender Offer Notification
350	大量保有報告書	Large Shareholding Report
370	変更報告書	Change Report (Large Shareholding)

The actor supports all 38 EDINET document types. The input filter shows the most commonly used types; use the dateRange mode without a filter to see all types.

How to get a free EDINET API key

1. Go to EDINET API Portal
2. Register with email and phone number (Japanese phone number required)
3. Complete MFA verification
4. Your Subscription Key will be issued immediately
5. The API is completely free -- no usage fees or credit card required

How much does it cost to scrape EDINET?

• Weekend skipping saves ~30% of API calls
• Rate limiting: minimum 3 seconds between API calls (EDINET requirement)
• 1 year scan (company search): ~260 API calls, ~15 minutes, ~$0.05 Apify compute
• 1 month scan: ~22 API calls, ~1 minute, ~$0.01 Apify compute
• Single day (dateRange mode): 1 API call, ~5 seconds, minimal cost

Frequently asked questions about EDINET data

Q: What is the Japanese equivalent of SEC EDGAR? EDINET (Electronic Disclosure for Investors' NETwork) is Japan's equivalent of the SEC's EDGAR system. It is operated by Japan's Financial Services Agency (FSA) and is the mandatory electronic disclosure system for all publicly traded companies in Japan.

Q: Is the EDINET API really free? Yes. EDINET is operated by Japan's Financial Services Agency as a public disclosure system. There are no usage fees or credit card requirements. You only need to register for an API key. A rate limit of 3 seconds between API calls applies.

Q: How to access Japanese company financial reports in English? Some filings on EDINET include English translations. Use this actor to search for filings and check the hasEnglish field. If true, the downloadUrls.english link provides the English version. Note that not all companies provide English translations.

Q: Can I download XBRL data from Japanese filings? Yes. Most filings on EDINET include XBRL data. Check the hasXbrl field in the output. When available, the downloadUrls.xbrl link provides the XBRL ZIP file.

Q: Why does a 1-year scan take 15 minutes? The EDINET API only supports date-based queries, so the actor must query each business day individually. With the required 3-second rate limit between calls, scanning 260 weekdays takes approximately 15 minutes.

Q: Can I search by English company name? Currently, company name search matches against the Japanese name registered with EDINET. Use the 4-digit stock code (e.g., 7203 for Toyota) for the most reliable results. EDINET code search (e.g., E02144) is also exact.

Q: What is a yuho (有価証券報告書)? A yuho is Japan's equivalent of the SEC's 10-K annual report. It is a comprehensive annual securities report that publicly traded companies in Japan must file through EDINET. This actor returns yuho filings as document type code 120 ("Annual Securities Report").

Q: How to find large shareholding reports for Japanese companies? Use the dateRange search mode with document type 350 (Large Shareholding Report). These filings are required when any entity acquires 5% or more of a Japanese listed company's shares, similar to SEC Schedule 13D filings.

Q: What if I get no results?

• Verify your company name/code is correct
• Try a broader date range (some companies file infrequently)
• Check your document type filter -- the default only shows Annual Reports (type 120)
• EDINET does not publish filings on weekends or Japanese national holidays

Q: How far back does the data go? EDINET maintains approximately 10 years of filing history.

Who uses Japanese financial filing data?

• Foreign investors: Monitor Japanese company filings without reading Japanese
• Activist tracking: Watch for large shareholding reports (5%+ ownership changes)
• Quant and financial data engineers: Automated ingestion of Japanese corporate filings for data pipelines
• Academic research: Bulk download filings for corporate finance studies
• Due diligence: Quickly find all filings from a specific company
• ESG and compliance analysts: Track Japanese corporate governance disclosures

Integrations with data pipelines and tools

This actor works with all Apify platform features:

• Schedule runs to check for new filings daily or weekly
• API access to trigger runs and fetch results programmatically (Python, Node.js, REST API)
• Webhooks to get notified when new filings are found
• Export results to Google Sheets, CSV, JSON, or databases
• Integrate with LangChain, LlamaIndex, and other AI/LLM tools for financial analysis

Legal

This actor accesses publicly available data from EDINET, a government-operated disclosure system. EDINET data is published under the Public Data License 1.0 (PDL1.0). Users should also review EDINET's API Terms of Use upon registration. PDL1.0 permits commercial use, redistribution, and modification with attribution. Each output record includes a dataSource field for compliance.

This actor is not affiliated with or endorsed by the Financial Services Agency of Japan.