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,
"tags": [
{
"id": 123,
"name": "<string>",
"color": "<string>"
}
],
"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
}
}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_READRate limit: 100 requests per minute
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,
"tags": [
{
"id": 123,
"name": "<string>",
"color": "<string>"
}
],
"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
Body
Page number for pagination. Minimum value is 1.
x >= 1Number of items per page. Minimum is 1, maximum is 100.
1 <= x <= 100Search term for full-text search across company fields.
Filter conditions to include. Supports special filters like id, companyGroup, companyTags, 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. intentSignals takes an array of signal ids (any of): hiringOnLinkedIn, websiteVisit, inTheNews. companyTags filters by the tags applied to the company: tag IDs from GET /v1/companies/tags (numbers or strings), with "" meaning no tag; in include a company matches any of them, in exclude none. It needs contact and company tags on the workspace, otherwise the search answers 400 ENTITY_TAGS_NOT_ENABLED. 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
Show child attributes
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. intentSignals takes an array of signal ids (any of): hiringOnLinkedIn, websiteVisit, inTheNews. companyTags filters by the tags applied to the company: tag IDs from GET /v1/companies/tags (numbers or strings), with "" meaning no tag; in include a company matches any of them, in exclude none. It needs contact and company tags on the workspace, otherwise the search answers 400 ENTITY_TAGS_NOT_ENABLED. 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
Show child attributes
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.