EDINET

7.4.2

EDINET

最終更新 2024-06-27 読了時間 2 分

まとめ

EDINET API v2で書類一覧を取得し、特定企業の有価証券報告書を自動検索する。
DocIDを指定してPDFやCSVなどの開示書類をPythonでダウンロードする。
pandasでDataFrame化し、分析に使えるデータパイプラインを構築する。

EDINETのAPIを使用してみる #

Pythonで四半期報告書のPDFデータを取得するために、EDINETを使います。以下のコンテンツではEDINET閲覧サイトから取得できる情報をもとにデータを加工して作成しています。本ページに記載されているコードの実行や取得したデータの利用についてはEDINETの利用規約を確認し理解した上で利用してください。また、Version2のAPIを使用する際はログイン認証＋APIキーの発行が必要になります。

使用時には必ず利用規約（PDF・web）を確認した上で常識の範囲内での使用にとどめてください。

1
2
3
4
5
import os
import requests
import pandas as pd

API_ENDPOINT = "https://disclosure.edinet-fsa.go.jp/api/v2"  # v2を使用する

書類一覧APIのリクエストURL #

11_EDINET_API仕様書に従って書類一覧を取得してみます。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
request_params = {
    "date": "2024-02-09",
    "type": 2,  # 1=メタデータのみ、2=提出書類一覧及びメタデータ
    "Subscription-Key": os.environ.get(
        "EDINET_API_KEY"
    ),  # v1を使用する場合は不要, 2024年３月29日（金）まで利用可能
}

docs_submitted_json = requests.get(
    f"{API_ENDPOINT}/documents.json", request_params
).json()

取得データの確認 #

今は四半期報告書を取得したいので、『四半期報告書』が文書の説明（docDescription）に含まれている行のみを抽出して確認します。

1
2
3
sd_df = pd.DataFrame(docs_submitted_json["results"])
sd_df = sd_df[sd_df["docDescription"].str.contains("四半期報告書", na=False)]
sd_df.head()

	seqNumber	docID	edinetCode	secCode	JCN	filerName	fundCode	ordinanceCode	formCode	docTypeCode
1	2	S100SSMQ	E04505	95070	9470001001933	四国電力株式会社	None	010	043000	140
2	3	S100SSHR	E01441	59730	5122001016280	株式会社トーアミ	None	010	043000	140
5	6	S100SQAH	E30982	71750	9220001001223	今村証券株式会社	None	010	043000	140
6	7	S100SPH6	E03562	83600	3090001002315	株式会社　山梨中央銀行	None	010	043000	140
10	11	S100SRF2	E00783	40910	7010701015826	日本酸素ホールディングス株式会社	None	010	043000	140

5 rows × 29 columns

DocIDの確認 #

商船三井の四半期報告書のDocIDを確認してみます。filerNameに商船三井が含まれる行のみを抽出します。

1
sd_df[sd_df.filerName.str.contains("商船三井")]

	seqNumber	docID	edinetCode	secCode	JCN	filerName	fundCode	ordinanceCode	formCode	docTypeCode
1307	1308	S100STH6	E04236	91040	4010401082896	株式会社商船三井	None	010	043000	140

1 rows × 29 columns

四半期報告書の取得 #

docID をもとに四半期報告書の取得に必要なデータを取得します。pdfを取得したい場合はマニュアルに従い、type=2を指定します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
docID = "S100STH6"
pdf_response = requests.get(
    f"{API_ENDPOINT}/documents/{docID}",
    {
        "type": 2,
        "Subscription-Key": os.environ.get("EDINET_API_KEY"),
    },
)

with open("sample.pdf", "wb") as f:
    f.write(pdf_response.content)

ダウンロードしたpdfを表示する #

1
2
3
4
from IPython.display import display_pdf

with open("sample.pdf", "rb") as f:
    display_pdf(f.read(), raw=True)

（pdfの表示は省略します）