> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corsair.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# CompanyEnrich API reference

> API reference for CompanyEnrich: every `companyenrich.api.*` operation with input and output types.

> [!NOTE]
>
> **New to Corsair?** See [API access](https://docs.corsair.dev/concepts/api.md), [authentication](https://docs.corsair.dev/concepts/auth.md), and [error handling](https://docs.corsair.dev/concepts/error-handling).

## Account

### me

`account.me`

Get the authenticated user, credit balance and plan capabilities. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.account.me({});
```

**Input:** *empty object*

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `userId` | `string` | Yes | — |
| `credits` | `object` | Yes | — |
| `capabilities` | `object` | Yes | — |

> [accordion] credits full type
>
> ```ts theme={null}
> {
>   used: number,
>   total: number
> }
> ```

> [accordion] capabilities full type
>
> ```ts theme={null}
> {
>   lists: boolean,
>   previews: boolean,
>   companySearchLimit: number,
>   companySearchAsyncLimit: number,
>   peopleSearchLimit: number,
>   searchTermLimit: number
> }
> ```

***

## Companies

### autocomplete

`companies.autocomplete`

Suggest up to 10 companies whose domain starts with the query. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.companies.autocomplete({ query: 'acme' });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `query` | `string` | Yes | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   id: string,
>   name?: string | null,
>   domain: string,
>   logoUrl: string
> }[]
> ```

***

### enrichBatch

`companies.enrichBatch`

Enrich up to 50 company domains in one request. Costs 1 credit per unique company found.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.companies.enrichBatch({
	domains: ['acme.example', 'northstar.example'],
	expand: ['financial', 'technologies'],
	waitForEnrichment: true,
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `domains` | `string[]` | Yes | — |
| `expand` | `(financial \| keywords \| naicsCodes \| technologies \| workforce)[]` | No | — |
| `waitForEnrichment` | `boolean` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   domain: string,
>   status: found | not-found | invalid-domain | pending | string,
>   company?: {
>     id: string,
>     name?: string | null,
>     legalName?: string | null,
>     domain: string,
>     website: string,
>     logoUrl: string,
>     description?: string | null,
>     type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | string | null,
>     foundedYear?: number | null,
>     employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>     revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | string | null,
>     industry?: string | null,
>     industries?: string[] | null,
>     categories?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | string)[] | null,
>     location?: {
>       country?: {
>         code: string,
>         name: string
>       } | null,
>       state?: {
>         id: number,
>         name: string,
>         code?: string | null
>       } | null,
>       city?: {
>         id: number,
>         name: string
>       } | null,
>       address?: string | null,
>       postalCode?: string | null,
>       phone?: string | null
>     } | null,
>     socials?: {
>       linkedinUrl?: string | null,
>       linkedinId?: string | null,
>       twitterUrl?: string | null,
>       facebookUrl?: string | null,
>       instagramUrl?: string | null,
>       angellistUrl?: string | null,
>       crunchbaseUrl?: string | null,
>       youtubeUrl?: string | null,
>       githubUrl?: string | null,
>       g2Url?: string | null
>     } | null,
>     updatedAt: string,
>     financial?: {
>       stockSymbol?: string | null,
>       stockExchange?: string | null,
>       totalFunding?: number | null,
>       fundingStage?: string | null,
>       fundingDate?: string | null,
>       fundingRounds?: {
>         date?: string | null,
>         amount?: string | null,
>         type?: string | null,
>         url?: string | null,
>         investors?: string | null
>       }[] | null
>     } | null,
>     keywords?: string[] | null,
>     naicsCodes?: string[] | null,
>     technologies?: string[] | null,
>     workforce?: {
>       companyId: string,
>       domain: string,
>       observedEmployeeCount: number,
>       employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>       departmentHeadcount: {
>         cSuite?: number | null,
>         productManagement?: number | null,
>         engineeringTechnical?: number | null,
>         design?: number | null,
>         education?: number | null,
>         finance?: number | null,
>         humanResources?: number | null,
>         informationTechnology?: number | null,
>         legal?: number | null,
>         marketing?: number | null,
>         medicalHealth?: number | null,
>         operations?: number | null,
>         sales?: number | null,
>         consulting?: number | null
>       },
>       unclassifiedHeadcount: number,
>       historyFrom: string,
>       historyTo: string,
>       history?: {
>         date: string,
>         observedEmployeeCount: number,
>         employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>         departmentHeadcount: {
>           cSuite?: number | null,
>           productManagement?: number | null,
>           engineeringTechnical?: number | null,
>           design?: number | null,
>           education?: number | null,
>           finance?: number | null,
>           humanResources?: number | null,
>           informationTechnology?: number | null,
>           legal?: number | null,
>           marketing?: number | null,
>           medicalHealth?: number | null,
>           operations?: number | null,
>           sales?: number | null,
>           consulting?: number | null
>         },
>         unclassifiedHeadcount: number
>       }[] | null,
>       nextCursor?: string | null
>     } | null
>   } | null
> }[]
> ```

***

### enrichByDomain

`companies.enrichByDomain`

Enrich a company from its domain, optionally waiting for on-demand enrichment. Costs 1 credit per success.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.companies.enrichByDomain({
	domain: 'acme.example',
	expand: ['financial', 'workforce'],
	waitForEnrichment: true,
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `domain` | `string` | Yes | — |
| `expand` | `(financial \| keywords \| naicsCodes \| technologies \| workforce)[]` | No | — |
| `waitForEnrichment` | `boolean` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `id` | `string` | Yes | — |
| `name` | `string \| null` | No | — |
| `legalName` | `string \| null` | No | — |
| `domain` | `string` | Yes | — |
| `website` | `string` | Yes | — |
| `logoUrl` | `string` | Yes | — |
| `description` | `string \| null` | No | — |
| `type` | `private \| public \| self-employed \| self-owned \| partnership \| nonprofit \| educational \| government \| string \| null` | No | — |
| `foundedYear` | `number \| null` | No | — |
| `employees` | `1-10 \| 11-50 \| 51-200 \| 201-500 \| 501-1K \| 1K-5K \| 5K-10K \| over-10K \| string \| null` | No | — |
| `revenue` | `under-1m \| 1m-10m \| 10m-50m \| 50m-100m \| 100m-200m \| 200m-1b \| over-1b \| string \| null` | No | — |
| `industry` | `string \| null` | No | — |
| `industries` | `string[] \| null` | No | — |
| `categories` | `(b2b \| b2c \| b2g \| e-commerce \| media \| service-provider \| mobile \| saas \| local-business \| string)[] \| null` | No | — |
| `location` | `object \| null` | No | — |
| `socials` | `object \| null` | No | — |
| `updatedAt` | `string` | Yes | — |
| `financial` | `object \| null` | No | — |
| `keywords` | `string[] \| null` | No | — |
| `naicsCodes` | `string[] \| null` | No | — |
| `technologies` | `string[] \| null` | No | — |
| `workforce` | `object \| null` | No | — |

> [accordion] location full type
>
> ```ts theme={null}
> {
>   country?: {
>     code: string,
>     name: string
>   } | null,
>   state?: {
>     id: number,
>     name: string,
>     code?: string | null
>   } | null,
>   city?: {
>     id: number,
>     name: string
>   } | null,
>   address?: string | null,
>   postalCode?: string | null,
>   phone?: string | null
> } | null
> ```

> [accordion] socials full type
>
> ```ts theme={null}
> {
>   linkedinUrl?: string | null,
>   linkedinId?: string | null,
>   twitterUrl?: string | null,
>   facebookUrl?: string | null,
>   instagramUrl?: string | null,
>   angellistUrl?: string | null,
>   crunchbaseUrl?: string | null,
>   youtubeUrl?: string | null,
>   githubUrl?: string | null,
>   g2Url?: string | null
> } | null
> ```

> [accordion] financial full type
>
> ```ts theme={null}
> {
>   stockSymbol?: string | null,
>   stockExchange?: string | null,
>   totalFunding?: number | null,
>   fundingStage?: string | null,
>   fundingDate?: string | null,
>   fundingRounds?: {
>     date?: string | null,
>     amount?: string | null,
>     type?: string | null,
>     url?: string | null,
>     investors?: string | null
>   }[] | null
> } | null
> ```

> [accordion] workforce full type
>
> ```ts theme={null}
> {
>   companyId: string,
>   domain: string,
>   observedEmployeeCount: number,
>   employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>   departmentHeadcount: {
>     cSuite?: number | null,
>     productManagement?: number | null,
>     engineeringTechnical?: number | null,
>     design?: number | null,
>     education?: number | null,
>     finance?: number | null,
>     humanResources?: number | null,
>     informationTechnology?: number | null,
>     legal?: number | null,
>     marketing?: number | null,
>     medicalHealth?: number | null,
>     operations?: number | null,
>     sales?: number | null,
>     consulting?: number | null
>   },
>   unclassifiedHeadcount: number,
>   historyFrom: string,
>   historyTo: string,
>   history?: {
>     date: string,
>     observedEmployeeCount: number,
>     employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>     departmentHeadcount: {
>       cSuite?: number | null,
>       productManagement?: number | null,
>       engineeringTechnical?: number | null,
>       design?: number | null,
>       education?: number | null,
>       finance?: number | null,
>       humanResources?: number | null,
>       informationTechnology?: number | null,
>       legal?: number | null,
>       marketing?: number | null,
>       medicalHealth?: number | null,
>       operations?: number | null,
>       sales?: number | null,
>       consulting?: number | null
>     },
>     unclassifiedHeadcount: number
>   }[] | null,
>   nextCursor?: string | null
> } | null
> ```

***

### enrichByProperties

`companies.enrichByProperties`

Enrich a company from identifying properties such as name or social URLs. Costs 1 credit when a company is returned.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.companies.enrichByProperties({
	name: 'Example Systems',
	expand: ['keywords', 'technologies'],
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `name` | `string` | No | — |
| `linkedinUrl` | `string` | No | — |
| `linkedinId` | `string` | No | — |
| `twitterUrl` | `string` | No | — |
| `facebookUrl` | `string` | No | — |
| `instagramUrl` | `string` | No | — |
| `youtubeUrl` | `string` | No | — |
| `expand` | `(financial \| keywords \| naicsCodes \| technologies \| workforce)[]` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `id` | `string` | Yes | — |
| `name` | `string \| null` | No | — |
| `legalName` | `string \| null` | No | — |
| `domain` | `string` | Yes | — |
| `website` | `string` | Yes | — |
| `logoUrl` | `string` | Yes | — |
| `description` | `string \| null` | No | — |
| `type` | `private \| public \| self-employed \| self-owned \| partnership \| nonprofit \| educational \| government \| string \| null` | No | — |
| `foundedYear` | `number \| null` | No | — |
| `employees` | `1-10 \| 11-50 \| 51-200 \| 201-500 \| 501-1K \| 1K-5K \| 5K-10K \| over-10K \| string \| null` | No | — |
| `revenue` | `under-1m \| 1m-10m \| 10m-50m \| 50m-100m \| 100m-200m \| 200m-1b \| over-1b \| string \| null` | No | — |
| `industry` | `string \| null` | No | — |
| `industries` | `string[] \| null` | No | — |
| `categories` | `(b2b \| b2c \| b2g \| e-commerce \| media \| service-provider \| mobile \| saas \| local-business \| string)[] \| null` | No | — |
| `location` | `object \| null` | No | — |
| `socials` | `object \| null` | No | — |
| `updatedAt` | `string` | Yes | — |
| `financial` | `object \| null` | No | — |
| `keywords` | `string[] \| null` | No | — |
| `naicsCodes` | `string[] \| null` | No | — |
| `technologies` | `string[] \| null` | No | — |
| `workforce` | `object \| null` | No | — |

> [accordion] location full type
>
> ```ts theme={null}
> {
>   country?: {
>     code: string,
>     name: string
>   } | null,
>   state?: {
>     id: number,
>     name: string,
>     code?: string | null
>   } | null,
>   city?: {
>     id: number,
>     name: string
>   } | null,
>   address?: string | null,
>   postalCode?: string | null,
>   phone?: string | null
> } | null
> ```

> [accordion] socials full type
>
> ```ts theme={null}
> {
>   linkedinUrl?: string | null,
>   linkedinId?: string | null,
>   twitterUrl?: string | null,
>   facebookUrl?: string | null,
>   instagramUrl?: string | null,
>   angellistUrl?: string | null,
>   crunchbaseUrl?: string | null,
>   youtubeUrl?: string | null,
>   githubUrl?: string | null,
>   g2Url?: string | null
> } | null
> ```

> [accordion] financial full type
>
> ```ts theme={null}
> {
>   stockSymbol?: string | null,
>   stockExchange?: string | null,
>   totalFunding?: number | null,
>   fundingStage?: string | null,
>   fundingDate?: string | null,
>   fundingRounds?: {
>     date?: string | null,
>     amount?: string | null,
>     type?: string | null,
>     url?: string | null,
>     investors?: string | null
>   }[] | null
> } | null
> ```

> [accordion] workforce full type
>
> ```ts theme={null}
> {
>   companyId: string,
>   domain: string,
>   observedEmployeeCount: number,
>   employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>   departmentHeadcount: {
>     cSuite?: number | null,
>     productManagement?: number | null,
>     engineeringTechnical?: number | null,
>     design?: number | null,
>     education?: number | null,
>     finance?: number | null,
>     humanResources?: number | null,
>     informationTechnology?: number | null,
>     legal?: number | null,
>     marketing?: number | null,
>     medicalHealth?: number | null,
>     operations?: number | null,
>     sales?: number | null,
>     consulting?: number | null
>   },
>   unclassifiedHeadcount: number,
>   historyFrom: string,
>   historyTo: string,
>   history?: {
>     date: string,
>     observedEmployeeCount: number,
>     employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>     departmentHeadcount: {
>       cSuite?: number | null,
>       productManagement?: number | null,
>       engineeringTechnical?: number | null,
>       design?: number | null,
>       education?: number | null,
>       finance?: number | null,
>       humanResources?: number | null,
>       informationTechnology?: number | null,
>       legal?: number | null,
>       marketing?: number | null,
>       medicalHealth?: number | null,
>       operations?: number | null,
>       sales?: number | null,
>       consulting?: number | null
>     },
>     unclassifiedHeadcount: number
>   }[] | null,
>   nextCursor?: string | null
> } | null
> ```

***

### get

`companies.get`

Get a stored company by its CompanyEnrich ID. Costs 1 credit plus 1 per expansion (financial, keywords, NAICS codes, technologies, workforce with 12 months of history).

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.companies.get({
	companyId: '00000000-0000-4000-8000-000000000001',
	expand: ['financial', 'workforce'],
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `companyId` | `string` | Yes | — |
| `expand` | `(financial \| keywords \| naicsCodes \| technologies \| workforce)[]` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `id` | `string` | Yes | — |
| `name` | `string \| null` | No | — |
| `legalName` | `string \| null` | No | — |
| `domain` | `string` | Yes | — |
| `website` | `string` | Yes | — |
| `logoUrl` | `string` | Yes | — |
| `description` | `string \| null` | No | — |
| `type` | `private \| public \| self-employed \| self-owned \| partnership \| nonprofit \| educational \| government \| string \| null` | No | — |
| `foundedYear` | `number \| null` | No | — |
| `employees` | `1-10 \| 11-50 \| 51-200 \| 201-500 \| 501-1K \| 1K-5K \| 5K-10K \| over-10K \| string \| null` | No | — |
| `revenue` | `under-1m \| 1m-10m \| 10m-50m \| 50m-100m \| 100m-200m \| 200m-1b \| over-1b \| string \| null` | No | — |
| `industry` | `string \| null` | No | — |
| `industries` | `string[] \| null` | No | — |
| `categories` | `(b2b \| b2c \| b2g \| e-commerce \| media \| service-provider \| mobile \| saas \| local-business \| string)[] \| null` | No | — |
| `location` | `object \| null` | No | — |
| `socials` | `object \| null` | No | — |
| `updatedAt` | `string` | Yes | — |
| `financial` | `object \| null` | No | — |
| `keywords` | `string[] \| null` | No | — |
| `naicsCodes` | `string[] \| null` | No | — |
| `technologies` | `string[] \| null` | No | — |
| `workforce` | `object \| null` | No | — |

> [accordion] location full type
>
> ```ts theme={null}
> {
>   country?: {
>     code: string,
>     name: string
>   } | null,
>   state?: {
>     id: number,
>     name: string,
>     code?: string | null
>   } | null,
>   city?: {
>     id: number,
>     name: string
>   } | null,
>   address?: string | null,
>   postalCode?: string | null,
>   phone?: string | null
> } | null
> ```

> [accordion] socials full type
>
> ```ts theme={null}
> {
>   linkedinUrl?: string | null,
>   linkedinId?: string | null,
>   twitterUrl?: string | null,
>   facebookUrl?: string | null,
>   instagramUrl?: string | null,
>   angellistUrl?: string | null,
>   crunchbaseUrl?: string | null,
>   youtubeUrl?: string | null,
>   githubUrl?: string | null,
>   g2Url?: string | null
> } | null
> ```

> [accordion] financial full type
>
> ```ts theme={null}
> {
>   stockSymbol?: string | null,
>   stockExchange?: string | null,
>   totalFunding?: number | null,
>   fundingStage?: string | null,
>   fundingDate?: string | null,
>   fundingRounds?: {
>     date?: string | null,
>     amount?: string | null,
>     type?: string | null,
>     url?: string | null,
>     investors?: string | null
>   }[] | null
> } | null
> ```

> [accordion] workforce full type
>
> ```ts theme={null}
> {
>   companyId: string,
>   domain: string,
>   observedEmployeeCount: number,
>   employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>   departmentHeadcount: {
>     cSuite?: number | null,
>     productManagement?: number | null,
>     engineeringTechnical?: number | null,
>     design?: number | null,
>     education?: number | null,
>     finance?: number | null,
>     humanResources?: number | null,
>     informationTechnology?: number | null,
>     legal?: number | null,
>     marketing?: number | null,
>     medicalHealth?: number | null,
>     operations?: number | null,
>     sales?: number | null,
>     consulting?: number | null
>   },
>   unclassifiedHeadcount: number,
>   historyFrom: string,
>   historyTo: string,
>   history?: {
>     date: string,
>     observedEmployeeCount: number,
>     employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>     departmentHeadcount: {
>       cSuite?: number | null,
>       productManagement?: number | null,
>       engineeringTechnical?: number | null,
>       design?: number | null,
>       education?: number | null,
>       finance?: number | null,
>       humanResources?: number | null,
>       informationTechnology?: number | null,
>       legal?: number | null,
>       marketing?: number | null,
>       medicalHealth?: number | null,
>       operations?: number | null,
>       sales?: number | null,
>       consulting?: number | null
>     },
>     unclassifiedHeadcount: number
>   }[] | null,
>   nextCursor?: string | null
> } | null
> ```

***

### search

`companies.search`

Search companies by filters, a semantic query or lookalike seed domains, with cursor pagination. Costs 1 credit per company (2 semantic, 5 lookalike).

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.companies.search({
	pageSize: 10,
	filter: { domain: 'acme.example', type: 'private' },
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `pageSize` | `number` | No | — |
| `cursor` | `string` | No | — |
| `expand` | `(financial \| keywords \| naicsCodes \| technologies \| workforce)[]` | No | — |
| `filter` | `object` | No | — |
| `semantic` | `object` | No | — |
| `lookalike` | `object` | No | — |

> [accordion] filter full type
>
> ```ts theme={null}
> {
>   query?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   id?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   domain?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   keywords?: string | string[] | {
>     in?: string[],
>     notIn?: string[],
>     all?: string[]
>   },
>   technologies?: string | string[] | {
>     in?: string[],
>     notIn?: string[],
>     all?: string[]
>   },
>   region?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   country?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   state?: number | number[] | {
>     in?: number[],
>     notIn?: number[]
>   },
>   city?: number | number[] | {
>     in?: number[],
>     notIn?: number[]
>   },
>   type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[] | {
>     in?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[],
>     notIn?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[]
>   },
>   employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>     in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>     notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>   },
>   reportedEmployees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>     in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>     notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>   },
>   revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[] | {
>     in?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[],
>     notIn?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[]
>   },
>   workforceGrowth?: {
>     period?: m6 | y1 | y2,
>     department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>     min?: number,
>     max?: number
>   },
>   workforceSize?: {
>     department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>     min?: number,
>     max?: number
>   }[],
>   naicsCodes?: string | string[] | {
>     in?: string[],
>     notIn?: string[],
>     all?: string[]
>   },
>   categories?: b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[] | {
>     in?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>     notIn?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>     all?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[]
>   },
>   foundedYear?: {
>     min?: number,
>     max?: number
>   },
>   fundingRounds?: seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other | (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[] | {
>     in?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[],
>     notIn?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[]
>   },
>   fundingAmount?: {
>     min?: number,
>     max?: number
>   },
>   fundingYear?: {
>     min?: number,
>     max?: number
>   },
>   require?: linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding | (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[] | {
>     all: (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[]
>   }
> }
> ```

> [accordion] semantic full type
>
> ```ts theme={null}
> {
>   query: string,
>   weight?: number,
>   autoFilter?: boolean
> }
> ```

> [accordion] lookalike full type
>
> ```ts theme={null}
> {
>   domains: string[],
>   weight?: number,
>   minScore?: number
> }
> ```

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |
| `nextCursor` | `string \| null` | No | — |
| `scores` | `Record<string, number> \| null` | No | — |
| `interpretation` | `object \| null` | No | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   id: string,
>   name?: string | null,
>   legalName?: string | null,
>   domain: string,
>   website: string,
>   logoUrl: string,
>   description?: string | null,
>   type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | string | null,
>   foundedYear?: number | null,
>   employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>   revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | string | null,
>   industry?: string | null,
>   industries?: string[] | null,
>   categories?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | string)[] | null,
>   location?: {
>     country?: {
>       code: string,
>       name: string
>     } | null,
>     state?: {
>       id: number,
>       name: string,
>       code?: string | null
>     } | null,
>     city?: {
>       id: number,
>       name: string
>     } | null,
>     address?: string | null,
>     postalCode?: string | null,
>     phone?: string | null
>   } | null,
>   socials?: {
>     linkedinUrl?: string | null,
>     linkedinId?: string | null,
>     twitterUrl?: string | null,
>     facebookUrl?: string | null,
>     instagramUrl?: string | null,
>     angellistUrl?: string | null,
>     crunchbaseUrl?: string | null,
>     youtubeUrl?: string | null,
>     githubUrl?: string | null,
>     g2Url?: string | null
>   } | null,
>   updatedAt: string,
>   financial?: {
>     stockSymbol?: string | null,
>     stockExchange?: string | null,
>     totalFunding?: number | null,
>     fundingStage?: string | null,
>     fundingDate?: string | null,
>     fundingRounds?: {
>       date?: string | null,
>       amount?: string | null,
>       type?: string | null,
>       url?: string | null,
>       investors?: string | null
>     }[] | null
>   } | null,
>   keywords?: string[] | null,
>   naicsCodes?: string[] | null,
>   technologies?: string[] | null,
>   workforce?: {
>     companyId: string,
>     domain: string,
>     observedEmployeeCount: number,
>     employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>     departmentHeadcount: {
>       cSuite?: number | null,
>       productManagement?: number | null,
>       engineeringTechnical?: number | null,
>       design?: number | null,
>       education?: number | null,
>       finance?: number | null,
>       humanResources?: number | null,
>       informationTechnology?: number | null,
>       legal?: number | null,
>       marketing?: number | null,
>       medicalHealth?: number | null,
>       operations?: number | null,
>       sales?: number | null,
>       consulting?: number | null
>     },
>     unclassifiedHeadcount: number,
>     historyFrom: string,
>     historyTo: string,
>     history?: {
>       date: string,
>       observedEmployeeCount: number,
>       employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>       departmentHeadcount: {
>         cSuite?: number | null,
>         productManagement?: number | null,
>         engineeringTechnical?: number | null,
>         design?: number | null,
>         education?: number | null,
>         finance?: number | null,
>         humanResources?: number | null,
>         informationTechnology?: number | null,
>         legal?: number | null,
>         marketing?: number | null,
>         medicalHealth?: number | null,
>         operations?: number | null,
>         sales?: number | null,
>         consulting?: number | null
>       },
>       unclassifiedHeadcount: number
>     }[] | null,
>     nextCursor?: string | null
>   } | null
> }[]
> ```

> [accordion] interpretation full type
>
> ```ts theme={null}
> {
>   filter?: {
>     query?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     id?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     domain?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     keywords?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     } | null,
>     technologies?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     } | null,
>     region?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     country?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     state?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     } | null,
>     city?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     } | null,
>     type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[] | {
>       in?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[],
>       notIn?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[]
>     } | null,
>     employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     } | null,
>     reportedEmployees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     } | null,
>     revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[] | {
>       in?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[],
>       notIn?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[]
>     } | null,
>     workforceGrowth?: {
>       period?: m6 | y1 | y2 | null,
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting | null,
>       min?: number | null,
>       max?: number | null
>     } | null,
>     workforceSize?: {
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting | null,
>       min?: number | null,
>       max?: number | null
>     }[] | null,
>     naicsCodes?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     } | null,
>     categories?: b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[] | {
>       in?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       notIn?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       all?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[]
>     } | null,
>     foundedYear?: {
>       min?: number | null,
>       max?: number | null
>     } | null,
>     fundingRounds?: seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other | (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[] | {
>       in?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[],
>       notIn?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[]
>     } | null,
>     fundingAmount?: {
>       min?: number | null,
>       max?: number | null
>     } | null,
>     fundingYear?: {
>       min?: number | null,
>       max?: number | null
>     } | null,
>     require?: linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding | (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[] | {
>       all: (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[]
>     } | null
>   } | null,
>   boost?: {
>     names?: string[] | null,
>     categories?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | string)[] | null,
>     revenue?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | string)[] | null
>   } | null
> } | null
> ```

***

### searchCount

`companies.searchCount`

Count companies matching the same filters, semantic query or lookalike seeds as search. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.companies.searchCount({
	filter: { type: 'private', country: 'US' },
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `filter` | `object` | No | — |
| `semantic` | `object` | No | — |
| `lookalike` | `object` | No | — |

> [accordion] filter full type
>
> ```ts theme={null}
> {
>   query?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   id?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   domain?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   keywords?: string | string[] | {
>     in?: string[],
>     notIn?: string[],
>     all?: string[]
>   },
>   technologies?: string | string[] | {
>     in?: string[],
>     notIn?: string[],
>     all?: string[]
>   },
>   region?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   country?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   state?: number | number[] | {
>     in?: number[],
>     notIn?: number[]
>   },
>   city?: number | number[] | {
>     in?: number[],
>     notIn?: number[]
>   },
>   type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[] | {
>     in?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[],
>     notIn?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[]
>   },
>   employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>     in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>     notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>   },
>   reportedEmployees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>     in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>     notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>   },
>   revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[] | {
>     in?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[],
>     notIn?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[]
>   },
>   workforceGrowth?: {
>     period?: m6 | y1 | y2,
>     department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>     min?: number,
>     max?: number
>   },
>   workforceSize?: {
>     department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>     min?: number,
>     max?: number
>   }[],
>   naicsCodes?: string | string[] | {
>     in?: string[],
>     notIn?: string[],
>     all?: string[]
>   },
>   categories?: b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[] | {
>     in?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>     notIn?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>     all?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[]
>   },
>   foundedYear?: {
>     min?: number,
>     max?: number
>   },
>   fundingRounds?: seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other | (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[] | {
>     in?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[],
>     notIn?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[]
>   },
>   fundingAmount?: {
>     min?: number,
>     max?: number
>   },
>   fundingYear?: {
>     min?: number,
>     max?: number
>   },
>   require?: linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding | (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[] | {
>     all: (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[]
>   }
> }
> ```

> [accordion] semantic full type
>
> ```ts theme={null}
> {
>   query: string,
>   weight?: number,
>   autoFilter?: boolean
> }
> ```

> [accordion] lookalike full type
>
> ```ts theme={null}
> {
>   domains: string[],
>   weight?: number,
>   minScore?: number
> }
> ```

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `count` | `number` | Yes | — |
| `total` | `number` | Yes | — |
| `interpretation` | `object \| null` | No | — |

> [accordion] interpretation full type
>
> ```ts theme={null}
> {
>   filter?: {
>     query?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     id?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     domain?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     keywords?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     } | null,
>     technologies?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     } | null,
>     region?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     country?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     state?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     } | null,
>     city?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     } | null,
>     type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[] | {
>       in?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[],
>       notIn?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[]
>     } | null,
>     employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     } | null,
>     reportedEmployees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     } | null,
>     revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[] | {
>       in?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[],
>       notIn?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[]
>     } | null,
>     workforceGrowth?: {
>       period?: m6 | y1 | y2 | null,
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting | null,
>       min?: number | null,
>       max?: number | null
>     } | null,
>     workforceSize?: {
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting | null,
>       min?: number | null,
>       max?: number | null
>     }[] | null,
>     naicsCodes?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     } | null,
>     categories?: b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[] | {
>       in?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       notIn?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       all?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[]
>     } | null,
>     foundedYear?: {
>       min?: number | null,
>       max?: number | null
>     } | null,
>     fundingRounds?: seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other | (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[] | {
>       in?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[],
>       notIn?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[]
>     } | null,
>     fundingAmount?: {
>       min?: number | null,
>       max?: number | null
>     } | null,
>     fundingYear?: {
>       min?: number | null,
>       max?: number | null
>     } | null,
>     require?: linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding | (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[] | {
>       all: (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[]
>     } | null
>   } | null,
>   boost?: {
>     names?: string[] | null,
>     categories?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | string)[] | null,
>     revenue?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | string)[] | null
>   } | null
> } | null
> ```

***

### searchPreview

`companies.searchPreview`

Preview up to 25 matching companies with the search ranking. Free, needs a plan with previews.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.companies.searchPreview({
	lookalike: {
		domains: ['acme.example'],
		minScore: 0.8,
	},
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `filter` | `object` | No | — |
| `semantic` | `object` | No | — |
| `lookalike` | `object` | No | — |

> [accordion] filter full type
>
> ```ts theme={null}
> {
>   query?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   id?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   domain?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   keywords?: string | string[] | {
>     in?: string[],
>     notIn?: string[],
>     all?: string[]
>   },
>   technologies?: string | string[] | {
>     in?: string[],
>     notIn?: string[],
>     all?: string[]
>   },
>   region?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   country?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   state?: number | number[] | {
>     in?: number[],
>     notIn?: number[]
>   },
>   city?: number | number[] | {
>     in?: number[],
>     notIn?: number[]
>   },
>   type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[] | {
>     in?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[],
>     notIn?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[]
>   },
>   employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>     in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>     notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>   },
>   reportedEmployees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>     in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>     notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>   },
>   revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[] | {
>     in?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[],
>     notIn?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[]
>   },
>   workforceGrowth?: {
>     period?: m6 | y1 | y2,
>     department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>     min?: number,
>     max?: number
>   },
>   workforceSize?: {
>     department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>     min?: number,
>     max?: number
>   }[],
>   naicsCodes?: string | string[] | {
>     in?: string[],
>     notIn?: string[],
>     all?: string[]
>   },
>   categories?: b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[] | {
>     in?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>     notIn?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>     all?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[]
>   },
>   foundedYear?: {
>     min?: number,
>     max?: number
>   },
>   fundingRounds?: seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other | (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[] | {
>     in?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[],
>     notIn?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[]
>   },
>   fundingAmount?: {
>     min?: number,
>     max?: number
>   },
>   fundingYear?: {
>     min?: number,
>     max?: number
>   },
>   require?: linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding | (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[] | {
>     all: (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[]
>   }
> }
> ```

> [accordion] semantic full type
>
> ```ts theme={null}
> {
>   query: string,
>   weight?: number,
>   autoFilter?: boolean
> }
> ```

> [accordion] lookalike full type
>
> ```ts theme={null}
> {
>   domains: string[],
>   weight?: number,
>   minScore?: number
> }
> ```

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |
| `total` | `number` | Yes | — |
| `scores` | `Record<string, number> \| null` | No | — |
| `interpretation` | `object \| null` | No | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   id: string,
>   name?: string | null,
>   logoUrl: string,
>   industry?: string | null,
>   updatedAt: string
> }[]
> ```

> [accordion] interpretation full type
>
> ```ts theme={null}
> {
>   filter?: {
>     query?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     id?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     domain?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     keywords?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     } | null,
>     technologies?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     } | null,
>     region?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     country?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     } | null,
>     state?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     } | null,
>     city?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     } | null,
>     type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[] | {
>       in?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[],
>       notIn?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[]
>     } | null,
>     employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     } | null,
>     reportedEmployees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     } | null,
>     revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[] | {
>       in?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[],
>       notIn?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[]
>     } | null,
>     workforceGrowth?: {
>       period?: m6 | y1 | y2 | null,
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting | null,
>       min?: number | null,
>       max?: number | null
>     } | null,
>     workforceSize?: {
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting | null,
>       min?: number | null,
>       max?: number | null
>     }[] | null,
>     naicsCodes?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     } | null,
>     categories?: b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[] | {
>       in?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       notIn?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       all?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[]
>     } | null,
>     foundedYear?: {
>       min?: number | null,
>       max?: number | null
>     } | null,
>     fundingRounds?: seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other | (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[] | {
>       in?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[],
>       notIn?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[]
>     } | null,
>     fundingAmount?: {
>       min?: number | null,
>       max?: number | null
>     } | null,
>     fundingYear?: {
>       min?: number | null,
>       max?: number | null
>     } | null,
>     require?: linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding | (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[] | {
>       all: (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[]
>     } | null
>   } | null,
>   boost?: {
>     names?: string[] | null,
>     categories?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | string)[] | null,
>     revenue?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | string)[] | null
>   } | null
> } | null
> ```

***

### workforce

`companies.workforce`

Get observed headcount and department breakdowns for one company by ID or domain, 12 months of history per page. Costs 1 credit per page.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.companies.workforce({ id: '00000000-0000-4000-8000-000000000001' });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `id` | `string` | No | — |
| `domain` | `string` | No | — |
| `cursor` | `string` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `companyId` | `string` | Yes | — |
| `domain` | `string` | Yes | — |
| `observedEmployeeCount` | `number` | Yes | — |
| `employeeCountRange` | `1-10 \| 11-50 \| 51-200 \| 201-500 \| 501-1K \| 1K-5K \| 5K-10K \| over-10K \| string \| null` | No | — |
| `departmentHeadcount` | `object` | Yes | — |
| `unclassifiedHeadcount` | `number` | Yes | — |
| `historyFrom` | `string` | Yes | — |
| `historyTo` | `string` | Yes | — |
| `history` | `object[] \| null` | No | — |
| `nextCursor` | `string \| null` | No | — |

> [accordion] departmentHeadcount full type
>
> ```ts theme={null}
> {
>   cSuite?: number | null,
>   productManagement?: number | null,
>   engineeringTechnical?: number | null,
>   design?: number | null,
>   education?: number | null,
>   finance?: number | null,
>   humanResources?: number | null,
>   informationTechnology?: number | null,
>   legal?: number | null,
>   marketing?: number | null,
>   medicalHealth?: number | null,
>   operations?: number | null,
>   sales?: number | null,
>   consulting?: number | null
> }
> ```

> [accordion] history full type
>
> ```ts theme={null}
> {
>   date: string,
>   observedEmployeeCount: number,
>   employeeCountRange?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | string | null,
>   departmentHeadcount: {
>     cSuite?: number | null,
>     productManagement?: number | null,
>     engineeringTechnical?: number | null,
>     design?: number | null,
>     education?: number | null,
>     finance?: number | null,
>     humanResources?: number | null,
>     informationTechnology?: number | null,
>     legal?: number | null,
>     marketing?: number | null,
>     medicalHealth?: number | null,
>     operations?: number | null,
>     sales?: number | null,
>     consulting?: number | null
>   },
>   unclassifiedHeadcount: number
> }[] | null
> ```

***

## Geo

### getCountry

`geo.getCountry`

Get one country by its two-letter ISO code. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.geo.getCountry({ countryCode: 'US' });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `countryCode` | `string` | Yes | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `code` | `string` | Yes | — |
| `name` | `string` | Yes | — |
| `latitude` | `number \| null` | No | — |
| `longitude` | `number \| null` | No | — |

***

### regions

`geo.regions`

List geographic regions and the country codes they cover. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.geo.regions({});
```

