Skip to main content
get company profile
The assistant tool is get_company_profile. Supply exactly one canonical company_id, bare website domain or public LinkedIn company profile_url. Domain/URL matches must agree with the returned reference. A name alone returns an ambiguity error: search and choose a canonical ID rather than silently selecting a similarly named business. include: ["workforce", "team", "hiring", "activity"] requests the complete bounded context for one credit with the base profile. All are off by default. Inspect data.sections, evidence, source dates, partial/truncated coverage and status. A valid base profile still costs one when optional context is unavailable. Workforce: 100 observations/past year; team: 100 indexed categories; hiring: ten postings from the past 90 days plus an indexed summary of counts by function and seniority, top titles, and median days open where both a posted date and a close date exist. A missing close date is excluded, not treated as still open. Function headcount trend is included only when it fits the lookup budget. Activity: five cached posts. Counts are indexed observations, not payroll, and are not confirmed hires. Unknown dates stay null. Eligible repeats and added context cost zero within 24 hours. dry_run and max_credits are supported. A website technology stack is not included; use get_tech_stack. Receipts and retries.

Authorizations

Authorization
string
header
required

Send Authorization: Bearer dl_live_<64 lowercase hexadecimal characters>. Signed-in users can create account-scoped, revocable keys in the Datalayer dashboard. A key does not grant credits. Dashboard session cookies are not API credentials.

Headers

Idempotency-Key
string

Recommended for every paid operation. Account-scoped and bound to normalized operation/input. Retry exactly the same key after transport loss: a committed credit result is replayed from persisted normalized bytes without a data lookup or another debit. Changed input, key expiry or paid-anchor expiry returns 409. In-flight requests return request_in_progress. Network delivery and D1 commit are not atomic. If omitted a request ID is created.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_-]{1,128}$

Body

application/json
company_id
string
required
Pattern: ^[1-9][0-9]{0,19}$
domain
string
Pattern: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$
name
string
Required string length: 1 - 200
profile_url
string<uri>
Maximum string length: 2000
include
enum<string>[]
Maximum array length: 4
Available options:
workforce,
team,
hiring,
activity
max_credits
integer

Advanced: highest number of credits this call may spend. The call is refused before any lookup when the estimate is higher.

Required range: 0 <= x <= 3
dry_run
boolean

Advanced: return the maximum credit estimate without looking up data.

Response

A settled result or a maximum estimate with no data lookup.

data
object
required
meta
object
required