Skip to main content
POST
/
v1
/
companies
/
search
curl --request POST \
  --url https://openapi.enginy.ai/v1/companies/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "page": 1,
  "pageSize": 25,
  "search": "analytics",
  "include": {
    "companyGroup": [
      42
    ],
    "industry": [
      "Software"
    ],
    "numberOfEmployees": [
      "50",
      "500"
    ]
  }
}
'
{
  "data": [
    {
      "id": 123,
      "name": "<string>",
      "domain": "<string>",
      "website": "<string>",
      "companyLinkedInUrl": "<string>",
      "industry": "<string>",
      "rangeOfEmployees": "<string>",
      "numberOfEmployees": 123,
      "yearfounded": "<string>",
      "description": "<string>",
      "country": "<string>",
      "city": "<string>",
      "streetAddress": "<string>",
      "phoneNumber": "<string>",
      "companyEmail": "<string>",
      "revenueRange": "<string>",
      "hiringOnLinkedIn": true,
      "openJobPositions": 123,
      "companyCRMId": "<string>",
      "isCompanyInCRM": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "smartFieldExplanations": {}
    }
  ],
  "meta": {
    "page": 123,
    "pageSize": 123,
    "total": 123
  }
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
page
integer
default:1

Page number for pagination. Minimum value is 1.

Required range: x >= 1
​
pageSize
integer
default:25

Number of items per page. Minimum is 1, maximum is 100.

Required range: 1 <= x <= 100
​
search
string

Search term for full-text search across company fields.

​
include
object

Filter conditions to include. Supports special filters like id, companyGroup, campaigns, leadsCount, isCompanyInCRM, and any company field ID returned by the fields endpoint. Filter values should match the field data type returned by GET /v1/companies/fields: text/select fields use arrays of exact values, numeric fields use two-item range arrays like ["10","100"], boolean fields use one-item arrays like [true], and timestamp fields use { "startDate": "...", "endDate": "..." }. Start with id, companyGroup (company list IDs), campaigns, leadsCount, isCompanyInCRM, and any workspace scoring fields such as icpScore or scoreBand when those field IDs appear in the fields response. Use GET /v1/companies/fields to discover valid company field names for fields, include, exclude, and update payloads.

​
exclude
object

Filter conditions to exclude. Same structure as include. Filter values should match the field data type returned by GET /v1/companies/fields: text/select fields use arrays of exact values, numeric fields use two-item range arrays like ["10","100"], boolean fields use one-item arrays like [true], and timestamp fields use { "startDate": "...", "endDate": "..." }. Start with id, companyGroup (company list IDs), campaigns, leadsCount, isCompanyInCRM, and any workspace scoring fields such as icpScore or scoreBand when those field IDs appear in the fields response. Use GET /v1/companies/fields to discover valid company field names for fields, include, exclude, and update payloads.

Response

200 - application/json

Successful response with paginated companies

​
data
object[]
required
​
meta
object
required