REST quickstart

You need an approved Datalayer account and a dashboard-issued API key. Search and lookup also require an active profile allowance. Public signup and paid checkout are not yet available. The production API base URL is https://api.datalayer.so. Run the examples from your terminal or backend, with DATALAYER_API_KEY supplied through your private environment or secret manager. Never embed it in frontend code or commit it to Git.

1. Check your key

This authentication check does not call a data provider or use profiles.

curl --fail-with-body https://api.datalayer.so/v1/auth \
  --header "Authorization: Bearer $DATALAYER_API_KEY"

{ "authenticated": true }

2. Search for a company

curl --fail-with-body https://api.datalayer.so/v1/companies/search \
  --header "Authorization: Bearer $DATALAYER_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"query":"Acme","limit":5,"offset":0}'

Search returns previews, not full profiles. Select the matching company_id from the returned results. Search uses zero profiles but still requires an active allowance and counts toward the account request limit.

3. Retrieve the selected company

Set COMPANY_ID to the returned ID. Set REQUEST_ID to a unique identifier for this lookup, such as a UUID. Keep that identifier for retries of the same request.

curl --fail-with-body https://api.datalayer.so/v1/companies/lookup \
  --header "Authorization: Bearer $DATALAYER_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data "{\"company_id\":\"$COMPANY_ID\"}"

A successful new lookup uses one profile. Inspect meta.profiles_used and meta.billing_status in the response. Eligible repeats and idempotent replays use zero additional profiles. A timeout alone does not prove zero usage; retry with the same key and unchanged input. See usage and retries.

Next steps

Search people using a query or company name.
Get a person, optionally including work email.
Read authentication and errors before integrating.

The OpenAPI specification describes all four data operations.

Developer guides

Companies

People

1. Check your key

2. Search for a company

3. Retrieve the selected company

Next steps

​1. Check your key

​2. Search for a company

​3. Retrieve the selected company

​Next steps

1. Check your key

2. Search for a company

3. Retrieve the selected company

Next steps