Data API

条件に合う会社候補を外部ソースから検索するAPIです。

最終更新日: 2026/7/14

概要

Data API は、Sankaのワークスペースにまだ存在しない会社候補を外部ソースから検索するためのAPIです。現在のData APIでは、POST /v2/prospect/companies を使って、自然文の検索条件または構造化フィルタから会社候補を取得できます。候補はそのままSankaの会社レコード作成、社内確認、HubSpotやSalesforceへの後続連携に利用できます。

エンドポイント

API	エンドポイント	入力	出力
会社候補検索	`POST /v2/prospect/companies`	自然文の `query`、または業種・地域・従業員数などの構造化フィルタ	条件に合う会社候補のランキング

Data APIは /v2/public/... ではなく /v2 直下の名前空間を利用します。

使う場面

条件に合う新規会社を調査したいとき
自然文の検索条件をそのままAPIへ渡して候補一覧を取得したいとき
会社名だけでなく、所在地、業種、従業員規模で絞り込みたいとき
候補を確認してから、Object APIでSankaの会社レコードとして作成したいとき

会社候補を取得した後、より詳細な会社情報が必要な場合は AI API のエンリッチメントを使います。

認証

Data APIは、開発者APIキーを Authorization ヘッダーに指定して呼び出します。このエンドポイントはPOSTを使うため、フルアクセス のキーを利用してください。

Bash

Authorization: Bearer <api_key>
Content-Type: application/json

Data APIは、ワークスペース単位のAIクレジット残量も参照します。残量が無い場合は 402 Payment Required とコードが返るため、管理者へ通知する仕組みを用意してください。

例: 会社候補を検索する

cURL

curl -X POST "https://api.sanka.com/v2/prospect/companies" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "東京都の製造業で従業員200名以上の会社を探して",
    "limit": 10,
    "sources": ["exa"]
  }'

自然文を使わず、構造化フィルタだけでも検索できます。

JSON

{
  "location": "Tokyo",
  "industry": "manufacturing",
  "min_employee_count": 200,
  "limit": 10
}

リクエストパターンやレスポンス項目、インタラクティブなプレイグラウンドは会社候補検索を参照してください。

補足

Data APIは候補一覧を返す読み取り系APIで、Sanka上の会社レコードは作成・更新しません。
Sankaへ登録する場合は、候補を確認した後にObject APIの POST /v2/public/companies を呼び出してください。
取得した候補を補完・評価したい場合は、AI APIの POST /v2/enrich と POST /v2/score を使います。
大量処理を行う場合は、レート制限を守りつつリクエストを分散してください。

PreviousDELETE Delete Association Next会社候補検索