Signal Foundry
ドキュメント
サポート 戻る
ドキュメントユースケースAPI リファレンスリリースノート

API リファレンス

認証、利用上限、主要 endpoint を実行単位で確認します。

API 概要
OpenAPI Inventory会社検索会社プロフィール会社の観測データ開示一覧開示詳細開示比較観測データ検索ソースAPIリストAPIリスト見積もりリスト候補確認リスト保存リストEnrichmentリストExport調査アイテムクレジット残高クレジット利用サマリーフィードバックAPI外部調査API
API リファレンス

GET /companies/{companyId}/profile

company identifiers と materialized profile を返す contract を説明します。

このページの内容8項目
契約サマリーリクエストパスパラメータクエリパラメータレスポンスCLI equivalent復旧方法次に進む先

GET /api/signal-foundry/companies/{companyId}/profile は、1 社の canonical record と現在地を返します。

この endpoint は search endpoint ではありません。社名や自然文を直接渡さず、先に GET /companies または sf companies search ... --json で canonical company_id を解決してください。

契約サマリー

FieldValue
MethodGET
Path/api/signal-foundry/companies/{companyId}/profile
Authproduction は API key 必須
Usagerequest usage に count
Creditdata credit は消費しない
CLIsf company profile <companyId> --json
Nextobservations / 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_7203
  • 7203
  • 法人番号などの normalized identifier

クエリパラメータ

なし

レスポンス

まず見る key:

  • company.company_id
  • company.display_name
  • identifiers[]
  • profile.profile
  • profile.website_domain
  • profile.latest_observed_at
  • meta.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_foundfree text を直接渡していないか確認し、GET /companies?q=... または sf companies search ... --json に戻る
401 invalid_api_keyAPI key を再発行し、CLI なら sf auth setup をやり直す
429 rate_limit_exceededRetry-After まで待つ
meta.has_profile=falsecompany は解決済み。company と identifiers を読み、必要なら observations / filings で evidence を確認する

次に進む先

  • 1 社の観測を時系列で見たい: GET /companies/{companyId}/observations
  • EDINET filing まで深掘りしたい: GET /companies/{companyId}/filings

このページの内容

契約サマリーリクエストパスパラメータクエリパラメータレスポンスCLI equivalent復旧方法次に進む先