GET /lists/candidates

GET /api/signal-foundry/lists/candidates は、estimate_id から保存前の候補 preview を返します。preview は無料ですが、saved List ではないため export できません。

契約サマリー

リクエスト

クエリパラメータ

例

curl -s "$SIGNAL_FOUNDRY_BASE_URL/api/signal-foundry/lists/candidates?estimate_id=est_123" \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>"

CLI equivalent:

sf list candidates --from-estimate est_123 --json

レスポンス

中心フィールド

• estimate.estimate_id
• companies[]
• companies[].company_id_hint
• companies[].company_hint
• companies[].reason
• meta.candidate_preview_only
• meta.exportable

例

{
  "estimate": {
    "estimate_id": "est_123",
    "definition_hash": "def_abc",
    "expires_at": "2026-05-01T12:00:00.000Z"
  },
  "companies": [
    {
      "company_id_hint": "jpx_7203",
      "company_hint": "Toyota Motor",
      "listing_status": "listed",
      "market_segment": "prime",
      "reason": "Matched revenue threshold and listed status"
    }
  ],
  "meta": {
    "candidate_preview_only": true,
    "exportable": false,
    "preview_is_free": true,
    "returned_companies": 1
  }
}

エラー

次に進む

保存する場合は POST /lists/materialize に進みます。保存しない探索なら、この preview を見て query を修正します。