Start an employee search

curl --request POST \
  --url https://app.loice.ai/api/v1/employee-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lookup": {
    "mode": "domain",
    "value": "acme.io"
  },
  "count": 25
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({lookup: {mode: 'domain', value: 'acme.io'}, count: 25})
};

fetch('https://app.loice.ai/api/v1/employee-search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const url = 'https://app.loice.ai/api/v1/employee-search';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({lookup: {mode: 'domain', value: 'acme.io'}, count: 25})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://app.loice.ai/api/v1/employee-search"

payload = {
    "lookup": {
        "mode": "domain",
        "value": "acme.io"
    },
    "count": 25
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "replay": false
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "<string>",
    "retryAfterSeconds": 123
  }
}

{
  "error": {
    "message": "<string>"
  }
}

{
  "error": {
    "message": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "<string>",
    "retryAfterSeconds": 123
  }
}

{
  "error": {
    "message": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "<string>",
    "retryAfterSeconds": 123
  }
}

API Reference

Start an employee search

Finds the current employees of ONE company, named by its website domain or its LinkedIn company URL, optionally filtered by title, seniority, department and location. Creates a background run like POST /api/v1/lead-search and returns immediately; poll and read it with GET /api/v1/lead-search/runs/{runId}. One active run per workspace at a time. Rate limited per workspace.

Billing

once per search, when any source answered; released when every source was unavailable.
per delivered employee, debited when the run finalizes; an empty run is free.

The current cost is shown in the app under Settings → Billing and in the live GET /api/v1/openapi.json. Calls that end in a system or provider error (HTTP 500) or are rate limited (HTTP 429) are not billed. The charged and pointsCharged fields of the response state what this call actually consumed.

POST

api

employee-search

Start an employee search

curl --request POST \
  --url https://app.loice.ai/api/v1/employee-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lookup": {
    "mode": "domain",
    "value": "acme.io"
  },
  "count": 25
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({lookup: {mode: 'domain', value: 'acme.io'}, count: 25})
};

fetch('https://app.loice.ai/api/v1/employee-search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const url = 'https://app.loice.ai/api/v1/employee-search';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({lookup: {mode: 'domain', value: 'acme.io'}, count: 25})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://app.loice.ai/api/v1/employee-search"

payload = {
    "lookup": {
        "mode": "domain",
        "value": "acme.io"
    },
    "count": 25
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "replay": false
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "<string>",
    "retryAfterSeconds": 123
  }
}

{
  "error": {
    "message": "<string>"
  }
}

{
  "error": {
    "message": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "<string>",
    "retryAfterSeconds": 123
  }
}

{
  "error": {
    "message": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "<string>",
    "retryAfterSeconds": 123
  }
}

Authorizations

Authorization

string

header

required

Workspace API key (loice_sk_ + 48 hex characters), created under Settings → API Keys. Sent as Authorization: Bearer loice_sk_…. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.

Body

application/json

lookup

object

required

Show child attributes

count

integer

required

Required range: 1 <= x <= 2500

filters

object

Show child attributes

Response

Run created, or refused uncharged with a reason (e.g. company-not-found).

data

object

required

Show child attributes