Phase 2 / planned endpoint
POST
/search_companiesSearch companies
Search the planned company dataset by name, domain, industry, size, or revenue band. Returns ranked company profiles in the shared FetchSet envelope.
Request body
JSON object
querystring Free-text search across company name and domain.
Example:Northstar company_domainstring Exact domain filter.
Example:northstar.dev industrystring Industry label filter.
Example:Software limitinteger Number of results to return.
Example:Default: 10 Response
200 · Processed
A processed request returns status: "ok". The nested result may be empty; in that case tokens_charged remains zero.
results.results[] Ranked company records matching the filters.
results.total Total matches available for pagination.
metadata.tokens_charged Credits charged for the returned result. Zero for a miss.
metadata.fair_use Remaining records and reset timestamps for applicable plan windows.
Errors
Malformed request body
Missing or invalid API key
Unsupported filter value
Rate limit exceeded