Skip to main content
Get company
Supply exactly one returned company_id or bare website domain, such as example.com. Do not include a URL scheme or path in a domain. If a domain matches more than one company, search first and use a returned ID. A successful new lookup uses one profile; eligible repeats are included. Send Idempotency-Key to make retries safe.

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

Recommended for lookup retries. A key is scoped to this account and bound to the normalized operation/input. Reuse it only for the same request within 24 hours; changed input, an expired key, or a different resolved profile returns 409. A replay refetches data but deducts no additional profile. If omitted, the server creates a request ID. A network failure after database commit starts can leave a completed deduction; a timeout alone does not imply zero usage.

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

Website domain, without scheme/path. Input is trimmed and normalized to lowercase.

Pattern: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$

Response

Normalized data with current shared account usage metadata.

data
object
required

Normalized search results or profile. Search results are previews. Full profile fields may be null when unavailable.

meta
object
required