**Input:** *empty object*

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   id: string,
>   name: string,
>   parentId?: string | null,
>   countryCodes: string[]
> }[]
> ```

***

### searchCities

`geo.searchCities`

Search cities by name substring, state or country, with cursor pagination. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.geo.searchCities({
	stateIds: [1],
	countryCodes: ['US'],
	query: 'San Francisco',
	pageSize: 10,
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `stateIds` | `number[]` | No | — |
| `countryCodes` | `string[]` | No | — |
| `query` | `string` | No | — |
| `pageSize` | `number` | No | — |
| `cursor` | `string` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |
| `nextCursor` | `string \| null` | No | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   id: number,
>   name: string,
>   countryCode?: string | null,
>   stateId?: number | null,
>   latitude?: number | null,
>   longitude?: number | null
> }[]
> ```

***

### searchCountries

`geo.searchCountries`

Search countries by a literal name substring, with cursor pagination. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.geo.searchCountries({ query: 'United', pageSize: 10 });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `query` | `string` | No | — |
| `pageSize` | `number` | No | — |
| `cursor` | `string` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |
| `nextCursor` | `string \| null` | No | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   code: string,
>   name: string,
>   latitude?: number | null,
>   longitude?: number | null
> }[]
> ```

***

### searchStates

`geo.searchStates`

Search states or provinces by name substring, optionally by country, with cursor pagination. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.geo.searchStates({
	countryCodes: ['US'],
	query: 'California',
	pageSize: 10,
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `countryCodes` | `string[]` | No | — |
| `query` | `string` | No | — |
| `pageSize` | `number` | No | — |
| `cursor` | `string` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |
| `nextCursor` | `string \| null` | No | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   id: number,
>   name: string,
>   code?: string | null,
>   countryCode?: string | null,
>   latitude?: number | null,
>   longitude?: number | null
> }[]
> ```

