EDINET APIをPythonで使う｜有価証券報告書を検索して取得する

https://api.edinet-fsa.go.jp/api/v2/documents.json

import os

import requests

BASE = "https://api.edinet-fsa.go.jp/api/v2"
API_KEY = os.environ["EDINET_API_KEY"]


def fetch_document_list(date: str) -> dict:
    """指定日の提出書類一覧を取得する"""
    res = requests.get(
        f"{BASE}/documents.json",
        params={"date": date, "type": 2, "Subscription-Key": API_KEY},
        timeout=30,
    )
    res.raise_for_status()
    return res.json()


data = fetch_document_list("2026-06-25")
print(data["metadata"]["resultset"]["count"], "件")

def fetch_document_list(date: str) -> dict:
    res = requests.get(
        f"{BASE}/documents.json",
        params={"date": date, "type": 2, "Subscription-Key": API_KEY},
        timeout=30,
    )
    res.raise_for_status()  # これだけでは足りない
    payload = res.json()

    status = payload["metadata"]["status"]
    if status != "200":
        message = payload["metadata"]["message"]
        raise RuntimeError(f"EDINET API error: {status} {message}")

    return payload

{
  "seqNumber": 1,
  "docID": "S1000001",
  "edinetCode": "E10001",
  "secCode": "10000",
  "filerName": "エディネット株式会社",
  "docTypeCode": "120",
  "periodStart": "2022-04-01",
  "periodEnd": "2023-03-31",
  "submitDateTime": "2023-06-12 12:34",
  "docDescription": "有価証券報告書－第1期(令和4年4月1日－令和5年3月31日)",
  "xbrlFlag": "1",
  "csvFlag": "1",
  "withdrawalStatus": "0",
  "legalStatus": "1"
}

def filter_annual_reports(payload: dict) -> list[dict]:
    """有価証券報告書かつXBRLありのものだけ抜き出す"""
    return [
        doc
        for doc in payload["results"]
        if doc["docTypeCode"] == "120"
        and doc["xbrlFlag"] == "1"
        and doc["withdrawalStatus"] == "0"
    ]


docs = filter_annual_reports(data)
for doc in docs:
    print(doc["docID"], doc["secCode"], doc["filerName"])

https://api.edinet-fsa.go.jp/api/v2/documents/{docID}

from pathlib import Path


def download_document(doc_id: str, doc_type: int, out_dir: Path) -> Path:
    """書類を取得して保存する"""
    res = requests.get(
        f"{BASE}/documents/{doc_id}",
        params={"type": doc_type, "Subscription-Key": API_KEY},
        timeout=60,
    )
    res.raise_for_status()

    # 成功/失敗はContent-Typeで判定する
    content_type = res.headers.get("Content-Type", "")
    if content_type.startswith("application/json"):
        raise RuntimeError(f"取得失敗 {doc_id}: {res.json()['metadata']}")

    suffix = ".pdf" if content_type.startswith("application/pdf") else ".zip"
    out_dir.mkdir(parents=True, exist_ok=True)
    path = out_dir / f"{doc_id}{suffix}"
    path.write_bytes(res.content)
    return path

import time

out_dir = Path("edinet")

for doc in docs:
    try:
        path = download_document(doc["docID"], doc_type=5, out_dir=out_dir)
        print("saved:", path, doc["filerName"])
    except RuntimeError as e:
        print("skip:", e)
    time.sleep(1)  # 連続リクエストを避ける

path = out_dir / f"{doc['docID']}.zip"
if path.exists():
    continue

S1000001.zip
├── PublicDoc/   提出本文書（XBRL または インラインXBRL）、マニフェスト、タクソノミ
└── AuditDoc/    監査報告書（インラインXBRL）、マニフェスト、タクソノミ