GET /lists/{listId}/export

GET /api/signal-foundry/lists/{listId}/export は、saved List を CSV として書き出します。candidates preview は export できません。

契約サマリー

リクエスト

パスパラメータ

クエリパラメータ

例

curl -s "$SIGNAL_FOUNDRY_BASE_URL/api/signal-foundry/lists/00000000-0000-4000-8000-000000000000/export?format=csv" \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  -o ./exports/list.csv

CLI equivalent:

sf list export 00000000-0000-4000-8000-000000000000 --format csv --output ./exports/list.csv --json

レスポンス

HTTP response body は CSV です。CLI では file metadata を JSON で返します。

中心フィールド:

• path
• row_count
• sha256
• expires_at

CLI response example:

{
  "path": "./exports/list.csv",
  "row_count": 42,
  "sha256": "4c2d0f...",
  "expires_at": null
}

HTTP header:

• x-signal-foundry-row-count
• x-signal-foundry-credits-used

CSV に入るもの:

• canonical company fields
• saved List rows
• website enrichment columns
• Parallel enrichment columns:
  • parallel_enrichment_status
  • parallel_enrichment_charged
  • parallel_enrichment_enriched_at
  • parallel_enrichment_summary
  • parallel_enrichment_reason
  • parallel_enrichment_query
  • parallel_enrichment_urls
  • parallel_enrichment_signals
• source import 由来の source:<original_header> columns

Parallel enrichment を実行していない List では、これらの列は空になります。export は無料ですが、Parallel enrichment run は estimate 後に --execute --max-credits で実行します。

エラー

次に進む

export 前に追加情報が必要なら Lists Enrichments に戻ります。