米国企業データカタログ (API v4)

概要

米国企業データカタログは、バフェット・コードWeb API v4で提供している米国企業のAPIエンドポイント一覧とその最終更新日時をSQLiteデータベースとして提供するメタデータです。

SQLを用いてデータを探せるため、ファイルベースのメタデータに比べ、効率的なデータ収集が可能になります。

利用例

下記コマンドでSQLiteデータベースを開くことができます。

sqlite3 us_data_catalog.db

下記のようなSQLクエリを実行することで、データを探すことができます。

-- Apple を含む、企業情報を探す
SELECT * FROM us_companies_resources WHERE name_en LIKE '%Apple%';

-- 特定の企業IDの四半期データを確認
SELECT * FROM us_companies_quarterly_resources 
WHERE cik = '0000320193' 
ORDER BY year DESC, quarter DESC;

-- 最近更新されたデータを探す
SELECT * FROM us_companies_resources 
WHERE updated_at > '2024-01-01' 
ORDER BY updated_at DESC;

取得方法

メタデータダウンロードリンク生成APIを使用してZIPファイルを取得できます。そのZIPファイルを展開するとus_data_catalog.dbファイル（SQLiteデータベース）が得られます。

テーブル一覧

us_data_catalog.dbには以下の6つのテーブルが含まれます。各テーブルは、/api/v4/us/ 以下のAPIエンドポイントに対応しています。

テーブル名 説明
us_companies_resources 企業情報取得APIのエンドポイント一覧
us_companies_stocks_resources 銘柄情報取得APIのエンドポイント一覧
us_companies_quarterly_resources 四半期財務数値取得APIのエンドポイント一覧
us_companies_daily_resources 日次株価指標取得APIのエンドポイント一覧
us_companies_stocks_quarterly_resources 銘柄四半期株価指標取得APIのエンドポイント一覧
us_companies_stocks_daily_resources 銘柄日次株価指標取得APIのエンドポイント一覧

us_companies_resources

企業情報取得APIに対応するAPIパスと最終更新日時、検索用メタデータを保持するテーブルです。

カラム名 型 説明 例
path TEXT APIエンドポイントのパス /api/v4/us/companies/0000320193
cik TEXT 企業のCIK 0000320193
name_en TEXT 企業名（英語） Apple Inc.
updated_at DATETIME 最終更新日時（UTC） 2025-06-30 12:42:14.646152

us_companies_stocks_resources

銘柄情報取得APIに対応するAPIパスと最終更新日時、検索用メタデータを保持するテーブルです。

カラム名 型 説明 例
path TEXT APIエンドポイントのパス /api/v4/us/companies/0000320193/stocks/AAPL
cik TEXT 企業のCIK 0000320193
ticker TEXT 銘柄コード AAPL
updated_at DATETIME 最終更新日時（UTC） 2025-06-30 12:42:14.646152

us_companies_quarterly_resources

四半期財務数値取得APIに対応するAPIパスと最終更新日時、検索用メタデータを保持するテーブルです。

カラム名 型 説明 例
path TEXT APIエンドポイントのパス /api/v4/us/companies/0000320193/quarterly/2024Q4
cik TEXT 企業のCIK 0000320193
year INTEGER 年 2024
quarter INTEGER 四半期 4
updated_at DATETIME 最終更新日時（UTC） 2025-06-30 12:42:14.646152

us_companies_daily_resources

日次株価指標取得APIに対応するAPIパスと最終更新日時、検索用メタデータを保持するテーブルです。

カラム名 型 説明 例
path TEXT APIエンドポイントのパス /api/v4/us/companies/0000320193/daily/2024-12-31
cik TEXT 企業のCIK 0000320193
date DATE 日付 2024-12-31
updated_at DATETIME 最終更新日時（UTC） 2025-06-30 12:42:14.646152

us_companies_stocks_quarterly_resources

銘柄四半期株価指標取得APIに対応するAPIパスと最終更新日時、検索用メタデータを保持するテーブルです。

カラム名 型 説明 例
path TEXT APIエンドポイントのパス /api/v4/us/companies/0000320193/stocks/AAPL/quarterly/2024Q4
cik TEXT 企業のCIK 0000320193
ticker TEXT 銘柄コード AAPL
year INTEGER 年 2024
quarter INTEGER 四半期 4
updated_at DATETIME 最終更新日時（UTC） 2025-06-30 12:42:14.646152

us_companies_stocks_daily_resources

銘柄日次株価指標取得APIに対応するAPIパスと最終更新日時、検索用メタデータを保持するテーブルです。

カラム名 型 説明 例
path TEXT APIエンドポイントのパス /api/v4/us/companies/0000320193/stocks/AAPL/daily/2024-12-31
cik TEXT 企業のCIK 0000320193
ticker TEXT 銘柄コード AAPL
date DATE 日付 2024-12-31
updated_at DATETIME 最終更新日時（UTC） 2025-06-30 12:42:14.646152