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

API リファレンス

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

API 概要
会社検索会社プロフィール構造化 Company Query会社の観測データ開示一覧求人検索会社の事例データ建設業許可検索クレジット残高クレジット利用サマリーフィードバックAPI
API リファレンス

GET /companies/{companyId}/profile

会社 identifiers と materialized profile を返す 入出力 を説明します。

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

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

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

契約サマリー

FieldValue
MethodGET
Path/api/signal-foundry/companies/{companyId}/profile
Authproduction は API key 必須
UsageCompany Card quota、request usage、rate limit に count
Credit1 request credit / operation credit 0
CLIsf company <companyId> --card --json / sf company profile <companyId> --json
NextCompany 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_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 会社 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_keyCLI なら sf login をやり直す。直接 API連携 なら API key を rotate する
429 rate_limit_exceededRetry-After まで待つ
daily_card_quota_exceeded / monthly_card_quota_exceededsf 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

このページの内容

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