StockCode API ドキュメント
日米の一次データ＋独自スコアを返すREST APIです。バージョン v1。 下のエンドポイントは認証不要・read-onlyで、このページからそのまま実行できます。
ライブで試す
本物のレスポンスJSONが返ります（サンプルデータ）。
ライブで試す（認証不要・read-only）
GET
/api/v1/companies?region=US&tag=AI&limit=3「実行 ▶」を押すと、本物のレスポンスJSONが表示されます。ベースURL
/api/v1
本番は https://stockcode.io/api/v1
認証
x-api-key（本番）
サンプルは不要。キーはβで発行
形式
REST / JSON
UTF-8・GET中心
エンドポイント
| GET | /api/v1/companies日米企業の基本属性・主要ファンダメンタルズ・独自スコアを一覧取得。region / tag / limit で絞り込み。 | 稼働中 |
| GET | /api/v1/companies/{ticker}1社のフル財務（損益・長期推移）、セグメント別売上、株主還元、コスト構造、出典メタを取得。 | 稼働中 |
| GET | /api/v1/scoresAI・宇宙・自動化のStockCode独自スコア（時系列）。テーマ・ランキング生成に。 | β |
| GET | /api/v1/segments/{ticker}事業セグメント別の売上・構成比・前年比（出典付き）。 | β |
| GET | /api/v1/search自然文・タグ・指標で日米を横断検索。関連企業・記事を返す。 | β |
| GET | /api/v1/articles一次データ駆動の記事本文・要約・FAQをJSONで取得（メディア・RAG用途）。 | β |
| GET | /api/v1/shorts/{ticker}縦型ショート動画の台本（シーン・ナレ・強調語）JSON。動画自動生成に。 | β |
| POST | /api/v1/webhooks登録銘柄の決算・適時開示が出た瞬間にプッシュ通知（TDnet仕入れ）。 | β |
| POST | /api/v1/ai/ground質問に対し、一次データ＋出典をRAG用に整形して返す（自社AIに組み込み）。 | β |
クエリ：GET /api/v1/companies
| パラメータ | 型 | 説明 |
|---|---|---|
region | string | JP / US で地域を絞り込み |
tag | string | テーマタグ（例: AI, 半導体, 宇宙）で絞り込み |
sector | string | 業種で絞り込み |
q | string | 社名・ティッカー・タグの自由文検索 |
limit | number | 取得件数（1〜200・既定50） |
offset | number | ページング開始位置（既定0） |
レート制限
- ・サンプル（demo）: 60 req/min/IP 目安
- ・Free: 3,000コール/月（100/日）
- ・Developer: 50,000コール/月
- ・Business: 500,000コール/月
超過時は 429 を返します（本番）。
ステータスコード
200成功400リクエスト不正（bad_request）404対象なし（not_found）429レート上限超過（本番・プラン上限）5xxサーバエラー本番キーが必要になったら
現在 44 社のディープデータ＋14,038社のユニバースを公開中。 商用・本番利用はクローズドβでキーを発行します。
APIキーを申請する※情報提供のみを目的とし、投資助言ではありません。数値は一次データに基づく派生データです。