Skip to main content
POST
Search companies

Authorizations

Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Body

application/json
domain
string
name
string
linkedinUrl
string
keywords
string
industries
string[]

Exact enum, e.g. Software Development. Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 50
locations
string[]

Cities, states, countries, or metros (free text). Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 50
headcountRanges
string[]

Exact buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.

Maximum array length: 20
exactMatch
boolean

Match free-text filters (name, locations, keywords) as whole strings. Default false. Domain, linkedinUrl and enum filters are always exact.

limit
integer
Required range: x <= 5000
offset
integer
Required range: 0 <= x <= 9007199254740991
pageToken
string

Opaque token from a previous response's metadata.nextPageToken.

preferCache
boolean

Response

Successful response

source
enum<string>
required
Available options:
live,
cache
companies
object[]
required

Search results normalized to the CRM upsert shape.

resolvedCompanyIds
string[]
required
creditsCharged
number
required
billing
object
metadata
object
{key}
any