POST /lists/{listId}/enrichments

List enrichment は、saved List に追加 column / evidence を足す endpoint pair です。先に estimate を実行し、必要 credit を確認してから run に進みます。Parallel は candidate set を saved List に固定した後の external enrichment です。broad search / Find All の入口にはしません。

契約サマリー

リクエスト

Estimate

curl -s "$SIGNAL_FOUNDRY_BASE_URL/api/signal-foundry/lists/00000000-0000-4000-8000-000000000000/enrichments/estimate" \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  -H "Content-Type: application/json" \
  --data '{
    "source": "website"
  }'

CLI equivalent:

sf list enrich 00000000-0000-4000-8000-000000000000 --source website --estimate --json
sf list enrich 00000000-0000-4000-8000-000000000000 --source parallel --estimate --limit 10 --json

Run

credit-consuming write です。execute: true、maxCredits、Idempotency-Key を付けます。

curl -s "$SIGNAL_FOUNDRY_BASE_URL/api/signal-foundry/lists/00000000-0000-4000-8000-000000000000/enrichments/run" \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: list-enrich-20260501-001" \
  --data '{
    "source": "website",
    "execute": true,
    "maxCredits": 35
  }'

CLI equivalent:

sf list enrich 00000000-0000-4000-8000-000000000000 --source website --execute --max-credits 35 --json
sf list enrich 00000000-0000-4000-8000-000000000000 --source parallel --execute --limit 10 --max-credits 10 --json

レスポンス

Estimate response

中心フィールド:

• estimate.estimated_target_companies
• estimate.estimated_max_credits
• estimate.reusable_existing_companies
• preview_rows
• billing.charges_only_found
• Parallel の場合は limit と external source scope

{
  "estimate": {
    "estimated_target_companies": 42,
    "estimated_max_credits": 35,
    "reusable_existing_companies": 7
  },
  "preview_rows": [
    {
      "company_id": "jpx_7203",
      "already_enriched": true
    }
  ],
  "billing": {
    "charges_only_found": true
  }
}

Run response

中心フィールド:

• run.run_id
• run.found_count
• run.not_found_count
• run.no_data_count
• run.skipped_count
• billing.credits_used
• billing.charges_only_found
• Parallel の場合は saved row に parallel_enrichment_* export columns の元になる summary / query / urls / signals が残る

{
  "run": {
    "run_id": "run_123",
    "found_count": 35,
    "not_found_count": 3,
    "no_data_count": 2,
    "skipped_count": 2
  },
  "billing": {
    "charges_only_found": true,
    "credits_used": 35
  }
}

website enrichment では billing.charges_only_found が true になり、billing.credits_used は run.found_count を超えません。not_found / no_data / skipped row は課金対象外です。

エラー

次に進む

enrichment 後に CSV が必要なら Lists Export に進みます。