***

## Industries

### list

`industries.list`

List industries with the NAICS code prefixes accepted by company search. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.industries.list({});
```

**Input:** *empty object*

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   name: string,
>   naicsCodes: string[]
> }[]
> ```

***

## Keywords

### autocomplete

`keywords.autocomplete`

Suggest up to 10 keywords by popularity, for company search keyword filters. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.keywords.autocomplete({ query: 'workflow automation' });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `query` | `string` | Yes | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `string[]` | Yes | — |

***

## People

### enrich

`people.enrich`

Enrich a person from their email address. Costs 5 credits when a person is returned.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.people.enrich({
	email: 'alex.morgan@acme.example',
	expand: ['education'],
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `email` | `string` | Yes | — |
| `expand` | `(education \| company)[]` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `id` | `number` | Yes | — |
| `name` | `string \| null` | No | — |
| `firstName` | `string \| null` | No | — |
| `lastName` | `string \| null` | No | — |
| `imageUrl` | `string \| null` | No | — |
| `position` | `string \| null` | No | — |
| `seniority` | `owner \| founder \| c-suite \| partner \| vp \| head \| director \| manager \| senior \| entry \| intern \| string \| null` | No | — |
| `department` | `c-suite \| c-suite/executive \| c-suite/finance-executive \| c-suite/founder \| c-suite/human-resources-executive \| c-suite/information-technology-executive \| c-suite/legal-executive \| c-suite/marketing-executive \| c-suite/medical-health-executive \| c-suite/operations-executive \| c-suite/sales-executive \| product-management \| product-management/product-development \| product-management/product-management \| engineering-technical \| engineering-technical/artificial-intelligence-machine-learning \| engineering-technical/bioengineering \| engineering-technical/biometrics \| engineering-technical/business-intelligence \| engineering-technical/chemical-engineering \| engineering-technical/cloud-mobility \| engineering-technical/data-science \| engineering-technical/devops \| engineering-technical/digital-transformation \| engineering-technical/emerging-technology-innovation \| engineering-technical/engineering-technical \| engineering-technical/industrial-engineering \| engineering-technical/mechanic \| engineering-technical/mobile-development \| engineering-technical/project-management \| engineering-technical/research-development \| engineering-technical/scrum-master-agile-coach \| engineering-technical/software-development \| engineering-technical/support-technical-services \| engineering-technical/technician \| engineering-technical/technology-operations \| engineering-technical/test-quality-assurance \| engineering-technical/ui-ux \| engineering-technical/web-development \| design \| design/all-design \| design/product-ui-ux-design \| design/graphic-design \| education \| education/teacher \| education/principal \| education/superintendent \| education/professor \| finance \| finance/accounting \| finance/finance \| finance/financial-planning-analysis \| finance/financial-reporting \| finance/financial-strategy \| finance/financial-systems \| finance/internal-audit-control \| finance/investor-relations \| finance/mergers-acquisitions \| finance/real-estate-finance \| finance/financial-risk \| finance/shared-services \| finance/sourcing-procurement \| finance/tax \| finance/treasury \| human-resources \| human-resources/compensation-benefits \| human-resources/culture-diversity-inclusion \| human-resources/employee-labor-relations \| human-resources/health-safety \| human-resources/human-resource-information-system \| human-resources/human-resources \| human-resources/hr-business-partner \| human-resources/learning-development \| human-resources/organizational-development \| human-resources/recruiting-talent-acquisition \| human-resources/talent-management \| human-resources/workforce-management \| human-resources/people-operations \| information-technology \| information-technology/application-development \| information-technology/business-service-management-itsm \| information-technology/collaboration-web-app \| information-technology/data-center \| information-technology/data-warehouse \| information-technology/database-administration \| information-technology/ecommerce-development \| information-technology/enterprise-architecture \| information-technology/help-desk-desktop-services \| information-technology/hr-financial-erp-systems \| information-technology/information-security \| information-technology/information-technology \| information-technology/infrastructure \| information-technology/it-asset-management \| information-technology/it-audit-it-compliance \| information-technology/it-operations \| information-technology/it-procurement \| information-technology/it-strategy \| information-technology/it-training \| information-technology/networking \| information-technology/project-program-management \| information-technology/quality-assurance \| information-technology/retail-store-systems \| information-technology/servers \| information-technology/storage-disaster-recovery \| information-technology/telecommunications \| information-technology/virtualization \| legal \| legal/acquisitions \| legal/compliance \| legal/contracts \| legal/corporate-secretary \| legal/ediscovery \| legal/ethics \| legal/governance \| legal/governmental-affairs-regulatory-law \| legal/intellectual-property-patent \| legal/labor-employment \| legal/lawyer-attorney \| legal/legal \| legal/legal-counsel \| legal/legal-operations \| legal/litigation \| legal/privacy \| marketing \| marketing/advertising \| marketing/brand-management \| marketing/content-marketing \| marketing/customer-experience \| marketing/customer-marketing \| marketing/demand-generation \| marketing/digital-marketing \| marketing/ecommerce-marketing \| marketing/event-marketing \| marketing/field-marketing \| marketing/lead-generation \| marketing/marketing \| marketing/marketing-analytics-insights \| marketing/marketing-communications \| marketing/marketing-operations \| marketing/product-marketing \| marketing/public-relations \| marketing/search-engine-optimization-pay-per-click \| marketing/social-media-marketing \| marketing/strategic-communications \| marketing/technical-marketing \| medical-health \| medical-health/anesthesiology \| medical-health/chiropractics \| medical-health/clinical-systems \| medical-health/dentistry \| medical-health/dermatology \| medical-health/doctors-physicians \| medical-health/epidemiology \| medical-health/first-responder \| medical-health/infectious-disease \| medical-health/medical-administration \| medical-health/medical-education-training \| medical-health/medical-research \| medical-health/medicine \| medical-health/neurology \| medical-health/nursing \| medical-health/nutrition-dietetics \| medical-health/obstetrics-gynecology \| medical-health/oncology \| medical-health/opthalmology \| medical-health/optometry \| medical-health/orthopedics \| medical-health/pathology \| medical-health/pediatrics \| medical-health/pharmacy \| medical-health/physical-therapy \| medical-health/psychiatry \| medical-health/psychology \| medical-health/public-health \| medical-health/radiology \| medical-health/social-work \| operations \| operations/call-center \| operations/construction \| operations/corporate-strategy \| operations/customer-service-support \| operations/enterprise-resource-planning \| operations/facilities-management \| operations/leasing \| operations/logistics \| operations/office-operations \| operations/operations \| operations/physical-security \| operations/project-development \| operations/quality-management \| operations/real-estate \| operations/safety \| operations/store-operations \| operations/supply-chain \| sales \| sales/account-management \| sales/business-development \| sales/channel-sales \| sales/customer-retention-development \| sales/customer-success \| sales/field-outside-sales \| sales/inside-sales \| sales/partnerships \| sales/revenue-operations \| sales/sales \| sales/sales-enablement \| sales/sales-engineering \| sales/sales-operations \| sales/sales-training \| consulting \| consulting/consultant \| string \| null` | No | — |
| `location` | `object \| null` | No | — |
| `socials` | `object` | Yes | — |
| `experiences` | `object[]` | Yes | — |
| `updatedAt` | `string \| null` | No | — |
| `education` | `object[] \| null` | No | — |

> [accordion] location full type
>
> ```ts theme={null}
> {
>   country?: {
>     code: string,
>     name: string
>   } | null,
>   address?: string | null
> } | null
> ```

> [accordion] socials full type
>
> ```ts theme={null}
> {
>   linkedinUrl?: string | null
> }
> ```

> [accordion] experiences full type
>
> ```ts theme={null}
> {
>   startDate?: string | null,
>   endDate?: string | null,
>   isCurrent: boolean,
>   isMatched: boolean,
>   position?: string | null,
>   seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | string | null,
>   department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | string | null,
>   company?: {
>     id: string,
>     name?: string | null,
>     domain?: string | null,
>     logoUrl?: string | null,
>     industry?: string | null
>   } | null,
>   companyName?: string | null
> }[]
> ```

> [accordion] education full type
>
> ```ts theme={null}
> {
>   institutionName: string,
>   institution?: {
>     id: string,
>     name?: string | null,
>     domain?: string | null,
>     logoUrl?: string | null,
>     industry?: string | null
>   } | null,
>   socialHandle?: string | null,
>   degree?: string[] | null,
>   startYear?: number | null,
>   endYear?: number | null
> }[] | null
> ```

***

### findEmail

`people.findEmail`

Find the work email of a person on a company domain (BETA). Costs 10 credits for a previously unseen email.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.people.findEmail({ personId: 101, domain: 'acme.example' });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `personId` | `number` | Yes | — |
| `domain` | `string` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `personId` | `number` | Yes | — |
| `domain` | `string` | Yes | — |
| `status` | `found \| not-found \| unavailable \| pending \| string` | Yes | — |
| `email` | `string \| null` | No | — |
| `certainty` | `unknown \| medium \| high \| very-high \| string \| null` | No | — |

***

### get

`people.get`

Get a stored person by their CompanyEnrich ID. Costs 2 credits, plus 1 for the education expansion and 1 per unique company for the company expansion.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.people.get({
	personId: 101,
	expand: ['education'],
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `personId` | `number` | Yes | — |
| `expand` | `(education \| company)[]` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `id` | `number` | Yes | — |
| `name` | `string \| null` | No | — |
| `firstName` | `string \| null` | No | — |
| `lastName` | `string \| null` | No | — |
| `imageUrl` | `string \| null` | No | — |
| `position` | `string \| null` | No | — |
| `seniority` | `owner \| founder \| c-suite \| partner \| vp \| head \| director \| manager \| senior \| entry \| intern \| string \| null` | No | — |
| `department` | `c-suite \| c-suite/executive \| c-suite/finance-executive \| c-suite/founder \| c-suite/human-resources-executive \| c-suite/information-technology-executive \| c-suite/legal-executive \| c-suite/marketing-executive \| c-suite/medical-health-executive \| c-suite/operations-executive \| c-suite/sales-executive \| product-management \| product-management/product-development \| product-management/product-management \| engineering-technical \| engineering-technical/artificial-intelligence-machine-learning \| engineering-technical/bioengineering \| engineering-technical/biometrics \| engineering-technical/business-intelligence \| engineering-technical/chemical-engineering \| engineering-technical/cloud-mobility \| engineering-technical/data-science \| engineering-technical/devops \| engineering-technical/digital-transformation \| engineering-technical/emerging-technology-innovation \| engineering-technical/engineering-technical \| engineering-technical/industrial-engineering \| engineering-technical/mechanic \| engineering-technical/mobile-development \| engineering-technical/project-management \| engineering-technical/research-development \| engineering-technical/scrum-master-agile-coach \| engineering-technical/software-development \| engineering-technical/support-technical-services \| engineering-technical/technician \| engineering-technical/technology-operations \| engineering-technical/test-quality-assurance \| engineering-technical/ui-ux \| engineering-technical/web-development \| design \| design/all-design \| design/product-ui-ux-design \| design/graphic-design \| education \| education/teacher \| education/principal \| education/superintendent \| education/professor \| finance \| finance/accounting \| finance/finance \| finance/financial-planning-analysis \| finance/financial-reporting \| finance/financial-strategy \| finance/financial-systems \| finance/internal-audit-control \| finance/investor-relations \| finance/mergers-acquisitions \| finance/real-estate-finance \| finance/financial-risk \| finance/shared-services \| finance/sourcing-procurement \| finance/tax \| finance/treasury \| human-resources \| human-resources/compensation-benefits \| human-resources/culture-diversity-inclusion \| human-resources/employee-labor-relations \| human-resources/health-safety \| human-resources/human-resource-information-system \| human-resources/human-resources \| human-resources/hr-business-partner \| human-resources/learning-development \| human-resources/organizational-development \| human-resources/recruiting-talent-acquisition \| human-resources/talent-management \| human-resources/workforce-management \| human-resources/people-operations \| information-technology \| information-technology/application-development \| information-technology/business-service-management-itsm \| information-technology/collaboration-web-app \| information-technology/data-center \| information-technology/data-warehouse \| information-technology/database-administration \| information-technology/ecommerce-development \| information-technology/enterprise-architecture \| information-technology/help-desk-desktop-services \| information-technology/hr-financial-erp-systems \| information-technology/information-security \| information-technology/information-technology \| information-technology/infrastructure \| information-technology/it-asset-management \| information-technology/it-audit-it-compliance \| information-technology/it-operations \| information-technology/it-procurement \| information-technology/it-strategy \| information-technology/it-training \| information-technology/networking \| information-technology/project-program-management \| information-technology/quality-assurance \| information-technology/retail-store-systems \| information-technology/servers \| information-technology/storage-disaster-recovery \| information-technology/telecommunications \| information-technology/virtualization \| legal \| legal/acquisitions \| legal/compliance \| legal/contracts \| legal/corporate-secretary \| legal/ediscovery \| legal/ethics \| legal/governance \| legal/governmental-affairs-regulatory-law \| legal/intellectual-property-patent \| legal/labor-employment \| legal/lawyer-attorney \| legal/legal \| legal/legal-counsel \| legal/legal-operations \| legal/litigation \| legal/privacy \| marketing \| marketing/advertising \| marketing/brand-management \| marketing/content-marketing \| marketing/customer-experience \| marketing/customer-marketing \| marketing/demand-generation \| marketing/digital-marketing \| marketing/ecommerce-marketing \| marketing/event-marketing \| marketing/field-marketing \| marketing/lead-generation \| marketing/marketing \| marketing/marketing-analytics-insights \| marketing/marketing-communications \| marketing/marketing-operations \| marketing/product-marketing \| marketing/public-relations \| marketing/search-engine-optimization-pay-per-click \| marketing/social-media-marketing \| marketing/strategic-communications \| marketing/technical-marketing \| medical-health \| medical-health/anesthesiology \| medical-health/chiropractics \| medical-health/clinical-systems \| medical-health/dentistry \| medical-health/dermatology \| medical-health/doctors-physicians \| medical-health/epidemiology \| medical-health/first-responder \| medical-health/infectious-disease \| medical-health/medical-administration \| medical-health/medical-education-training \| medical-health/medical-research \| medical-health/medicine \| medical-health/neurology \| medical-health/nursing \| medical-health/nutrition-dietetics \| medical-health/obstetrics-gynecology \| medical-health/oncology \| medical-health/opthalmology \| medical-health/optometry \| medical-health/orthopedics \| medical-health/pathology \| medical-health/pediatrics \| medical-health/pharmacy \| medical-health/physical-therapy \| medical-health/psychiatry \| medical-health/psychology \| medical-health/public-health \| medical-health/radiology \| medical-health/social-work \| operations \| operations/call-center \| operations/construction \| operations/corporate-strategy \| operations/customer-service-support \| operations/enterprise-resource-planning \| operations/facilities-management \| operations/leasing \| operations/logistics \| operations/office-operations \| operations/operations \| operations/physical-security \| operations/project-development \| operations/quality-management \| operations/real-estate \| operations/safety \| operations/store-operations \| operations/supply-chain \| sales \| sales/account-management \| sales/business-development \| sales/channel-sales \| sales/customer-retention-development \| sales/customer-success \| sales/field-outside-sales \| sales/inside-sales \| sales/partnerships \| sales/revenue-operations \| sales/sales \| sales/sales-enablement \| sales/sales-engineering \| sales/sales-operations \| sales/sales-training \| consulting \| consulting/consultant \| string \| null` | No | — |
| `location` | `object \| null` | No | — |
| `socials` | `object` | Yes | — |
| `experiences` | `object[]` | Yes | — |
| `updatedAt` | `string \| null` | No | — |
| `education` | `object[] \| null` | No | — |

> [accordion] location full type
>
> ```ts theme={null}
> {
>   country?: {
>     code: string,
>     name: string
>   } | null,
>   address?: string | null
> } | null
> ```

> [accordion] socials full type
>
> ```ts theme={null}
> {
>   linkedinUrl?: string | null
> }
> ```

> [accordion] experiences full type
>
> ```ts theme={null}
> {
>   startDate?: string | null,
>   endDate?: string | null,
>   isCurrent: boolean,
>   isMatched: boolean,
>   position?: string | null,
>   seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | string | null,
>   department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | string | null,
>   company?: {
>     id: string,
>     name?: string | null,
>     domain?: string | null,
>     logoUrl?: string | null,
>     industry?: string | null
>   } | null,
>   companyName?: string | null
> }[]
> ```

> [accordion] education full type
>
> ```ts theme={null}
> {
>   institutionName: string,
>   institution?: {
>     id: string,
>     name?: string | null,
>     domain?: string | null,
>     logoUrl?: string | null,
>     industry?: string | null
>   } | null,
>   socialHandle?: string | null,
>   degree?: string[] | null,
>   startYear?: number | null,
>   endYear?: number | null
> }[] | null
> ```

***

### search

`people.search`

Search people by person filters, a natural-language query and an optional company query, with cursor pagination. Costs 2 credits per person.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.people.search({
	pageSize: 10,
	filter: { domain: 'acme.example', position: 'Engineer' },
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `pageSize` | `number` | No | — |
| `cursor` | `string` | No | — |
| `expand` | `(education \| company)[]` | No | — |
| `filter` | `object` | No | — |
| `semantic` | `object` | No | — |
| `company` | `object` | No | — |

> [accordion] filter full type
>
> ```ts theme={null}
> {
>   query?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   companyId?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   domain?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   companyLinkedinHandle?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[] | {
>     in?: (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[],
>     notIn?: (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[]
>   },
>   department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[] | {
>     in?: (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[],
>     notIn?: (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[]
>   },
>   country?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   position?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   currentCompanyStartDate?: {
>     after?: string,
>     before?: string
>   },
>   currentPositionStartDate?: {
>     after?: string,
>     before?: string
>   },
>   education?: {
>     institutionLinkedinHandle?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     institutionName?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     }
>   },
>   pastExperience?: {
>     companyId?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     domain?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     companyLinkedinHandle?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[] | {
>       in: (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[]
>     },
>     department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[] | {
>       in: (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[]
>     },
>     position?: string | string[] | {
>       in: string[]
>     },
>     startDate?: {
>       after?: string,
>       before?: string
>     },
>     endDate?: {
>       after?: string,
>       before?: string
>     }
>   }
> }
> ```

> [accordion] semantic full type
>
> ```ts theme={null}
> {
>   query: string
> }
> ```

> [accordion] company full type
>
> ```ts theme={null}
> {
>   filter?: {
>     query?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     id?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     domain?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     keywords?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     },
>     technologies?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     },
>     region?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     country?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     state?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     },
>     city?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     },
>     type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[] | {
>       in?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[],
>       notIn?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[]
>     },
>     employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     },
>     reportedEmployees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     },
>     revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[] | {
>       in?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[],
>       notIn?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[]
>     },
>     workforceGrowth?: {
>       period?: m6 | y1 | y2,
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>       min?: number,
>       max?: number
>     },
>     workforceSize?: {
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>       min?: number,
>       max?: number
>     }[],
>     naicsCodes?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     },
>     categories?: b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[] | {
>       in?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       notIn?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       all?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[]
>     },
>     foundedYear?: {
>       min?: number,
>       max?: number
>     },
>     fundingRounds?: seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other | (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[] | {
>       in?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[],
>       notIn?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[]
>     },
>     fundingAmount?: {
>       min?: number,
>       max?: number
>     },
>     fundingYear?: {
>       min?: number,
>       max?: number
>     },
>     require?: linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding | (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[] | {
>       all: (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[]
>     }
>   },
>   semantic?: {
>     query: string,
>     weight?: number,
>     autoFilter?: boolean
>   },
>   lookalike?: {
>     domains: string[],
>     weight?: number,
>     minScore?: number
>   }
> }
> ```

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |
| `nextCursor` | `string \| null` | No | — |
| `interpretation` | `object \| null` | No | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   id: number,
>   name?: string | null,
>   firstName?: string | null,
>   lastName?: string | null,
>   imageUrl?: string | null,
>   position?: string | null,
>   seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | string | null,
>   department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | string | null,
>   location?: {
>     country?: {
>       code: string,
>       name: string
>     } | null,
>     address?: string | null
>   } | null,
>   socials: {
>     linkedinUrl?: string | null
>   },
>   experiences: {
>     startDate?: string | null,
>     endDate?: string | null,
>     isCurrent: boolean,
>     isMatched: boolean,
>     position?: string | null,
>     seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | string | null,
>     department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | string | null,
>     company?: {
>       id: string,
>       name?: string | null,
>       domain?: string | null,
>       logoUrl?: string | null,
>       industry?: string | null
>     } | null,
>     companyName?: string | null
>   }[],
>   updatedAt?: string | null,
>   education?: {
>     institutionName: string,
>     institution?: {
>       id: string,
>       name?: string | null,
>       domain?: string | null,
>       logoUrl?: string | null,
>       industry?: string | null
>     } | null,
>     socialHandle?: string | null,
>     degree?: string[] | null,
>     startYear?: number | null,
>     endYear?: number | null
>   }[] | null
> }[]
> ```

> [accordion] interpretation full type
>
> ```ts theme={null}
> {
>   companyNames?: string[] | null,
>   filter?: Record<string, any> | null,
>   company?: {
>     query: string,
>     filter?: Record<string, any> | null,
>     boost?: Record<string, any> | null
>   } | null
> } | null
> ```

***

### searchCount

`people.searchCount`

Count people matching the same person filters, natural-language query and company query as search. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.people.searchCount({
	filter: { country: 'US', domain: 'acme.example' },
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `filter` | `object` | No | — |
| `semantic` | `object` | No | — |
| `company` | `object` | No | — |

> [accordion] filter full type
>
> ```ts theme={null}
> {
>   query?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   companyId?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   domain?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   companyLinkedinHandle?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[] | {
>     in?: (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[],
>     notIn?: (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[]
>   },
>   department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[] | {
>     in?: (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[],
>     notIn?: (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[]
>   },
>   country?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   position?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   currentCompanyStartDate?: {
>     after?: string,
>     before?: string
>   },
>   currentPositionStartDate?: {
>     after?: string,
>     before?: string
>   },
>   education?: {
>     institutionLinkedinHandle?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     institutionName?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     }
>   },
>   pastExperience?: {
>     companyId?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     domain?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     companyLinkedinHandle?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[] | {
>       in: (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[]
>     },
>     department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[] | {
>       in: (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[]
>     },
>     position?: string | string[] | {
>       in: string[]
>     },
>     startDate?: {
>       after?: string,
>       before?: string
>     },
>     endDate?: {
>       after?: string,
>       before?: string
>     }
>   }
> }
> ```

> [accordion] semantic full type
>
> ```ts theme={null}
> {
>   query: string
> }
> ```

> [accordion] company full type
>
> ```ts theme={null}
> {
>   filter?: {
>     query?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     id?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     domain?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     keywords?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     },
>     technologies?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     },
>     region?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     country?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     state?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     },
>     city?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     },
>     type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[] | {
>       in?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[],
>       notIn?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[]
>     },
>     employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     },
>     reportedEmployees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     },
>     revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[] | {
>       in?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[],
>       notIn?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[]
>     },
>     workforceGrowth?: {
>       period?: m6 | y1 | y2,
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>       min?: number,
>       max?: number
>     },
>     workforceSize?: {
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>       min?: number,
>       max?: number
>     }[],
>     naicsCodes?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     },
>     categories?: b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[] | {
>       in?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       notIn?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       all?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[]
>     },
>     foundedYear?: {
>       min?: number,
>       max?: number
>     },
>     fundingRounds?: seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other | (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[] | {
>       in?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[],
>       notIn?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[]
>     },
>     fundingAmount?: {
>       min?: number,
>       max?: number
>     },
>     fundingYear?: {
>       min?: number,
>       max?: number
>     },
>     require?: linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding | (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[] | {
>       all: (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[]
>     }
>   },
>   semantic?: {
>     query: string,
>     weight?: number,
>     autoFilter?: boolean
>   },
>   lookalike?: {
>     domains: string[],
>     weight?: number,
>     minScore?: number
>   }
> }
> ```

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `count` | `number` | Yes | — |
| `total` | `number` | Yes | — |
| `interpretation` | `object \| null` | No | — |

> [accordion] interpretation full type
>
> ```ts theme={null}
> {
>   companyNames?: string[] | null,
>   filter?: Record<string, any> | null,
>   company?: {
>     query: string,
>     filter?: Record<string, any> | null,
>     boost?: Record<string, any> | null
>   } | null
> } | null
> ```

***

### searchPreview

`people.searchPreview`

Preview up to 10 masked person summaries with the search ranking. Free, needs a plan with previews.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.people.searchPreview({
	filter: { position: 'Engineer', domain: 'acme.example' },
});
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `filter` | `object` | No | — |
| `semantic` | `object` | No | — |
| `company` | `object` | No | — |

> [accordion] filter full type
>
> ```ts theme={null}
> {
>   query?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   companyId?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   domain?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   companyLinkedinHandle?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[] | {
>     in?: (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[],
>     notIn?: (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[]
>   },
>   department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[] | {
>     in?: (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[],
>     notIn?: (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[]
>   },
>   country?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   position?: string | string[] | {
>     in?: string[],
>     notIn?: string[]
>   },
>   currentCompanyStartDate?: {
>     after?: string,
>     before?: string
>   },
>   currentPositionStartDate?: {
>     after?: string,
>     before?: string
>   },
>   education?: {
>     institutionLinkedinHandle?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     institutionName?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     }
>   },
>   pastExperience?: {
>     companyId?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     domain?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     companyLinkedinHandle?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     seniority?: owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern | (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[] | {
>       in: (owner | founder | c-suite | partner | vp | head | director | manager | senior | entry | intern)[]
>     },
>     department?: c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant | (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[] | {
>       in: (c-suite | c-suite/executive | c-suite/finance-executive | c-suite/founder | c-suite/human-resources-executive | c-suite/information-technology-executive | c-suite/legal-executive | c-suite/marketing-executive | c-suite/medical-health-executive | c-suite/operations-executive | c-suite/sales-executive | product-management | product-management/product-development | product-management/product-management | engineering-technical | engineering-technical/artificial-intelligence-machine-learning | engineering-technical/bioengineering | engineering-technical/biometrics | engineering-technical/business-intelligence | engineering-technical/chemical-engineering | engineering-technical/cloud-mobility | engineering-technical/data-science | engineering-technical/devops | engineering-technical/digital-transformation | engineering-technical/emerging-technology-innovation | engineering-technical/engineering-technical | engineering-technical/industrial-engineering | engineering-technical/mechanic | engineering-technical/mobile-development | engineering-technical/project-management | engineering-technical/research-development | engineering-technical/scrum-master-agile-coach | engineering-technical/software-development | engineering-technical/support-technical-services | engineering-technical/technician | engineering-technical/technology-operations | engineering-technical/test-quality-assurance | engineering-technical/ui-ux | engineering-technical/web-development | design | design/all-design | design/product-ui-ux-design | design/graphic-design | education | education/teacher | education/principal | education/superintendent | education/professor | finance | finance/accounting | finance/finance | finance/financial-planning-analysis | finance/financial-reporting | finance/financial-strategy | finance/financial-systems | finance/internal-audit-control | finance/investor-relations | finance/mergers-acquisitions | finance/real-estate-finance | finance/financial-risk | finance/shared-services | finance/sourcing-procurement | finance/tax | finance/treasury | human-resources | human-resources/compensation-benefits | human-resources/culture-diversity-inclusion | human-resources/employee-labor-relations | human-resources/health-safety | human-resources/human-resource-information-system | human-resources/human-resources | human-resources/hr-business-partner | human-resources/learning-development | human-resources/organizational-development | human-resources/recruiting-talent-acquisition | human-resources/talent-management | human-resources/workforce-management | human-resources/people-operations | information-technology | information-technology/application-development | information-technology/business-service-management-itsm | information-technology/collaboration-web-app | information-technology/data-center | information-technology/data-warehouse | information-technology/database-administration | information-technology/ecommerce-development | information-technology/enterprise-architecture | information-technology/help-desk-desktop-services | information-technology/hr-financial-erp-systems | information-technology/information-security | information-technology/information-technology | information-technology/infrastructure | information-technology/it-asset-management | information-technology/it-audit-it-compliance | information-technology/it-operations | information-technology/it-procurement | information-technology/it-strategy | information-technology/it-training | information-technology/networking | information-technology/project-program-management | information-technology/quality-assurance | information-technology/retail-store-systems | information-technology/servers | information-technology/storage-disaster-recovery | information-technology/telecommunications | information-technology/virtualization | legal | legal/acquisitions | legal/compliance | legal/contracts | legal/corporate-secretary | legal/ediscovery | legal/ethics | legal/governance | legal/governmental-affairs-regulatory-law | legal/intellectual-property-patent | legal/labor-employment | legal/lawyer-attorney | legal/legal | legal/legal-counsel | legal/legal-operations | legal/litigation | legal/privacy | marketing | marketing/advertising | marketing/brand-management | marketing/content-marketing | marketing/customer-experience | marketing/customer-marketing | marketing/demand-generation | marketing/digital-marketing | marketing/ecommerce-marketing | marketing/event-marketing | marketing/field-marketing | marketing/lead-generation | marketing/marketing | marketing/marketing-analytics-insights | marketing/marketing-communications | marketing/marketing-operations | marketing/product-marketing | marketing/public-relations | marketing/search-engine-optimization-pay-per-click | marketing/social-media-marketing | marketing/strategic-communications | marketing/technical-marketing | medical-health | medical-health/anesthesiology | medical-health/chiropractics | medical-health/clinical-systems | medical-health/dentistry | medical-health/dermatology | medical-health/doctors-physicians | medical-health/epidemiology | medical-health/first-responder | medical-health/infectious-disease | medical-health/medical-administration | medical-health/medical-education-training | medical-health/medical-research | medical-health/medicine | medical-health/neurology | medical-health/nursing | medical-health/nutrition-dietetics | medical-health/obstetrics-gynecology | medical-health/oncology | medical-health/opthalmology | medical-health/optometry | medical-health/orthopedics | medical-health/pathology | medical-health/pediatrics | medical-health/pharmacy | medical-health/physical-therapy | medical-health/psychiatry | medical-health/psychology | medical-health/public-health | medical-health/radiology | medical-health/social-work | operations | operations/call-center | operations/construction | operations/corporate-strategy | operations/customer-service-support | operations/enterprise-resource-planning | operations/facilities-management | operations/leasing | operations/logistics | operations/office-operations | operations/operations | operations/physical-security | operations/project-development | operations/quality-management | operations/real-estate | operations/safety | operations/store-operations | operations/supply-chain | sales | sales/account-management | sales/business-development | sales/channel-sales | sales/customer-retention-development | sales/customer-success | sales/field-outside-sales | sales/inside-sales | sales/partnerships | sales/revenue-operations | sales/sales | sales/sales-enablement | sales/sales-engineering | sales/sales-operations | sales/sales-training | consulting | consulting/consultant)[]
>     },
>     position?: string | string[] | {
>       in: string[]
>     },
>     startDate?: {
>       after?: string,
>       before?: string
>     },
>     endDate?: {
>       after?: string,
>       before?: string
>     }
>   }
> }
> ```

> [accordion] semantic full type
>
> ```ts theme={null}
> {
>   query: string
> }
> ```

> [accordion] company full type
>
> ```ts theme={null}
> {
>   filter?: {
>     query?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     id?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     domain?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     keywords?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     },
>     technologies?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     },
>     region?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     country?: string | string[] | {
>       in?: string[],
>       notIn?: string[]
>     },
>     state?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     },
>     city?: number | number[] | {
>       in?: number[],
>       notIn?: number[]
>     },
>     type?: private | public | self-employed | self-owned | partnership | nonprofit | educational | government | (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[] | {
>       in?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[],
>       notIn?: (private | public | self-employed | self-owned | partnership | nonprofit | educational | government)[]
>     },
>     employees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     },
>     reportedEmployees?: 1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K | (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[] | {
>       in?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[],
>       notIn?: (1-10 | 11-50 | 51-200 | 201-500 | 501-1K | 1K-5K | 5K-10K | over-10K)[]
>     },
>     revenue?: under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b | (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[] | {
>       in?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[],
>       notIn?: (under-1m | 1m-10m | 10m-50m | 50m-100m | 100m-200m | 200m-1b | over-1b)[]
>     },
>     workforceGrowth?: {
>       period?: m6 | y1 | y2,
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>       min?: number,
>       max?: number
>     },
>     workforceSize?: {
>       department?: overall | c_suite | product_management | engineering_technical | design | education | finance | human_resources | information_technology | legal | marketing | medical_health | operations | sales | consulting,
>       min?: number,
>       max?: number
>     }[],
>     naicsCodes?: string | string[] | {
>       in?: string[],
>       notIn?: string[],
>       all?: string[]
>     },
>     categories?: b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business | (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[] | {
>       in?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       notIn?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[],
>       all?: (b2b | b2c | b2g | e-commerce | media | service-provider | mobile | saas | local-business)[]
>     },
>     foundedYear?: {
>       min?: number,
>       max?: number
>     },
>     fundingRounds?: seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other | (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[] | {
>       in?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[],
>       notIn?: (seed | debt_financing | angel | venture | series_a | series_b | series_c | series_d | series_e | series_f | series_g | series_h | other)[]
>     },
>     fundingAmount?: {
>       min?: number,
>       max?: number
>     },
>     fundingYear?: {
>       min?: number,
>       max?: number
>     },
>     require?: linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding | (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[] | {
>       all: (linkedin | twitter | facebook | instagram | angellist | crunchbase | youtube | country | city | state | revenue | foundedYear | anyFunding)[]
>     }
>   },
>   semantic?: {
>     query: string,
>     weight?: number,
>     autoFilter?: boolean
>   },
>   lookalike?: {
>     domains: string[],
>     weight?: number,
>     minScore?: number
>   }
> }
> ```

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `object[]` | Yes | — |
| `total` | `number` | Yes | — |
| `interpretation` | `object \| null` | No | — |

> [accordion] items full type
>
> ```ts theme={null}
> {
>   id: number,
>   name?: string | null,
>   position?: string | null,
>   department?: string | null,
>   experiences: {
>     isCurrent: boolean,
>     position?: string | null,
>     company?: {
>       id: string,
>       name?: string | null,
>       logoUrl?: string | null,
>       industry?: string | null
>     } | null
>   }[]
> }[]
> ```

> [accordion] interpretation full type
>
> ```ts theme={null}
> {
>   companyNames?: string[] | null,
>   filter?: Record<string, any> | null,
>   company?: {
>     query: string,
>     filter?: Record<string, any> | null,
>     boost?: Record<string, any> | null
>   } | null
> } | null
> ```

***

## Positions

### autocomplete

`positions.autocomplete`

Suggest up to 10 position or job titles by popularity, for people search position filters. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.positions.autocomplete({ query: 'engineer' });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `query` | `string` | Yes | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `string[]` | Yes | — |

***

## Technologies

### autocomplete

`technologies.autocomplete`

Suggest up to 10 technologies by popularity, for company search technology filters. Free.

**Risk:** `read`

```ts theme={null}
await corsair.companyenrich.api.technologies.autocomplete({ query: 'TypeScript' });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `query` | `string` | Yes | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `items` | `string[]` | Yes | — |

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.