> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/search/openapi.json](/docs/api/search/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# People and company search: Search companies

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

One endpoint of [People and company search](/docs/api/search.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## Search companies

`POST /v1/search/companies` - operationId `search.search-companies`

| Permission | Rate limit |
| --- | --- |
| Search view | 200 requests a minute per API key |

Search Kenso's company index with filters and get one page of companies, for example to build an account list.

The body holds the filters, `page` (from 1) and `pageSize` (0 to 100, default 25). For companies like
examples you know, send `lookalike` (see `GET /v1/search/lookalike-seeds`). A lookalike search returns
at most 2,000 companies and ignores `sortBy`.

`inLinkedInConnections: true` keeps only companies where at least one of the workspace's LinkedIn connections
works now or worked before, together with every other filter. It needs the `linkedin_network` or
`linkedin_connections_import` feature. With no connections synced, the search matches no company.

Errors:

- `400 validation_failed`: a filter or `inLinkedInConnections` is not valid.
- `400 too_many_seeds`: `lookalike` has too many seeds or negatives.
- `400 invalid_lookalike`: `lookalike` is not valid.
- `400 lookalikes_unavailable`: lookalike search is not available right now.
- `402 plan_required`: the body holds a funding filter (as on `POST /v1/search/people`) and the
workspace's plan does not include funding signals (`error.refusal` feature `funding_signals`).
- `403 feature_disabled`: a lookalike filter needs the `lookalikes` feature, or
`inLinkedInConnections` needs `linkedin_network` or `linkedin_connections_import`.
- `422 no_usable_seeds`: Kenso could not use any seed.
- `429 quota_exceeded`: the daily quota is used up.
- `503 service_unavailable`: a lookup the search needs failed. Try again.

Requires Search view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/search/POST/v1/search/companies)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions. |
| `X-Ken-Workspace-Id` | header | integer (int64) | no | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`. |

### Response 200

`data` is a `SearchCompaniesResults`.

| Field | Type | Description |
| --- | --- | --- |
| `totalResults` | integer (int64) | How many companies match the search in all. |
| `page` | integer (int32) | The page number, from 1. |
| `pageSize` | integer (int32) | The most companies a page holds. |
| `searchAfter` | string | The cursor of the next page: send it back unchanged as `searchAfter`. Null when there is none. |
| `hasMore` | boolean | True when more companies match after this page. |
| `results` | array of SearchCompany | The companies on this page. |
| `facets` | SearchCompanyFacets | Always null here: `POST /v1/search/companies/facets` counts the filter values. |
| `lookalikeSeeds` | SearchPeopleLookalikeSeeds | How each lookalike seed resolved. Present only on a lookalike search. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/search/companies" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"
```

### Example response

```json
{
  "success": true,
  "data": {
    "totalResults": 1,
    "page": 1,
    "pageSize": 1,
    "searchAfter": "string",
    "hasMore": true,
    "results": [
      {
        "kenId": 812,
        "name": "string",
        "website": "https://example.com",
        "domain": "acme.com",
        "industry": "string",
        "size": "51-200",
        "employeesCount": 1,
        "crossedSizeBandUp": true,
        "enteredSizeBand": "string",
        "headcountDeclined": true,
        "headcountDeclineAbs": 1,
        "headcountDeclinePct": 0.5,
        "headcountDeclineMonth": "string",
        "description": "string",
        "type": "string",
        "founded": 1,
        "linkedInUrl": "https://example.com",
        "logoUrl": "https://example.com",
        "followers": 1,
        "headquartersLocation": "string",
        "headquartersCountry": "string",
        "headquartersCity": "string",
        "headquartersState": "string",
        "headquartersCountryIso2": "US",
        "locations": [
          {
            "country": "string",
            "city": "string",
            "state": "string",
            "isHeadquarters": true
          }
        ],
        "specialties": [
          "string"
        ],
        "lastFundingRoundType": "string",
        "lastFundingAmount": 1,
        "lastFundingRoundAnnouncedDate": "2021-03-01T00:00:00",
        "raisedFundingRecently": true,
        "totalFunding": 1,
        "fundingTotalUsd": 1,
        "lastFundedAt": "string",
        "totalRoundsCount": 1,
        "lastRoundInvestorsCount": 1,
        "fundingRounds": [
          {
            "roundType": "string",
            "moneyRaised": 1,
            "announcedDate": "2021-03-01T00:00:00"
          }
        ],
        "similarCompanies": [
          1
        ],
        "leadershipChanges": [
          {
            "type": "string",
            "seniorityLevel": "string",
            "detectedMonth": "2021-03-01T00:00:00",
            "count": 1
          }
        ],
        "hiringSurges": [
          {
            "function": "string",
            "snapshotMonth": "2021-03-01T00:00:00",
            "currentHeadcount": 1,
            "previousHeadcount": 1,
            "netAdds": 1,
            "growthPercent": 0.5
          }
        ],
        "headcountGrew": true,
        "employeesCountPrevious": 1,
        "headcountGrowthAbs": 1,
        "headcountGrowthPct": 0.5,
        "headcountGrowthDetectedAt": "2021-03-01T00:00:00",
        "headcountGrowthMonth": "string",
        "webTechnologies": [
          {
            "key": "string",
            "name": "string",
            "categories": []
          }
        ],
        "relevanceScore": 0.5,
        "lookalike": {
          "score": 1,
          "grade": 1
        }
      }
    ],
    "facets": {
      "industries": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "seniorityLevels": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "functions": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "countries": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "states": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "cities": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "companyTypes": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "companySizes": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "fundingRoundTypes": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "webTech": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "webTechCategories": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ]
    },
    "lookalikeSeeds": {
      "resolved": [
        {
          "input": "string",
          "companyId": 812,
          "personId": 812,
          "name": "string",
          "domain": "example.com"
        }
      ],
      "unresolved": [
        {
          "input": "string",
          "reason": "not_found"
        }
      ]
    }
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### SearchCompany

A company in Kenso's company index, with its firmographics, funding and change signals.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `kenId` | integer (int64) | no | The company's Search id. Send it as `companyId` to get the company again. |
| `name` | string | no | The company's name. |
| `website` | string | no | The company's website URL. |
| `domain` | string | no | The company's website domain, such as `acme.com`. |
| `industry` | string | no | The company's industry. |
| `size` | string | no | The company's size band by employee count, such as `51-200`, as the `companySizes` filter takes it. |
| `employeesCount` | integer (int32) | no | How many employees the company has. |
| `crossedSizeBandUp` | boolean | no | True when the company moved up into a bigger size band in the latest data delivery. |
| `enteredSizeBand` | string | no | The size band the company moved up into. Null when `crossedSizeBandUp` is false. |
| `headcountDeclined` | boolean | no | True when the company's headcount dropped in the latest data delivery. |
| `headcountDeclineAbs` | integer (int32) | no | How many employees the company lost. |
| `headcountDeclinePct` | number (double) | no | The headcount drop as a percentage of the earlier count, from 0 to 100. |
| `headcountDeclineMonth` | string | no | The month Kenso saw the drop, as `yyyy-MM`. |
| `description` | string | no | The company's description. |
| `type` | string | no | The company type, as the `companyTypes` filter takes it. |
| `founded` | integer (int32) | no | The year the company was founded. |
| `linkedInUrl` | string | no | The company's LinkedIn page URL. |
| `logoUrl` | string | no | The URL of the company's logo. |
| `followers` | integer (int32) | no | How many people follow the company on LinkedIn. |
| `headquartersLocation` | string | no | The headquarters as `city, state, country`, leaving out the parts Kenso does not know. |
| `headquartersCountry` | string | no | The country of the headquarters. |
| `headquartersCity` | string | no | The city of the headquarters. |
| `headquartersState` | string | no | The state or region of the headquarters. |
| `headquartersCountryIso2` | string | no | The country of the headquarters as an ISO 3166-1 alpha-2 code, such as `US`. |
| `locations` | array of SearchCompanyLocation | no | The company's offices. |
| `specialties` | array of string | no | The company's specialties. |
| `lastFundingRoundType` | string | no | The type of the company's last funding round, such as `Series A`. |
| `lastFundingAmount` | integer (int64) | no | The amount raised in the last funding round, in USD. |
| `lastFundingRoundAnnouncedDate` | string | no | When the last funding round was announced. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `raisedFundingRecently` | boolean | no | True when the company's latest raise is within the search's `raisedFundingWithinDays`, 180 by default. |
| `totalFunding` | integer (int64) | no | The total funding raised, in USD, as the data vendor reports it. |
| `fundingTotalUsd` | integer (int64) | no | The total funding raised, in whole USD: the larger of the known totals. The funding filters match on it. |
| `lastFundedAt` | string | no | The date of the latest funding raise, as `yyyy-MM-dd`. |
| `totalRoundsCount` | integer (int32) | no | How many funding rounds the company has had. |
| `lastRoundInvestorsCount` | integer (int32) | no | How many investors took part in the last funding round. |
| `fundingRounds` | array of SearchCompanyFundingRound | no | The company's funding rounds. |
| `similarCompanies` | array of integer (int64) | no | The Search ids of similar companies. |
| `leadershipChanges` | array of SearchCompanyLeadershipChange | no | The leadership changes that match the search's `leadershipChange` filter, newest first. Null without that filter. |
| `hiringSurges` | array of SearchCompanyHiringSurge | no | The job functions whose headcount grew, by month. |
| `headcountGrew` | boolean | no | True when the company's headcount grew in the latest data delivery. |
| `employeesCountPrevious` | integer (int32) | no | The headcount before the growth. |
| `headcountGrowthAbs` | integer (int32) | no | How many employees the company added. |
| `headcountGrowthPct` | number (double) | no | The headcount growth as a percentage of the earlier count, such as `12.5`. |
| `headcountGrowthDetectedAt` | string | no | When Kenso saw the growth. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `headcountGrowthMonth` | string | no | The month Kenso saw the growth, as `yyyy-MM`. |
| `webTechnologies` | array of SearchCompanyWebTechnology | no | The web technologies Kenso found for the company's domain. Null when it has none, or while the technology filters are off. |
| `relevanceScore` | number (double) | no | How well the company matches the search; higher is better. 0 outside a ranked search. |
| `lookalike` | SearchPersonLookalikeMatch | no | How much the company looks like the lookalike seeds. Present only on a lookalike search. |

### SearchCompanyFacets

How many companies match each value of the main filters, most first.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `industries` | array of SearchPeopleFacetBucket | no | The counts by industry. |
| `seniorityLevels` | array of SearchPeopleFacetBucket | no | Always null for companies: only people facets count seniority levels. |
| `functions` | array of SearchPeopleFacetBucket | no | Always null for companies: only people facets count job functions. |
| `countries` | array of SearchPeopleFacetBucket | no | The counts by headquarters country, with each country as an ISO 3166-1 alpha-2 code such as `US`. |
| `states` | array of SearchPeopleFacetBucket | no | Always null for companies: only people facets count states. |
| `cities` | array of SearchPeopleFacetBucket | no | Always null for companies: only people facets count cities. |
| `companyTypes` | array of SearchPeopleFacetBucket | no | The counts by company type. |
| `companySizes` | array of SearchPeopleFacetBucket | no | The counts by company size. |
| `fundingRoundTypes` | array of SearchPeopleFacetBucket | no | The counts by the type of the company's last funding round. |
| `webTech` | array of SearchPeopleFacetBucket | no | The counts by web technology, with each technology's display name as `label`. Null while the technology filters are off. |
| `webTechCategories` | array of SearchPeopleFacetBucket | no | The counts by web technology category, with each category's display name as `label`. Null while the technology filters are off. |

### SearchPeopleLookalikeSeeds

How the seeds of a lookalike filter resolved.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `resolved` | array of SearchPeopleResolvedSeed | no | The seeds Kenso found. |
| `unresolved` | array of SearchPeopleUnresolvedSeed | no | The seeds Kenso could not use, with the reason. |

### SearchCompanyLocation

One of a company's offices.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | string | no | The office's country. |
| `city` | string | no | The office's city. |
| `state` | string | no | The office's state or region. |
| `isHeadquarters` | boolean | no | True for the headquarters. |

### SearchCompanyFundingRound

One funding round of a company.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `roundType` | string | no | The round type, such as `Series A`. |
| `moneyRaised` | integer (int64) | no | The amount raised, in USD. |
| `announcedDate` | string | no | When the round was announced. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |

### SearchCompanyLeadershipChange

The leaders a company gained or lost in one month, at one seniority level.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | no | `GainedLeader` when leaders joined the company, `LostLeader` when they left it. |
| `seniorityLevel` | string | no | The leaders' seniority level, as the `leadershipChange.seniorityLevels` filter takes it. |
| `detectedMonth` | string | no | The month of the change, as its first day. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `count` | integer (int32) | no | How many leaders joined or left. |

### SearchCompanyHiringSurge

A job function whose headcount grew at a company over one month.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `function` | string | no | The job function, as the `hiringSurge.functions` filter takes it. |
| `snapshotMonth` | string | no | The month of the headcount snapshot, as its first day. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `currentHeadcount` | integer (int32) | no | The function's headcount at the snapshot. |
| `previousHeadcount` | integer (int32) | no | The function's headcount before it. |
| `netAdds` | integer (int32) | no | How many people the function gained. |
| `growthPercent` | number (double) | no | The growth as a percentage of the earlier headcount. Null when the earlier headcount was 0. |

### SearchCompanyWebTechnology

A web technology Kenso found for a company's domain.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `key` | string | no | The technology's key, as the `webTechAny`, `webTechAll` and `webTechExclude` filters take it. |
| `name` | string | no | The technology's display name. |
| `categories` | array of string | no | The display names of the technology's categories. |

### SearchPersonLookalikeMatch

A row's similarity to the lookalike seeds.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `score` | integer (int32) | no | The similarity score, from 0 to 100. |
| `grade` | integer (int32) | no | The similarity grade, from 1 to 5, where 5 is the closest. |

### SearchPeopleFacetBucket

One filter value and how many results carry it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `value` | string | no | The filter value, as the filter takes it. |
| `count` | integer (int64) | no | How many results carry the value. |
| `label` | string | no | The display name when the value is a key, as on the web technology facets. Null otherwise. |

### SearchPeopleResolvedSeed

A lookalike seed Kenso found.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `input` | string | no | The seed as you sent it. A text seed is cut to 80 characters. |
| `companyId` | integer (int64) | no | The Search id of the company the seed resolved to. |
| `personId` | integer (int64) | no | The Search id of the person the seed resolved to, for a person seed. |
| `name` | string | no | The name of the company or person the seed resolved to. |
| `domain` | string | no | The domain of the company the seed resolved to. |

### SearchPeopleUnresolvedSeed

A lookalike seed Kenso could not use.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `input` | string | no | The seed as you sent it. |
| `reason` | string | no | Why the seed was not used: `not_found`, `no_text`, `embedding_unavailable` or `not_b2b_excluded`. |
