すべての APIexpand_more
主要な顧客(売上の 10% 以上)
GET
/stable/main-customers1 回 1 トークン有価証券報告書の注記から、売上高の 10% 以上を占める顧客を、顧客名、その顧客への売上高(円)、関連するセグメントとともに当期・前期で返します。該当する顧客がない会社には 404 を返します。
この API でできること
- check_circle特定の取引先に売上が偏っていないかを確認する
- check_circle部品メーカーなどの主要な納入先を調べる
- check_circle取引先ごとの売上の増減を前期と比べる
例の URL
https://api.zenithcode.net/stable/main-customers?symbol=7203&fiscalPeriod=2026-03読みやすいように符号化せずに表示しています。日本語などの値は、送るときに自動で符号化されます。
パラメータ
| 引数 | 必須 | 説明 | 例 |
|---|---|---|---|
symbolstring | 必須 | 証券コード(4 桁。例: 7203 = トヨタ自動車。130A のような英字入りも可) | 7203 |
fiscalPeriodstring | 任意 | 決算期(YYYY-MM。例: 2026-03 = 2026 年 3 月期)。省略すると最新 | 2026-03 |
試してみる
自分の条件で実行して、応答を表・JSON・CSV で確かめられます。ログインが必要で、実行するたびに 1 トークンを使います。
travel_exploreAPI ビューワーで試す応答の例(実データ)
lock
実データの応答例は、ログインした方だけに表示しています(株価などの取引所データを含むため)。 ログインして見る
レスポンス項目
symbol | string | |
fiscalPeriod | string | |
period | string | |
docId | string | |
docTypeCode | string | |
submittedAt | string | |
sourceUrlEDINET原本へのリンク | string | EDINET原本へのリンク |
sourceTag表を取った TextBlock のタグ | string | 表を取った TextBlock のタグ |
customers | array |
関連する API
よくある質問
404 が返るのはなぜですか?expand_more
売上の 10% 以上を占める顧客が報告書に記載されていない会社だからです。エラーではなく「該当なし」を意味します。
1 回の呼び出しでトークンをいくつ使いますか?expand_more
1 トークンです。件数や期間によらず、1 回の呼び出しごとに同じ数を使います。月の上限はプランによって決まります。
試すのに登録は必要ですか?expand_more
API ビューワーで、自分の条件で実行して応答を確かめられます。無料登録してログインしてください(クレジットカード不要)。実行するたびに、この API のトークンを使います。
CSV で受け取れますか?expand_more
URL に format=csv を付けると CSV で返ります。表計算ソフトや pandas にそのまま読み込めます。
英語で受け取れますか?expand_more
lang も Accept-Language も無いと、業種名などの label は英語で返ります。日本語にするには lang=ja を付けるか、Accept-Language: ja を送ります。企業名・業種名は nameJa / nameEn、sectorJa / sectorEn のように両方の項目で常に返ります。項目名は日英とも同じです。

