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,
      "appUrl": "<string>",
      "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,
      "contactsCount": 123,
      "lastContactedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "smartFieldExplanations": {},
      "companyHeadcount": [
        {
          "employeeCount": 123,
          "threeMonthGrowth": 123,
          "sixMonthGrowth": 123,
          "oneYearGrowth": 123,
          "department": "<string>",
          "createdAt": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ],
  "meta": {
    "page": 123,
    "pageSize": 123,
    "total": 123
  }
}

Companies

Search companies with advanced filters

Search companies with advanced filtering options. Every key in include/exclude must be a recognized filter field (a static filter like id, companyGroup, or campaigns, or a company field id returned by the fields endpoint) — an unrecognized key returns a 400 listing the offending key(s) instead of being silently ignored.

Responses include direct Enginy app URLs when available. Each returned company includes an appUrl field. MCP agents should return those URLs to users whenever they are present in the response.

Required scope: COMPANIES_READ

Rate limit: 100 requests per minute

POST

companies

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,
      "appUrl": "<string>",
      "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,
      "contactsCount": 123,
      "lastContactedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "smartFieldExplanations": {},
      "companyHeadcount": [
        {
          "employeeCount": 123,
          "threeMonthGrowth": 123,
          "sixMonthGrowth": 123,
          "oneYearGrowth": 123,
          "department": "<string>",
          "createdAt": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ],
  "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

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. Unrecognized keys are rejected with a 400 rather than silently ignored. Use GET /v1/companies/fields (MCP tool get_company_field_metadata) to discover valid company field names for fields, include, exclude, and update payloads.

Show child attributes

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. Unrecognized keys are rejected with a 400 rather than silently ignored. Use GET /v1/companies/fields (MCP tool get_company_field_metadata) to discover valid company field names for fields, include, exclude, and update payloads.

Show child attributes

fields

Specific company fields to include in the response (comma-separated or array). Use GET /v1/companies/fields (MCP tool get_company_field_metadata) to discover valid company field names.

Response

200 - application/json

Successful response with paginated companies

data

object[]

required

Show child attributes

API documentation

Endpoints

Search companies with advanced filters

Authorizations

Body

Response