GET /companies/{companyId}/observations

GET /api/signal-foundry/companies/{companyId}/observations は、1 社に紐づく evidence-backed observation を返します。

このページは 1 社の feed 専用です。複数社をまたいで theme / evidence を探す場合は POST /observations/search を使います。

契約サマリー

リクエスト

curl -s \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  "https://signal-foundry.app/api/signal-foundry/companies/jpx_7203/observations?source=edinet&limit=5"

{companyId} は先に GET /companies または sf companies search ... --json で解決します。社名や自然文を直接渡さないでください。

クエリパラメータ

Sort order

結果は次の順で返ります。

1. observed_at desc
2. confidence desc

レスポンス

まず見る key:

• company.company_id
• observations[].observation_id
• observations[].type
• observations[].summary
• observations[].evidence
• observations[].observed_at
• meta.returned_observations
• meta.has_more

evidence は compact された JSON です。長い文字列や深い object は省略されるため、summary と合わせて読む前提にしてください。

{
  "company": {
    "company_id": "jpx_7203",
    "display_name": "トヨタ自動車"
  },
  "observations": [
    {
      "observation_id": "obs_...",
      "type": "corporate_profile",
      "subtype": "strategy",
      "source": "edinet",
      "summary": "有価証券報告書に記載された事業戦略の要約",
      "confidence": 0.92,
      "observed_at": "2026-04-30T00:00:00.000Z",
      "evidence": {}
    }
  ],
  "meta": {
    "company_id": "jpx_7203",
    "returned_observations": 1,
    "has_more": false
  }
}

この HTTP response では、observation feed は observations[] に入り、値の要約は observations[].summary で確認します。

CLI equivalent

sf companies search "7203" --json
sf company observations jpx_7203 --source edinet --limit 5 --json

エラー

復旧方法

1 社が決まっているのに 0 件の場合は、source / type / subtype filter を外して再実行します。会社自体が曖昧なら GET /companies?q=... か sf companies search ... --json に戻ります。

cross-company で探索したい場合は、この endpoint ではなく POST /observations/search を使います。company-observations は 1 社 feed、observations-search は cross-company search です。