Search Companies

POST/api/v2/companies/query

Searches the companies in your workspace by name and/or domain (case-insensitive substring) and returns the matches with their id. Use the returned id as company_ids on Query leads to filter leads by company, or as the path id on Get company.

Provide at least one of name or domain. When both are given, only companies matching both are returned.

Request body

Field	Type	Description
name	string	Case-insensitive substring to match against company names.
domain	string	Case-insensitive substring to match against company website domains.
limit	integer	Maximum number of matches to return. Defaults to 20, maximum 50.

Example request

curl -X POST "https://api.getsillage.com/api/v2/companies/query" \
  -H "Authorization: Bearer $SILLAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "acme"}'

Example response

200 OK

{
  "data": [
    {
      "id": 789,
      "name": "Acme",
      "domain": "acme.com",
      "linkedin_handle": "acme"
    }
  ]
}

Response fields

Each item in data:

Field	Type	Description
id	integer	The company's id in your workspace. Pass it as `company_ids` to filter leads, or to Get company.
name	string or null	The company name.
domain	string or null	The company website domain.
linkedin_handle	string or null	LinkedIn handle. Useful as a stable key to dedup companies across your systems.

When no company name matches, data is an empty array.

Errors

Status	Meaning
400	Neither `name` nor `domain` was provided, or one is invalid.
401	The API key is missing or invalid.
403	The workspace does not have access to this resource.
429	Rate limit exceeded.
500	An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json.