Data API

Discover matching company candidates from external sources.

Last updated: July 14, 2026

Summary

The Data API is for discovering company candidates that do not yet exist in your Sanka workspace.The current Data API endpoint is POST /v2/prospect/companies. Send either a freeform search query or structured filters, then use the returned candidates for review, Sanka company creation, or downstream sync to systems such as HubSpot or Salesforce.

Endpoint

API	Endpoint	Input	Output
Company discovery	`POST /v2/prospect/companies`	Freeform `query` or structured filters such as industry, location, and headcount	Ranked list of matching company candidates

The Data API uses the root /v2 namespace, not /v2/public/....

When to use it

Find new companies that match a target profile
Pass a natural-language search request directly into the API
Filter by location, industry, and employee-count range in the same request
Review candidates before creating Sanka company records through the Object API

After discovering company candidates, use the AI API when you need enrichment or scoring.

Authentication

Send a Developer API key in the Authorization header. Because this endpoint uses POST, use a key with Full access.

Bash

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

The Data API also respects the workspace-level AI credit budget. When credits are exhausted, the endpoint returns 402 Payment Required with a code you can use to notify the workspace admin.

Example: Find company candidates

cURL

curl -X POST "https://api.sanka.com/v2/prospect/companies" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "find manufacturing companies in Tokyo with more than 200 employees",
    "limit": 10,
    "sources": ["exa"]
  }'

You can also skip the freeform query and use structured filters only:

JSON

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

See Company discovery for request patterns, response fields, and the interactive playground.

Notes

The Data API returns candidates; it does not create or update Sanka company records.
To register a candidate in Sanka, review it first and then call POST /v2/public/companies through the Object API.
To enrich or evaluate a candidate, use the AI API endpoints POST /v2/enrich and POST /v2/score.
For high-volume jobs, distribute requests within the documented rate limits.

PreviousPOST Approve Incentive NextCompany Discovery