すべての APIexpand_more

株主優待の一覧

GET/stable/shareholder-benefits-list1 回 10 トークン新着

株主優待のある会社を 1 社 1 行で返します。権利確定月、最少の必要株数と最低投資額、優待の種類、最少株数の段の品目と記載金額・年額、長期保有の優遇や選択式の有無が入ります。権利確定月・種類・必要株数・投資額で絞り込め、証券コード順に limit と offset でページを送れます。scope=all にすると、優待なしと確認済みの会社と未確認の会社も含めます。

この API でできること

check_circle3 月に権利が確定する優待を一覧にする
check_circle10 万円以下で優待が受けられる銘柄を探す
check_circleQUO カードやカタログギフトなど種類別に優待を比べる

例の URL

https://api.zenithcode.net/stable/shareholder-benefits-list?asOf=2026-10-19&scope=published&month=3&type=quo_card&minSharesLowerThan=100&minInvestmentLowerThan=300000&limit=100&offset=0

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

パラメータ

引数	必須	説明	例
`asOf` string	任意	掲載の基準日（YYYY-MM-DD、日本時間）。省略すると今日	`2026-10-19`
`scope` select	任意	published = 現在または予定の制度がある会社（既定）、all = 優待なしと確認済み・未確認の会社も含める選べる値: published, all	`published`
`month` number	任意	権利確定月（1〜12）（最大 12）	`3`
`type` select	任意	優待の種類。quo_card / gift_card / own_product / discount / catalog / points / donation / other 選べる値: quo_card, gift_card, own_product, discount, catalog, points, donation, other	`quo_card`
`minSharesLowerThan` number	任意	最少の必要株数がこの値以下の会社だけ	`100`
`minInvestmentLowerThan` string	任意	最低投資額（円）がこの値以下の会社だけ	`300000`
`limit` number	任意	返す件数の上限（既定 100、最大 2,000）	`100`
`offset` string	任意	先頭から読み飛ばす件数（既定 0）	`0`

試してみる

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

travel_exploreAPI ビューワーで試す

応答の例（実データ）

lock

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

レスポンス項目

`symbol`	string
`companyName`会社名	string	会社名
`sectorCode`業種コード	string	業種コード
`hasBenefits`3 値（null は「優待なし」ではない）	boolean	3 値（null は「優待なし」ではない）
`coverageStatus`確認の範囲	string	確認の範囲
`hasCurrent`現在の制度がある	boolean	現在の制度がある
`hasScheduled`予定の制度がある	boolean	予定の制度がある
`recordMonths`権利確定月	array	権利確定月
`minShares`最少の必要株数	number	最少の必要株数
`minInvestmentJpy`最低投資額（円）	number	最低投資額（円）
`priceDate`株価の日付	string	株価の日付
`benefitTypes`優待の種類	array	優待の種類
`headline`最少株数の段の品目（最大 2）	array	最少株数の段の品目（最大 2）
`statedValueJpyMin`最少株数の段の記載金額の最小	number	最少株数の段の記載金額の最小
`annualValueJpyMin`最少株数の段の年額の最小	number	最少株数の段の年額の最小
`annualValueBasis`年額の求め方	string	年額の求め方
`annualValueTimesSource`回数の根拠	string	回数の根拠
`hasLongTermBonus`長期保有の優遇がある	boolean	長期保有の優遇がある
`hasChoice`選択式がある	boolean	選択式がある
`programCount`制度の数	integer	制度の数
`hasAlternativePrograms`制度どうしが選択	boolean	制度どうしが選択
`hasAudiencePrograms`制度ごとに対象の株主が違う	boolean	制度ごとに対象の株主が違う
`nextRecordDate`予定の制度の最初の基準日	string	予定の制度の最初の基準日
`lastReviewedAt`最新の照合日	string	最新の照合日

よくある質問

一覧に載っていない会社は優待が無いのですか？expand_more

必ずしもそうではありません。まだ確認できていない会社は載りません。scope=all で確認状況（hasBenefits）を見られます。

1 回の呼び出しでトークンをいくつ使いますか？expand_more

10 トークンです。件数や期間によらず、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 のように両方の項目で常に返ります。項目名は日英とも同じです。