SourceFinder API

SourceFinder サービスの公開 OpenAPI リファレンスです。

Base URL

https://api.coinpost.ai/sourcefinder

認証方式

API キーを CP-X-API-KEY ヘッダーで送信します。

形式例:

CP-X-API-KEY: <your-api-key>

エンドポイント

• GET /health — ヘルスチェック
• POST /sources — 非同期ソース探索ジョブを送信
• GET /sources/{id} — ジョブのステータスまたは結果を取得

リクエストの注意点

• POST /sources では title、content、source_urls のうち少なくとも 1 つが必要です
• 任意のリクエスト単位 LLM 上書きは llm 配下に指定します
• collected_at は不完全または相対的な日付の参照時刻として利用できます

レスポンスの共通形

• ソース探索ジョブのレスポンスは data フィールドにデータをラップします。/health はサービスメタデータを直接返します
• エラーレスポンスは error とメッセージ文字列を返します
• ジョブ結果には status フィールド（pending、processing、completed、failed）が含まれます
• 完了した結果には primary_sources、original_urls、メトリクス、truth_assessment が含まれる場合があります