API リファレンス
GET /companies/{companyId}/profile
company identifiers と materialized profile を返す contract を説明します。
このページの内容8項目
GET /api/signal-foundry/companies/{companyId}/profile は、1 社の canonical record と現在地を返します。
この endpoint は search endpoint ではありません。社名や自然文を直接渡さず、先に GET /companies または sf companies search ... --json で canonical company_id を解決してください。
契約サマリー
| Field | Value |
|---|---|
| Method | GET |
| Path | /api/signal-foundry/companies/{companyId}/profile |
| Auth | production は API key 必須 |
| Usage | request usage に count |
| Credit | data credit は消費しない |
| CLI | sf company profile <companyId> --json |
| Next | observations / filings / compare へ進む |
リクエスト
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 でも解決できる場合がありますが、agent / backend integration では必ず先に company resolver を通してください。
jpx_72037203- 法人番号などの normalized identifier
クエリパラメータ
なし
レスポンス
まず見る key:
company.company_idcompany.display_nameidentifiers[]profile.profileprofile.website_domainprofile.latest_observed_atmeta.has_profile
profile.profile には materialized company 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 response では、会社名は company.display_name で確認します。source と更新時刻は profile 本体ではなく、profile.latest_observed_at と各 observation / evidence 側で確認します。
CLI equivalent
sf companies search "7203" --json sf company profile jpx_7203 --json
CLI の最初の行で company_id を解決し、2 行目にその値を渡します。
復旧方法
| 状態 | 復旧 |
|---|---|
404 company_not_found | free text を直接渡していないか確認し、GET /companies?q=... または sf companies search ... --json に戻る |
401 invalid_api_key | API key を再発行し、CLI なら sf auth setup をやり直す |
429 rate_limit_exceeded | Retry-After まで待つ |
meta.has_profile=false | company は解決済み。company と identifiers を読み、必要なら observations / filings で evidence を確認する |
次に進む先
- 1 社の観測を時系列で見たい:
GET /companies/{companyId}/observations - EDINET filing まで深掘りしたい:
GET /companies/{companyId}/filings