API リファレンス
GET /companies/{companyId}/profile
会社 identifiers と materialized profile を返す 入出力 を説明します。
このページの内容8項目
GET /api/signal-foundry/companies/{companyId}/profile は、1 社の canonical record と現在地を返します。
この endpoint は search endpoint ではありません。社名や自然文を直接渡さず、先に GET /companies または sf company search ... --json で canonical company_id を解決してください。
契約サマリー
| Field | Value |
|---|---|
| Method | GET |
| Path | /api/signal-foundry/companies/{companyId}/profile |
| Auth | production は API key 必須 |
| Usage | Company Card quota、request usage、rate limit に count |
| Credit | 1 request credit / operation credit 0 |
| CLI | sf company <companyId> --card --json / sf company profile <companyId> --json |
| Next | Company Card / 必要な Signals へ進む |
リクエスト
curl -s \ -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \ "https://signal-foundry.app/api/signal-foundry/companies/jpx_7203/profile"
パスパラメータ
{companyId} には canonical company_id を渡します。登録済み identifier でも解決できる場合がありますが、エージェント / バックエンド連携 では必ず先に 会社 resolver を通してください。
jpx_72037203- 法人番号などの normalized identifier
クエリパラメータ
なし
レスポンス
まず見る key:
company.company_idcompany.display_nameidentifiers[]profile.profileprofile.website_domainprofile.latest_observed_atmeta.has_profile
profile.profile には materialized 会社 summary が入り、会社ごとに最新のサマリーが surfacing されます。website や EDINET 由来の情報もここで確認するのが基本です。
{
"company": {
"company_id": "jpx_7203",
"display_name": "トヨタ自動車",
"legal_name": "トヨタ自動車株式会社",
"listing_status": "listed",
"market_segment": "prime"
},
"identifiers": [
{
"type": "ticker",
"value": "7203",
"normalized_value": "7203"
}
],
"profile": {
"website_domain": "global.toyota",
"website_url": "https://global.toyota",
"latest_observed_at": "2026-04-30T00:00:00.000Z",
"profile": {},
"technologies": []
},
"meta": {
"company_id": "jpx_7203",
"requested_identifier": "jpx_7203",
"has_profile": true
}
}
この HTTP レスポンスでは、会社名は company.display_name で確認します。取得元と更新時刻は profile 本体ではなく、profile.latest_observed_at と各 observation / 根拠 側で確認します。
CLI equivalent
sf search "7203" --json sf company jpx_7203 --card --json
CLI の最初の行で company_id を解決し、2 行目にその値を渡します。
復旧方法
| 状態 | 復旧 |
|---|---|
404 company_not_found | 自由入力を直接渡していないか確認し、GET /companies?q=... または sf company search ... --json に戻る |
401 invalid_api_key | CLI なら sf login をやり直す。直接 API連携 なら API key を rotate する |
429 rate_limit_exceeded | Retry-After まで待つ |
daily_card_quota_exceeded / monthly_card_quota_exceeded | sf usage --json で残りと reset を確認し、読む会社を絞る。Credit Pack では Company Card quota は増えない |
meta.has_profile=false | 会社は解決済み。company と identifiers を読み、必要なら observations / filings で根拠を確認する |
次に進む先
- 1 社の観測を時系列で見たい:
GET /companies/{companyId}/observations - IR evidence まで深掘りしたい:
GET /companies/{companyId}/filings