無料でAPIキー取得
すべての APIexpand_more
search
appsすべての API
function指標の計算方法

主要な顧客(売上の 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

読みやすいように符号化せずに表示しています。日本語などの値は、送るときに自動で符号化されます。

パラメータ

引数必須説明例
symbol
string
必須証券コード(4 桁。例: 7203 = トヨタ自動車。130A のような英字入りも可)7203
fiscalPeriod
string
任意決算期(YYYY-MM。例: 2026-03 = 2026 年 3 月期)。省略すると最新2026-03

試してみる

自分の条件で実行して、応答を表・JSON・CSV で確かめられます。ログインが必要で、実行するたびに 1 トークンを使います。

travel_exploreAPI ビューワーで試す

応答の例(実データ)

lock
実データの応答例は、ログインした方だけに表示しています(株価などの取引所データを含むため)。 ログインして見る

レスポンス項目

symbolstring
fiscalPeriodstring
periodstring
docIdstring
docTypeCodestring
submittedAtstring
sourceUrlEDINET原本へのリンクstringEDINET原本へのリンク
sourceTag表を取った TextBlock のタグstring表を取った TextBlock のタグ
customersarray

関連する 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 のように両方の項目で常に返ります。項目名は日英とも同じです。